Wie verwende ich CloudTrail, um Amazon Q Developer-Ereignisse zu protokollieren, die meine IDE oder CLI bereitstellt?

Kurzbeschreibung

Ereignisse, die deine IDE oder CLI bereitstellen, sind CloudTrail-Datenereignisse. Standardmäßig protokolliert CloudTrail keine Datenereignisse, sodass du die Ereignisse nicht im CloudTrail-Ereignisverlauf sehen kannst. Um Amazon Q Developer-Ereignisse zu protokollieren, die deine IDE oder CLI in CloudTrail bereitstellen, erstelle einen benutzerdefinierten Trail, der Datenereignisse protokolliert.

Hinweis: Du musst ein Amazon Q Developer Pro-Abonnement haben, um die folgende Auflösung zu verwenden. Du kannst das kostenlose Kontingent nicht verwenden, um Ereignisse in CloudTrail zu protokollieren, da du dich mit der AWS Builder ID und nicht mit einem AWS-Konto authentifizierst.

Lösung

Führe die folgenden Schritte aus, um einen Trail für Amazon Q Developer-Datenereignisse zu erstellen:

1. Öffne die CloudTrail-Konsole.
2. Wähle im Navigationsbereich Trails aus.
3. Wähle Trail erstellen aus.
4. Gib die folgenden Trail-Attribute ein:
   Trail-Name
   Amazon Simple Storage Service (Amazon S3)-Bucket zum Speichern der Protokolle
   (Optional) Schlüssel für den vom Kunden verwalteten AWS Key Management Service (AWS KMS)
   Hinweis: Aktiviere einen Organisations-Trail, um einen Trail für all deine AWS Organizations-Konten zu erstellen. Du musst dich bei dem Verwaltungs- oder delegierten Administratorkonto als ein Benutzer oder eine Rolle anmelden, der/die über die richtigen Berechtigungen verfügt.
5. Wähle Weiter aus.
6. Wähle auf der Seite Protokollereignisse auswählen die Option Datenereignisse aus.
7. Wähle CodeWhisperer aus.
8. Wähle Trail erstellen aus.

Du kannst den neuen Trail auf der Seite Trails der CloudTrail-Konsole sehen. Nach 5 Minuten veröffentlicht CloudTrail Protokolldateien, die die AWS-API-Aufrufe deines Kontos zeigen. Du kannst die Protokolldateien im angegebenen S3-Bucket anzeigen.

Außerdem kannst du CloudTrail Protokolldateien an Amazon CloudWatch Logs senden lassen.

Ereignisse, die deine IDE zur Verfügung stellt, beinhalten Details über userIdentity und userAgent.

Beispiel für ein IDE-Ereignis:

"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",

Zu den Ereignissen, die CLI bereitstellt, gehören Details zu userAgent und userContext.

Beispiel für ein CLI-Ereignis:

"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"
}

Hinweis: Inline- oder Chat-Prompt-Details sind in CloudTrail verborgen. Aktiviere in der Amazon Q Developer-Konsole das Feature zur Protokollierung von Prompts, um Prompt-Details zu erfassen.

Ähnliche Informationen

Erstellen eines Benutzeraktivitäts-Dashboards für Amazon CodeWhisperer

Untersuchung von Telemetrieereignissen in Amazon Q Developer

Aktivieren von Benutzeraktivitätsberichten in Amazon Q Developer