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](CloudWatch-Transaction-Search.md) über die Konsole oder mit der API erneut erstellen. [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 ](https://aws.amazon.com/cloudwatch/pricing/) 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 erfassten 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](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/CloudWatchReadOnlyAccess.html) Ihrer Rolle hinzu. Weitere Informationen zum Erstellen von Rollen finden Sie unter [Erstellen einer IAM-Rolle](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create.html).
## 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/](https://console.aws.amazon.com/cloudwatch/).
1. Wählen Sie im Navigationsbereich unter **Application Signals** die Option **Transaktionssuche** aus.
1. Wählen Sie **Transaktionssuche aktivieren**.
1. 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. [https://docs.aws.amazon.com/xray/latest/api/API_PutResourcePolicy.html](https://docs.aws.amazon.com/xray/latest/api/API_PutResourcePolicy.html)
**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 formatieren`PutResourcePolicy`.
```
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:xray:region:account-id:*" }, "StringEquals": { "aws:SourceAccount": "account-id" } } } ]}'
```
### Schritt 2. Konfigurieren Sie das Ziel von Ablaufverfolgungssegmenten
Konfigurieren Sie die Erfassung von Spans mit [https://docs.aws.amazon.com/xray/latest/api/API_UpdateTraceSegmentDestination.html](https://docs.aws.amazon.com/xray/latest/api/API_UpdateTraceSegmentDestination.html).
**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 indexierenden Spans
Konfigurieren Sie den gewünschten Sampling-Prozentsatz mit [https://docs.aws.amazon.com/xray/latest/api/API_UpdateIndexingRule.html](https://docs.aws.amazon.com/xray/latest/api/API_UpdateIndexingRule.html)
**Beispielbefehl**
Das folgende Beispiel zeigt, wie Sie Ihren AWS CLI Befehl mit formatieren`UpdateIndexingRule`.
```
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 [https://docs.aws.amazon.com/xray/latest/api/API_GetTraceSegmentDestination.html](https://docs.aws.amazon.com/xray/latest/api/API_GetTraceSegmentDestination.html).
**Beispielbefehle**
Das folgende Beispiel zeigt, wie Sie Ihren AWS CLI Befehl mit formatieren`GetTraceSegmentDestination`.
```
aws xray get-trace-segment-destination
```
**Beispielantwort**
Das folgende Beispiel zeigt die zu erwartende Reaktion, wenn die Transaktionssuche aktiv ist.
```
{
"Destination": "CloudWatchLogs",
"Status": "ACTIVE"
}
```