Come posso usare CloudTrail per registrare gli eventi di Amazon Q Developer forniti dal mio ambiente IDE o dalla mia interfaccia CLI?

Breve descrizione

Gli eventi forniti dal tuo ambiente IDE o dalla interfaccia CLI sono eventi di dati di CloudTrail. Per impostazione predefinita, CloudTrail non registra gli eventi relativi ai dati, quindi non puoi visualizzarli nella cronologia degli eventi di CloudTrail. Per registrare gli eventi di Amazon Q Developer forniti dal tuo ambiente IDE o dalla tua interfaccia CLI in CloudTrail, crea un trail personalizzato che registri gli eventi di dati.

Nota: devi disporre di un abbonamento ad Amazon Q Developer Pro per utilizzare la seguente risoluzione. Non puoi utilizzare il Piano gratuito per registrare eventi in CloudTrail perché ti autentichi con ID Builder AWS e non con un account AWS.

Risoluzione

Per creare un trail per gli eventi di dati di Amazon Q Developer, completa i seguenti passaggi:

1. Apri la console CloudTrail.
2. Nel pannello di navigazione, scegli Trail.
3. Scegli Crea trail.
4. Inserisci i seguenti attributi del trail:
   Nome trail
   Bucket Amazon Simple Storage Service (Amazon S3) per archiviare i log
   (Facoltativo) Chiave del Servizio AWS di gestione delle chiavi (AWS KMS) gestita dal cliente
   Nota: per creare un trail per tutti i tuoi account AWS Organizations, attiva un trail dell'organizzazione. Devi accedere all'account di gestione o amministratore delegato come utente o ruolo con le autorizzazioni corrette.
5. Scegli Avanti.
6. Nella pagina Seleziona eventi di log, scegli Eventi di dati.
7. Seleziona CodeWhisperer.
8. Scegli Crea trail.

Puoi visualizzare il nuovo trail nella pagina Trail della console CloudTrail. Dopo 5 minuti, CloudTrail pubblica i file di log che mostrano le chiamate API AWS del tuo account. Puoi visualizzare i file di log nel bucket S3 specificato.

Puoi anche configurare CloudTrail per inviare file di log ad Amazon CloudWatch Logs.

Gli eventi forniti dal tuo ambiente IDE includono dettagli su userIdentity e userAgent.

Esempio di evento IDE:

"userIdentity": {
            "type": "IdentityCenterUser",
            "accountId": "111122223333",
            "onBehalfOf": {
                "userId": "123456789-123456789-123456789-123456789-123456789",
                "identityStoreArn": "arn:aws:identitystore::111122223333:identitystore/d-123456789"
            }
        },
"userAgent": "aws-sdk-js/0.0.1 ua/2.0 os/win32# lang/js md/nodejs#18.15.0 api/codewhispererstreaming#0.0.1 AmazonQ-For-VSCode/1.23.0",

Gli eventi forniti dall'interfaccia CLI includono dettagli su userAgent e userContext.

Esempio di evento CLI:

"userAgent": "aws-sdk-rust/1.3.3 api/codewhispererruntime/0.1.1100 os/macos lang/rust/1.80.1 app/AmazonQ-For-CLI",
"userContext": {
    "ideCategory": "CLI",
    "operatingSystem": "MAC",
    "product": "CodeWhisperer",
    "ideVersion": "1.3.0"
}

Nota: in CloudTrail i dettagli dei prompt in linea o in chat sono nascosti. Per acquisire i dettagli dei prompt, utilizza la console Amazon Q Developer per attivare la funzionalità di registrazione dei prompt.

Informazioni correlate

Creating a User Activity Dashboard for Amazon CodeWhisperer (Creazione di una dashboard delle attività degli utenti per Amazon CodeWhisperer)

Exploring telemetry events in Amazon Q Developer (Esplorazione degli eventi di telemetria in Amazon Q Developer)

Abilitazione dei report sulle attività degli utenti in Amazon Q Developer