Configurazione del plug-in Amazon Q Developer Datadog

Datadogè una piattaforma di monitoraggio e sicurezza che fornisce monitoraggio e analisi di infrastrutture, applicazioni e rete. Se utilizzi Datadog per monitorare AWS le tue applicazioni, puoi utilizzare il Datadog plug-in nella chat di Amazon Q Developer per accedere alle informazioni di monitoraggio senza uscire dal AWS Management Console.

Puoi utilizzare il Datadog plug-in per saperne di piùDatadog, capire come funziona con AWS i servizi e chiedere informazioni sui tuoi Datadog casi e monitor. Dopo aver ricevuto una risposta, puoi porre domande di follow-up, ad esempio su come risolvere un problema o informazioni dettagliate sulle Datadog risorse.

Per configurare il plug-in, fornisci le credenziali di autenticazione dal tuo Datadog account per abilitare una connessione tra Amazon Q eDatadog. Dopo aver configurato il plug-in, puoi accedere alle Datadog metriche aggiungendole @datadog all'inizio della tua domanda nella chat di Amazon Q.

avvertimento

Datadogle autorizzazioni utente non vengono rilevate dal Datadog plug-in in Amazon Q. Quando un amministratore configura il Datadog plug-in in un AWS account, gli utenti con le autorizzazioni del plug-in in quell'account hanno accesso a tutte le risorse dell'Datadogaccount recuperabili dal plug-in.

Puoi configurare le policy IAM per limitare i plugin a cui gli utenti hanno accesso. Per ulteriori informazioni, consulta Configura le autorizzazioni utente.

Prerequisiti

Aggiungere autorizzazioni

Per configurare i plugin, sono necessarie le seguenti autorizzazioni a livello di amministratore:

• Autorizzazioni per accedere alla console Amazon Q Developer. Per un esempio di politica IAM che concede le autorizzazioni necessarie, consulta. Consenti agli amministratori di utilizzare la console Amazon Q Developer

• Autorizzazioni per configurare i plugin. Per un esempio di politica IAM che concede le autorizzazioni necessarie, vedi. Consenti agli amministratori di configurare i plugin

Acquisire credenziali

Prima di iniziare, prendi nota delle seguenti informazioni dal tuo Datadog account. Queste credenziali di autenticazione verranno archiviate in modo AWS Secrets Manager segreto quando configurerai il plug-in.

• Parametro del sito: il parametro del Datadog sito che utilizzi. Ad esempio, us3.datadoghq.com. Per ulteriori informazioni, consulta la sezione Guida introduttiva a Datadog Sites nella Datadog documentazione.

• Chiave API e chiave dell'applicazione: chiavi di accesso che consentono ad Amazon Q di chiamare l'DatadogAPI per accedere a eventi e metriche. Puoi trovarle nella sezione Impostazioni dell'organizzazione del tuo Datadog account. Per ulteriori informazioni, consulta API e chiavi di applicazione nella Datadog documentazione.

Segreti e ruoli di servizio

AWS Secrets Manager segreto

Quando configuri il plug-in, Amazon Q crea un nuovo AWS Secrets Manager segreto per archiviare le credenziali di Datadog autenticazione. In alternativa, puoi utilizzare un segreto esistente che crei tu stesso.

Se crei tu stesso un segreto, assicurati che includa le seguenti credenziali e utilizzi il seguente formato JSON:

{ 
   "ApiKey": "<your-api-key>", 
   "AppKey": "<your-applicaiton-key>" 
}

Per ulteriori informazioni sulla creazione di segreti, consulta Creare un segreto nella Guida per l'AWS Secrets Manager utente.

Ruoli di servizio

Per configurare il Datadog plug-in in Amazon Q Developer, devi creare un ruolo di servizio che autorizzi Amazon Q ad accedere al tuo segreto di Secrets Manager. Amazon Q assume questo ruolo per accedere al segreto in cui sono archiviate Datadog le tue credenziali.

Quando configuri il plug-in nella AWS console, hai la possibilità di creare un nuovo segreto o utilizzarne uno esistente. Se crei un nuovo segreto, il ruolo di servizio associato viene creato automaticamente. Se utilizzi un segreto esistente e un ruolo di servizio esistente, assicurati che il ruolo di servizio contenga le seguenti autorizzazioni e abbia la seguente politica di fiducia allegata. Il ruolo di servizio richiesto dipende dal metodo di crittografia segreto utilizzato.

Se il tuo segreto è crittografato con una chiave KMS AWS gestita, è richiesto il seguente ruolo del servizio IAM:

JSON

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "secretsmanager:GetSecretValue"
            ],
            "Resource": [
                "arn:aws:secretsmanager:us-east-1:{{your-account-id}}:secret:[[secret-id]]"
            ]
        }
    ]
}

Mostra piùMostra meno

Se il tuo segreto è crittografato con una AWS KMS chiave gestita dal cliente, è richiesto il seguente ruolo di servizio IAM:

JSON

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "secretsmanager:GetSecretValue"
            ],
            "Resource": "arn:aws:secretsmanager:us-east-1:{{accountId}}:secret:{{secretId}}"
        },
        {
            "Effect": "Allow",
            "Action": [
                "kms:Decrypt"
            ],
            "Resource": "arn:aws:kms:us-east-1:{{accountId}}:key/{{keyId}}",
            "Condition": {
                "StringEquals": {
                    "kms:ViaService": "secretsmanager.us-east-1.amazonaws.com"
                }
            }
        }
    ]
}

Mostra piùMostra meno

Per consentire ad Amazon Q di assumere il ruolo di servizio, il ruolo di servizio necessita della seguente politica di fiducia:

Nota

Il codewhisperer prefisso è un nome legacy di un servizio che si è unito ad Amazon Q Developer. Per ulteriori informazioni, consulta Amazon Q Developer rename - Riepilogo delle modifiche.

JSON

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "q.amazonaws.com"
      },
      "Action": ["sts:AssumeRole", "sts:SetContext"],
      "Condition": {
        "StringEquals": {
          "aws:SourceAccount": "{{accountId}}",
          "aws:SourceArn": "arn:aws:codewhisperer:{{region}}:{{accountId}}:profile/{{profileId}}"
        }
      }
    }
  ]
}

Mostra piùMostra meno

Per ulteriori informazioni sui ruoli di servizio, consulta Creare un ruolo per delegare le autorizzazioni a un AWS servizio nella Guida per l'utente.AWS Identity and Access Management

Configura il plugin Datadog

Puoi configurare i plugin nella console Amazon Q Developer. Amazon Q utilizza le credenziali archiviate AWS Secrets Manager per abilitare le interazioni conDatadog.

Per configurare il Datadog plug-in, completa la seguente procedura:

1. Apri la console Amazon Q Developer su https://console.aws.amazon.com/amazonq/developer/home

2. Nella home page della console Amazon Q Developer, scegli Impostazioni.

3. Nella barra di navigazione, scegli Plugin.

4. Nella pagina dei plugin, scegli il segno più sul Datadogpannello. Si apre la pagina di configurazione del plugin.

5. Per URL del sito, inserisci l'URL del Datadog sito che utilizzi.

6. Per Configura AWS Secrets Manager, scegli Crea un nuovo segreto o Usa un segreto esistente. Il segreto di Secrets Manager è dove verranno archiviate le credenziali di Datadog autenticazione.

   Se crei un nuovo segreto, inserisci le seguenti informazioni:

   1. Per la chiave Datadog API, inserisci la chiave API per la tua Datadog organizzazione.

   2. Per la Datadogchiave di accesso, inserisci la chiave dell'applicazione per il tuo Datadog account.

   3. Verrà creato un ruolo di servizio che Amazon Q utilizzerà per accedere al segreto in cui sono archiviate le Datadog credenziali. Non modificare il ruolo di servizio creato per te.

   Se utilizzi un segreto esistente, scegli un segreto dal menu a discesa AWS Secrets Manager segreto. Il segreto deve includere le credenziali di Datadog autenticazione specificate nel passaggio precedente.

   Per ulteriori informazioni sulle credenziali richieste, vedere. Acquisire credenziali

7. Per Configura il ruolo di servizio AWS IAM, scegli Crea nuovo ruolo di servizio o Usa il ruolo di servizio esistente.

   Nota

   Se hai scelto Crea un nuovo segreto per il passaggio 6, non puoi utilizzare un ruolo di servizio esistente. Verrà creato un nuovo ruolo per te.

   Se crei un nuovo ruolo di servizio, verrà creato un ruolo di servizio che Amazon Q utilizzerà per accedere al segreto in cui sono archiviate Datadog le tue credenziali. Non modificare il ruolo di servizio creato per te.

   Se utilizzi un ruolo di servizio esistente, scegli un ruolo dal menu a discesa visualizzato. Assicurati che il tuo ruolo di servizio disponga delle autorizzazioni e della politica di fiducia definite in. Ruoli di servizio

8. Seleziona Save configuration (Salva configurazione).

9. Dopo la visualizzazione del pannello del Datadog plug-in nella sezione Plugin configurati della pagina Plugin, gli utenti avranno accesso al plug-in.

Se desideri aggiornare le credenziali di un plug-in, devi eliminare il plug-in corrente e configurarne uno nuovo. L'eliminazione di un plug-in rimuove tutte le specifiche precedenti. Ogni volta che configuri un nuovo plugin, viene generato un nuovo plugin ARN.

Configura le autorizzazioni utente

Per utilizzare i plugin, sono necessarie le seguenti autorizzazioni:

• Autorizzazioni per chattare con Amazon Q nella console. Per un esempio di politica IAM che concede le autorizzazioni necessarie per chattare, consulta. Consenti agli utenti di chattare con Amazon Q

• L'q:UsePluginautorizzazione.

Quando concedi a un'identità IAM l'accesso a un Datadog plug-in configurato, l'identità ottiene l'accesso a tutte le risorse dell'Datadogaccount recuperabili dal plug-in. Datadogle autorizzazioni utente non vengono rilevate dal plug-in. Se desideri controllare l'accesso a un plug-in, puoi farlo specificando l'ARN del plug-in in una policy IAM.

Ogni volta che si crea o si elimina e si riconfigura un plug-in, a quest'ultimo viene assegnato un nuovo ARN. Se si utilizza un plug-in ARN in una politica, sarà necessario aggiornarlo se si desidera concedere l'accesso al plug-in appena configurato.

Per individuare l'ARN del Datadog plug-in, vai alla pagina Plugin nella console Amazon Q Developer e scegli il plug-in configurato. Datadog Nella pagina dei dettagli del plug-in, copia l'ARN del plug-in. Puoi aggiungere questo ARN a una policy per consentire o negare l'accesso al plugin. Datadog

Se crei una policy per controllare l'accesso ai Datadog plugin, specifica Datadog il provider del plugin nella policy.

Per esempi di policy IAM che controllano l'accesso ai plugin, consultaConsenti agli utenti di chattare con i plug-in di un provider.

Chatta con il Datadog plugin

Per utilizzare il Datadog plugin, inserisci @datadog all'inizio di una domanda sui Datadog monitor e i casi AWS dell'applicazione. È necessario includere anche le domande di follow-up o le risposte alle domande di Amazon Q@datadog.

Di seguito sono riportati alcuni esempi di casi d'uso e domande associate che puoi porre per ottenere il massimo dal Datadog plug-in Amazon Q:

• Scopri come utilizzare Datadog le funzionalità nel tuo AWS carico di lavoro: chiedi informazioni su come funzionano Datadog le funzionalità con determinati AWS servizi. Amazon Q potrebbe chiederti ulteriori informazioni su ciò che stai cercando di fare per fornire la risposta migliore.

  • @datadog how do I use APM on EC2?

• Recupera e riepiloga casi e monitor: chiedi informazioni su un caso o monitor specifico o specifica le proprietà per ottenere informazioni su monitor e casi come la data di creazione, lo stato o l'autore. Per ulteriori informazioni sulle proprietà, vedere Proprietà nella documentazione. Datadog

  • @datadog summarize the global outage case

  • @datadog summarize my top cases

• Controlla i monitor che sono in stato di allarme: chiedi al Datadog plug-in Amazon Q di trovare i monitor delle tue AWS applicazioni che sono in allarme. Puoi continuare con domande sui monitor che elenca.

  • @datadog what monitors are in alarm?

  • @datadog what is the status for monitor <monitor ID>?