Die Transaktionssuche aktivieren - Amazon CloudWatch
VoraussetzungenAktivieren der Transaktionssuche in der KonsoleAktivieren 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.

Die Transaktionssuche aktivieren

Sie können Transaktionssuche über die Konsole oder mit der API erneut erstellen. Die Transaktionssuche ist für das gesamte Konto konfiguriert und schaltet die gesamte Datenerfassung ü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.

Voraussetzungen

Bevor Sie die Transaktionssuche aktivieren können, müssen Sie eine Rolle mit den folgenden Berechtigungen erstellen.

JSON
{
  "Version":"2012-10-17",		 	 	 		 	 	 
  "Statement": [
    {
      "Sid": "TransactionSearchXRayPermissions",
      "Effect": "Allow",
      "Action": [
        "xray:GetTraceSegmentDestination",
        "xray:UpdateTraceSegmentDestination",
        "xray:GetIndexingRules",
        "xray:UpdateIndexingRule"
      ],
      "Resource": "*"
    },
    {
      "Sid": "TransactionSearchLogGroupPermissions",
      "Effect": "Allow",
      "Action": [
        "logs:CreateLogGroup",
        "logs:CreateLogStream",
        "logs:PutRetentionPolicy"
      ],
      "Resource": [
        "arn:aws:logs:*:*:log-group:/aws/application-signals/data:*",
        "arn:aws:logs:*:*:log-group:aws/spans:*"
      ]
    },
    {
      "Sid": "TransactionSearchLogsPermissions",
      "Effect": "Allow",
      "Action": [
        "logs:PutResourcePolicy",
        "logs:DescribeResourcePolicies"
      ],
      "Resource": "*"
    },
    {
      "Sid": "TransactionSearchApplicationSignalsPermissions",
      "Effect": "Allow",
      "Action": [
        "application-signals:StartDiscovery"
      ],
      "Resource": "*"
    },
    {
      "Sid": "CloudWatchApplicationSignalsCreateServiceLinkedRolePermissions",
      "Effect": "Allow",
      "Action": "iam:CreateServiceLinkedRole",
      "Resource": "arn:aws:iam::*:role/aws-service-role/application-signals.cloudwatch.amazonaws.com/AWSServiceRoleForCloudWatchApplicationSignals",
      "Condition": {
        "StringLike": {
          "iam:AWSServiceName": "application-signals.cloudwatch.amazonaws.com"
        }
      }
    },
    {
      "Sid": "CloudWatchApplicationSignalsGetRolePermissions",
      "Effect": "Allow",
      "Action": "iam:GetRole",
      "Resource": "arn:aws:iam::*:role/aws-service-role/application-signals.cloudwatch.amazonaws.com/AWSServiceRoleForCloudWatchApplicationSignals"
    },
    {
      "Sid": "CloudWatchApplicationSignalsCloudTrailPermissions",
      "Effect": "Allow",
      "Action": [
        "cloudtrail:CreateServiceLinkedChannel"
      ],
      "Resource": "arn:aws:cloudtrail:*:*:channel/aws-service-channel/application-signals/*"
    }
  ]
}
Anmerkung

Um die Transaktionssuche und andere CloudWatch Funktionen zu verwenden, fügen Sie die CloudWatchReadOnlyAccess Richtlinie Ihrer Rolle hinzu. Weitere Informationen zum Erstellen von Rollen finden Sie unter Erstellen einer IAM-Rolle.

Aktivieren der Transaktionssuche in der Konsole

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 Transaktionssuche aus.

  3. Wählen Sie Transaktionssuche aktivieren.

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

Aktivieren der Transaktionssuche mithilfe einer API

Im folgenden Verfahren wird beschrieben, wie Sie die Transaktionssuche über eine API aktivieren.

Schritt 1. Erstellen Sie eine Richtlinie, die Zugriff auf Aufnahmebereiche in Logs 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

JSON

{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Sid": "TransactionSearchXRayAccess",
            "Effect": "Allow",
            "Principal": {
                "Service": "xray.amazonaws.com"
            },
            "Action": "logs:PutLogEvents",
            "Resource": [
                "arn:aws:logs:us-east-1:123456789012:log-group:aws/spans:*",
                "arn:aws:logs:us-east-1:123456789012:log-group:/aws/application-signals/data:*"
            ],
            "Condition": {
                "ArnLike": {
                    "aws:SourceArn": "arn:aws:xray:us-east-1:123456789012:*"
                },
                "StringEquals": {
                    "aws:SourceAccount": "123456789012"
                }
            }
        }
    ]
}
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 Ablaufverfolgungssegmenten

Konfigurieren Sie die Erfassung von Spans mit UpdateTraceSegmentDestination.

Beispielbefehl

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

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

Schritt 3. Konfigurieren Sie die Anzahl der zu indexierenden Spans

Konfigurieren Sie den gewünschten Sampling-Prozentsatz 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 zur Suche und Analyse verfügbar sind.

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

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

Beispielbefehle

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

aws xray get-trace-segment-destination
Beispielantwort

Das folgende Beispiel zeigt die zu erwartende Reaktion, wenn die Transaktionssuche aktiv ist. 

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