Rastreamento ativo no Amazon SNS

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

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

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

Com o X-Ray, você tem uma end-to-end visão 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 AWS 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 ter 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.

Habilitando o rastreamento ativo em um tópico do Amazon SNS usando o console 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 seu tópico do Amazon SNS, você pode usar o mapa do serviço X-Ray para visualizar os end-to-end rastreamentos e mapas de serviço do tópico.

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

O exemplo de código a seguir mostra como habilitar o rastreamento ativo em um tópico do Amazon SNS usando AWS o SDK for 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());
        }
    }

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

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

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

A AWS CloudFormation pilha 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