As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Rastreamento ativo no Amazon SNS

Use o AWS X-Ray para rastrear e analisar as solicitações dos usuários à medida que elas passam por seus tópicos do Amazon SNS até as assinaturas do Amazon Data Firehose, AWS Lambda, Amazon SQS e endpoint HTTP/S.

Com o X-Ray, você obtém uma visão completa de cada solicitação, permitindo que você:

Se você chamar uma API do Amazon SNS de um serviço que já foi rastreado, o Amazon SNS enviará o rastreamento adiante, mesmo que o rastreamento do X-Ray não esteja habilitado na API.

O Amazon SNS permite o rastreamento do X-Ray para tópicos comuns e FIFO. Você pode ativar o X-Ray para um tópico do Amazon SNS usando o console do Amazon SNS, a API SetTopicAttributes do Amazon SNS, a referência de CLI do Amazon Simple Notification Service ou o CloudFormation.

Para saber mais sobre como usar o Amazon SNS com o X-Ray, consulte Amazon SNS e AWS X-Ray no Guia do desenvolvedor do AWS X-Ray.

Permissões de rastreamento ativo

Ao usar o console do Amazon SNS, o Amazon SNS tenta criar as permissões necessárias para que o tópico do Amazon SNS chame o X-Ray. A tentativa poderá ser rejeitada se você não tiver permissões suficientes para usar o console do Amazon SNS. Para obter mais informações, consulte Gerenciamento de identidade e acesso no Amazon SNS e Casos de exemplo para controle de acesso do Amazon SNS.

Ao usar a CLI, você deve configurar manualmente as permissões. Essas permissões são configuradas usando políticas de recursos. Para saber mais sobre como usar as permissões necessárias no X-Ray, consulte Amazon SNS e AWS X-Ray.

Habilitar o rastreamento ativo em um tópico do Amazon SNS o console da AWS

Quando o rastreamento ativo é habilitado em um tópico do Amazon SNS, ele lê o ID de rastreamento, envia os dados para o cliente com base no ID de rastreamento e propaga o ID de rastreamento para serviços downstream.

Depois de habilitar o X-Ray para o tópico do Amazon SNS, você poderá usar o mapa de serviços do X-Ray para visualizar os rastreamentos completos e os mapas de serviços do tópico.

Habilitar o rastreamento ativo em um tópico do Amazon SNS o AWS SDK

O exemplo de código a seguir mostra como habilitar o rastreamento ativo em um tópico do Amazon SNS usando o AWS SDK para Java.

public static void enableActiveTracing(SnsClient snsClient, String topicArn) {

        try {

            SetTopicAttributesRequest request = SetTopicAttributesRequest.builder()
                .attributeName("TracingConfig")
                .attributeValue("Active")
                .topicArn(topicArn)
                .build();

            SetTopicAttributesResponse result = snsClient.setTopicAttributes(request);
            System.out.println("\n\nStatus was " + result.sdkHttpResponse().statusCode() + "\n\nTopic " + request.topicArn()
                + " updated " + request.attributeName() + " to " + request.attributeValue());

        } catch (SnsException e) {
            System.err.println(e.awsErrorDetails().errorMessage());
        }
    }

Habilitar o rastreamento ativo em um tópico do Amazon SNS usando o AWS CLI

O exemplo de código a seguir mostra como habilitar o rastreamento ativo em um tópico do Amazon SNS usando a AWS CLI.

aws sns set-topic-attributes \
    --topic-arn arn:aws:sns:us-west-2:123456789012:MyTopic \
    --attribute-name TracingConfig \
    --attribute-value Active

Habilitar o rastreamento ativo em um tópico do Amazon SNS usando o CloudFormation

A pilha do CloudFormation a seguir mostra como habilitar o rastreamento ativo em um tópico do Amazon SNS.

AWSTemplateFormatVersion: 2010-09-09
Resources:
  MyTopicResource:
    Type: 'AWS::SNS::Topic'
    Properties:
      TopicName: 'MyTopic'
      TracingConfig: 'Active'

Verificar se o rastreamento ativo está habilitado para o tópico

Você pode usar o console do Amazon SNS para verificar se o rastreamento ativo está habilitado para o tópico ou para verificar quando a política de recursos não foi adicionada.

Testar rastreamento ativo