Abilitazione di Transaction Search - Amazon CloudWatch
PrerequisitiAbilitazione di Transaction Search nella console Abilitazione di Transaction Search tramite un'API

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 utilizzando la console o l'API. La ricerca delle transazioni è configurata per l'intero account e trasforma l'importazione di tutti gli intervalli tramite X-Ray in una modalità di raccolta conveniente utilizzando Amazon Pricing. CloudWatch 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 Per ulteriori informazioni sulla creazione di un ruolo, consulta IAM role creation.

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/.

  2. Dal pannello di navigazione, in Application Signals, scegli Transaction Search.

  3. Scegli Abilita Transaction Search

  4. 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 importazione 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. PutResourcePolicy

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:logs:region:account-id:*" }, "StringEquals": { "aws:SourceAccount": "account-id" } } } ]}'

Passaggio 2. Configurazione della destinazione dei segmenti di traccia

Configura l'importazione degli intervalli con UpdateTraceSegmentDestination.

Esempio di comando

L'esempio seguente mostra come formattare il AWS CLI comando conUpdateTraceSegmentDestination. 

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

Fase 3. Configurazione della quantità di intervalli da indicizzare

Configura la percentuale di campionamento desiderata con UpdateIndexingRule

Esempio di comando

L'esempio seguente mostra come formattare il AWS CLI comando conUpdateIndexingRule. 

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 GetTraceSegmentDestination.

Comandi di esempio

L'esempio seguente mostra come formattare il AWS CLI comando conGetTraceSegmentDestination. 

aws xray get-trace-segment-destination
Risposta di esempio

L'esempio seguente mostra la risposta che ci si può aspettare quando Transaction Search è attiva. 

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