Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Abilitazione di Transaction Search
Puoi abilitare [Transaction Search](CloudWatch-Transaction-Search.md) utilizzando la console o l'API. [La ricerca delle transazioni è configurata per l'intero account e trasforma l'inserimento di tutti gli intervalli tramite X-Ray in una modalità di raccolta conveniente utilizzando Amazon Pricing. CloudWatch ](https://aws.amazon.com/cloudwatch/pricing/) Per impostazione predefinita, indicizzerai gratuitamente anche l'1% degli intervalli inseriti come riepilogo delle tracce per l'analisi, il che in genere è sufficiente dato che hai già una visibilità completa delle end-to-end tracce su tutti gli intervalli importati tramite Transaction Search.
## Prerequisiti
Prima di abilitare Transaction Search, è necessario creare un ruolo con le seguenti autorizzazioni.
------
#### [ 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/*"
}
]
}
```
------
**Nota**
[Per utilizzare Transaction Search e altre CloudWatch funzionalità, aggiungi la policy al tuo ruolo. CloudWatchReadOnlyAccess ](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/CloudWatchReadOnlyAccess.html) Per ulteriori informazioni sulla creazione di un ruolo, consulta [IAM role creation](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create.html).
## Abilitazione di Transaction Search nella console
La procedura seguente descrive come abilitare Transaction Search nella console.
**Per abilitare Transaction Search nella CloudWatch console**
1. Apri la CloudWatch console all'indirizzo [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. Dal pannello di navigazione, in **Application Signals**, scegli **Transaction Search**.
1. Scegli **Abilita Transaction Search**
1. Seleziona la casella per importare gli intervalli come log strutturati e inserisci una percentuale di intervalli da indicizzare. Puoi indicizzare gli intervalli all'1% gratuitamente e modificare la percentuale in un secondo momento in base alle tue esigenze.
## Abilitazione di Transaction Search tramite un'API
La procedura seguente descrive come abilitare Transaction Search utilizzando un'API.
### Passaggio 1. Crea una politica che garantisca l'accesso agli intervalli di acquisizione nei registri CloudWatch
Quando si utilizza l'SDK AWS CLI o per abilitare Transaction Search, è necessario configurare le autorizzazioni utilizzando una politica basata sulle risorse con. [https://docs.aws.amazon.com/xray/latest/api/API_PutResourcePolicy.html](https://docs.aws.amazon.com/xray/latest/api/API_PutResourcePolicy.html)
**Policy di esempio**
La seguente policy di esempio consente a X-Ray di inviare tracce a Logs CloudWatch
------
#### [ 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}}"
}
}
}
]
}
```
------
**Esempio di comando**
L'esempio seguente mostra come formattare il AWS CLI comando con. `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" } } } ]}'
```
### Passaggio 2. Configurazione della destinazione dei segmenti di traccia
Configura l'importazione degli intervalli con [https://docs.aws.amazon.com/xray/latest/api/API_UpdateTraceSegmentDestination.html](https://docs.aws.amazon.com/xray/latest/api/API_UpdateTraceSegmentDestination.html).
**Esempio di comando**
L'esempio seguente mostra come formattare il AWS CLI comando con`UpdateTraceSegmentDestination`.
```
aws xray update-trace-segment-destination --destination CloudWatchLogs
```
### Fase 3. Configurazione della quantità di intervalli da indicizzare
Configura la percentuale di campionamento desiderata con [https://docs.aws.amazon.com/xray/latest/api/API_UpdateIndexingRule.html](https://docs.aws.amazon.com/xray/latest/api/API_UpdateIndexingRule.html)
**Esempio di comando**
L'esempio seguente mostra come formattare il AWS CLI comando con`UpdateIndexingRule`.
```
aws xray update-indexing-rule --name "Default" --rule '{"Probabilistic": {"DesiredSamplingPercentage": number}}'
```
**Nota**
Dopo aver abilitato Transaction Search, potrebbero essere necessari fino a dieci minuti prima che gli intervalli risultino disponibili per la ricerca e l'analisi.
### Passaggio 4. Verifica della disponibilità a fini di ricerca e analisi degli intervalli
Per verificare che gli intervalli siano disponibili per la ricerca e l'analisi, utilizza [https://docs.aws.amazon.com/xray/latest/api/API_GetTraceSegmentDestination.html](https://docs.aws.amazon.com/xray/latest/api/API_GetTraceSegmentDestination.html).
**Comandi di esempio**
L'esempio seguente mostra come formattare il AWS CLI comando con`GetTraceSegmentDestination`.
```
aws xray get-trace-segment-destination
```
**Esempio di risposta**
L'esempio seguente mostra la risposta che ci si può aspettare quando Transaction Search è attiva.
```
{
"Destination": "CloudWatchLogs",
"Status": "ACTIVE"
}
```