Aktivieren Sie die Transaktionssuche - Amazon CloudWatch
Transaktionssuche in der Konsole aktivierenAktivieren der Transaktionssuche mithilfe einer API

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Aktivieren Sie die Transaktionssuche

Sie können die Aktivierung Suche nach Transaktionen über die Konsole oder mithilfe einer API vornehmen. Die Transaktionssuche ist für das gesamte Konto konfiguriert und schaltet die gesamte Erfassung über X-Ray in den kostengünstigen Sammelmodus mit Amazon Pricing um. CloudWatch Standardmäßig indexieren Sie außerdem 1% der aufgenommenen Spans kostenlos als Trace-Zusammenfassung zur Analyse. Dies ist in der Regel ausreichend, da Sie über die Transaktionssuche bereits eine vollständige Übersicht über alle aufgenommenen end-to-end Spans haben.

Transaktionssuche in der Konsole aktivieren

Im folgenden Verfahren wird beschrieben, wie Sie die Transaktionssuche in der Konsole aktivieren.

Um die Transaktionssuche in der CloudWatch Konsole zu aktivieren

  1. Öffnen Sie die CloudWatch Konsole unter https://console.aws.amazon.com/cloudwatch/.

  2. Wählen Sie im Navigationsbereich unter Application Signals die Option Transaction Search aus.

  3. Wählen Sie Transaktionssuche aktivieren.

  4. Wählen Sie das Feld aus, um Spans als strukturierte Logs aufzunehmen, und geben Sie einen Prozentsatz der zu indizierenden Spans ein. Sie können Spannen kostenlos mit 1% indexieren und den Prozentsatz später Ihren Anforderungen entsprechend ändern.

Aktivieren der Transaktionssuche mithilfe einer API

Das folgende Verfahren beschreibt, wie Sie die Transaktionssuche mithilfe einer API aktivieren.

Schritt 1. Erstellen Sie eine Richtlinie, die Zugriff auf Aufnahmebereiche in Protokollen gewährt CloudWatch

Wenn Sie das AWS CLI oder SDK verwenden, um die Transaktionssuche zu aktivieren, müssen Sie Berechtigungen mithilfe einer ressourcenbasierten Richtlinie mit konfigurieren. PutResourcePolicy

Beispielrichtline

Die folgende Beispielrichtlinie ermöglicht es X-Ray, Traces an CloudWatch Logs zu senden 

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "TransactionSearchXRayAccess",
            "Effect": "Allow",
            "Principal": {
                "Service": "xray.amazonaws.com"
            },
            "Action": "logs:PutLogEvents",
            "Resource": [
                "arn:partition:logs:region:account-id:log-group:aws/spans:*",
                "arn:partition:logs:region:account-id:log-group:/aws/application-signals/data:*"
            ],
            "Condition": {
                "ArnLike": {
                    "aws:SourceArn": "arn:partition:xray:region:account-id:*"
                },
                "StringEquals": {
                    "aws:SourceAccount": "account-id"
                }
            }
        }
    ]
}
-Beispielbefehl

Das folgende Beispiel zeigt, wie Sie Ihren AWS CLI Befehl mit formatierenPutResourcePolicy. 

aws logs put-resource-policy --policy-name MyResourcePolicy --policy-document '{ "Version": "2012-10-17", "Statement": [ { "Sid": "TransactionSearchXRayAccess", "Effect": "Allow", "Principal": { "Service": "xray.amazonaws.com" }, "Action": "logs:PutLogEvents", "Resource": [ "arn:partition:logs:region:account-id:log-group:aws/spans:*", "arn:partition:logs:region:account-id:log-group:/aws/application-signals/data:*" ], "Condition": { "ArnLike": { "aws:SourceArn": "arn:partition:logs:region:account-id:*" }, "StringEquals": { "aws:SourceAccount": "account-id" } } } ]}'

Schritt 2. Konfigurieren Sie das Ziel von Trace-Segmenten

Konfigurieren Sie die Aufnahme von Spans mit. UpdateTraceSegmentDestination

-Beispielbefehl

Das folgende Beispiel zeigt, wie Sie Ihren AWS CLI Befehl mit formatieren. UpdateTraceSegmentDestination 

aws xray update-trace-segment-destination --destination CloudWatchLogs

Schritt 3. Konfigurieren Sie die Anzahl der zu indizierenden Bereiche

Konfigurieren Sie den gewünschten Stichprobenprozentsatz mit UpdateIndexingRule

-Beispielbefehl

Das folgende Beispiel zeigt, wie Sie Ihren AWS CLI Befehl mit formatierenUpdateIndexingRule. 

aws xray update-indexing-rule --name "Default" --rule '{"Probabilistic": {"DesiredSamplingPercentage": number}}'
Anmerkung

Nachdem Sie die Transaktionssuche aktiviert haben, kann es zehn Minuten dauern, bis Spans für die Suche und Analyse verfügbar sind.

Schritt 4. Stellen Sie sicher, dass Spans für die Suche und Analyse verfügbar sind

Um zu überprüfen, ob Spans für die Suche und Analyse verfügbar sind, verwenden Sie. GetTraceSegmentDestination

Beispielbefehle

Das folgende Beispiel zeigt, wie Sie Ihren AWS CLI Befehl mit GetTraceSegmentDestination formatieren. 

aws xray get-trace-segment-destination
Beispielantwort

Das folgende Beispiel zeigt die Reaktion, die Sie erwarten können, wenn die Transaktionssuche aktiv ist. 

{
    "Destination": "CloudWatchLogs",
    "Status": "ACTIVE"
}