Habilitar o Transaction Search - Amazon CloudWatch
Habilitar o Transaction Search no consoleComo habilitar a Pesquisa de transações usando uma API

Habilitar o Transaction Search

É possível habilitar Transaction Search via console ou por meio de uma API. A pesquisa de transações é configurada para a conta inteira e muda a ingestão de todas as extensões por meio do X-Ray para o modo de coleta econômico usando os Preços do Amazon CloudWatch. Por padrão, você também indexará 1% das extensões ingeridas gratuitamente como resumo de rastreamento para análise, o que normalmente é suficiente, considerando que você já tem visibilidade total de rastreamento de ponta a ponta em todas as expansões ingeridas via Transaction Search.

Habilitar o Transaction Search no console

O procedimento a seguir descreve como habilitar o Transaction Search no console.

Para habilitar o Transaction Search no console do CloudWatch

  1. Abra o console do CloudWatch, em https://console.aws.amazon.com/cloudwatch/.

  2. No painel de navegação, em Application Signals, escolha Transaction Search.

  3. Escolha Habilitar Transaction Search.

  4. Selecione a caixa para ingerir extensões como logs estruturados e insira uma porcentagem das extensões a serem indexadas. Você pode indexar extensões a 1% gratuitamente e alterar a porcentagem posteriormente com base em suas necessidades.

Como habilitar a Pesquisa de transações usando uma API

O procedimento a seguir descreve como habilitar a Pesquisa de transações usando uma API.

Etapa 1. Criar uma política que conceda acesso a extensões de ingestão no CloudWatch Logs

Ao usar o SDK ou a AWS CLI para habilitar o Transaction Search, você deve configurar as permissões usando uma política baseada em recursos com PutResourcePolicy.

Exemplo de política

O exemplo de política a seguir permite que o X-Ray envie rastreamentos para o CloudWatch Logs 

{
    "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"
                }
            }
        }
    ]
}
Exemplo de comando

O exemplo a seguir mostra como formatar o comando da AWS CLI com a política 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" } } } ]}'

Etapa 2. Configurar o destino dos segmentos de rastreamento

Configure a ingestão de extensões com UpdateTraceSegmentDestination.

Exemplo de comando

O exemplo a seguir mostra como formatar o comando da AWS CLI com a política UpdateTraceSegmentDestination. 

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

Etapa 3. Configurar a quantidade de extensões a serem indexadas

Configure a porcentagem de amostragem desejada com UpdateIndexingRule.

Exemplo de comando

O exemplo a seguir mostra como formatar o comando da AWS CLI com a política UpdateIndexingRule. 

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

Depois de habilitar o Transaction Search, pode levar dez minutos para que as extensões fiquem disponíveis para pesquisa e análise.

Etapa 4. Verificar se as extensões estão disponíveis para pesquisa e análise

Para verificar se as extensões estão disponíveis para pesquisa e análise, use GetTraceSegmentDestination.

Exemplos de comando

O exemplo a seguir mostra como formatar o comando da AWS CLI com a política GetTraceSegmentDestination. 

aws xray get-trace-segment-destination
Exemplo de resposta

O exemplo a seguir mostra a resposta que você pode esperar quando o Transaction Search está ativo. 

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