AWS CDK-CLI-Telemetrie konfigurieren

CDK-CLI-Version

CLI-Version (x.y.z)

Das Sammeln dieser Daten hilft uns, unsere Daten nach Version zu unterteilen, was uns helfen kann, problematische Versionen zu identifizieren.

"2.1100.0"

ID der Installation

Zufällige UUID, die auf lokalen Computern gespeichert ist, die CLI-Befehle ausführen

Auf diese Weise können wir die genaue Anzahl der Benutzer abschätzen, die von einem Fehler betroffen sind. Jeder einzelne Computer hat seine eigene Installations-ID, die nach dem Zufallsprinzip über UUID V4 generiert wird.

"881d3281-2811-4c86-b7b6-4a8a621cf6f2"

Sitzungs-ID

Zufällige UUID, die bei jedem CLI-Befehlsaufruf generiert wird

Dies hilft uns, alle Ereignisse zu identifizieren, die auf denselben Befehl zurückzuführen sind.

"c47e3d55-bc20-406b-a02a-e0285dd63230"

Ereignis-ID

Die Sitzungs-ID plus ein Zähler

Dadurch wird für jedes Ereignis in einer Sitzung eine eindeutige Kennung erstellt.

"c47e3d55-bc20-406b-a02a-e0285dd63230:0"

Region

AWS-Region

Dies hilft uns, unsere Daten für regionsspezifische Probleme zu unterteilen.

"us-east-1"

Zeitstempel

Die Uhrzeit (vom Client generiert), zu der die Daten an unseren Telemetrieendpunkt gesendet werden

Dies wird uns helfen, Zeitreihendiagramme zu erstellen.

"2025-12-12T00:00:00.000Z"

Status des Ereignisses

Das „Ergebnis“ des Ereignisses. Mögliche Werte sind 'SUCCESS', 'FAILURE', 'ABORTED'

Auf diese Weise können wir die Fehlerquoten bei jedem CLI-Befehl verfolgen und uns auf mögliche Regressionen aufmerksam machen, bevor sie von Kunden gemeldet werden.

"SUCCESS"

Ereignistyp

Eine Kennung für den Ereignistyp, der die Daten erzeugt

Dies ist eine Aufzählung, die die Art des Ereignisses identifiziert, das eingetreten ist, da bei einer Befehlsausführung mehrere Ereignisse auftreten können.

"SYNTH"

Befehlspfad

Der Befehl und die Eigenschaften, die in die CLI eingegeben wurden, wobei der freie Text redigiert wurde

Zusammen mit den Befehlsparametern helfen uns diese Informationen dabei, das Verhalten des eingetretenen Ereignisses zu bestimmen. Auf diese Weise können wir den Explosionsradius und die Ursache der aufgetretenen Probleme ermitteln.

["cdk", "deploy", "$STACK1"]

Befehls-Parameter

Die optionalen Parameter, die in die CLI eingegeben wurden, wobei der freie Text redigiert wurde

Zusammen mit dem Befehlspfad helfen uns diese Informationen dabei, das Verhalten des eingetretenen Ereignisses zu bestimmen. Auf diese Weise können wir den Explosionsradius und die Ursache der auftretenden Probleme ermitteln.

{
  all: true,
  concurrency: 4
}

Konfiguration

Zusätzliche Parameter, die sich auf den CLI-Befehl auswirken können (d. h. cdk.context.json oder Kontextwerte incdk.json/~/.cdk.json), wobei jeglicher Freitext redigiert wird

Dies wird uns helfen, das Debuggen zu erleichtern, indem wir einen umfassenden Überblick über alle möglichen Parameter bieten, die das Verhalten der CLI beeinflussen können.

{
  context: {
    "@aws-cdk/core:explicitStackTags": true
  }
}

Betriebssystem

Das verwendete Betriebssystem

Dies hilft uns beim Debuggen von Problemen, die nur bestimmte Betriebssysteme betreffen.

{
  platform: "linux",
  release: "5.15.0-1019-aws",
}

CI/CD

Ob der CLI-Befehl von einer CI/CD Umgebung aus aufgerufen wird oder nicht

Dies hilft uns, umgebungsspezifische Probleme zu identifizieren CI/CD .

false

Knotenversion

Die in der Umgebung verwendete Knotenversion

Dies hilft uns beim Debuggen aller auftretenden knotenspezifischen Probleme.

"v22.0.0"

Dauer

Die Länge des Ereignisses in Millisekunden

Auf diese Weise können wir Muster darin erkennen, wie lange bestimmte Ereignisse dauern.

{ total: 300 }

Zähler

Verschiedene Zählermetriken, die aus Ihrer CDK-App und der CLI-Ausführung abgeleitet wurden

Wir werden beobachten, wie sich Zählstatistiken wie (aber nicht beschränkt auf) die Anzahl der CFN-Ressourcen auf die Dauer der Bereitstellung auswirken.

{
  resourceCount: 25,
  errorCount: 0,
  warningCount: 2,
}

Abhängigkeiten

Relevante AWS-Abhängigkeiten und ihre Versionen

Wir planen, AWS-Abhängigkeiten zu verfolgen, die sich auf das CLI-Ergebnis auswirken könnten aws-cdk-lib, wie jsii, projen usw. Wir werden nur Abhängigkeiten von bestimmten AWS-eigenen Bibliotheken sammeln.

[{ "aws-cdk-lib": "2.232.0"}]

Fehlernamen

Der Name des Fehlers, falls ein Fehler auftritt.

Wir zeichnen nur Fehlernamen auf, die wir kontrollieren, was uns hilft, wiederkehrende Fehlertypen zu identifizieren.

"ToolkitError"

Die folgenden Kennzahlen erfordern eine ausdrückliche Zustimmung und werden derzeit NICHT erfasst:

Fehlermeldungen

Die Fehlermeldung wird zurückgegeben, wenn ein Fehler auftritt. Freiformtext redigiert

[Opt-In erforderlich] Das Erfassen der Fehlermeldung hilft uns dabei, Daten darüber zu sammeln, welche Fehler häufiger aufgetreten sind, und hilft uns, Fehler zu debuggen, was in einzelnen Anwendungsfällen schief gelaufen ist.

Derzeit nicht erfasst

Fehler Stack Trace

Der Stack-Trace der Fehlermeldung, falls ein Fehler auftritt. Freiformtext redigiert

[Opt-In erforderlich] Der Stack-Trace ist für individuelle Debugging-Zwecke hilfreich und ist notwendig, damit wir eventuell auftretende Probleme reproduzieren können.

Derzeit nicht gesammelt

Fehlerprotokolle

Die Protokolle eines fehlgeschlagenen CLI-Befehls, falls ein Fehler auftritt. Freiformtext redigiert

[Opt-In erforderlich] Fehlerprotokolle helfen uns auch dabei, Probleme, die wir in der CLI sehen, zu debuggen und zu reproduzieren.

Derzeit nicht erfasst