Tracciamento attivo in Amazon SNS

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

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

Utilizzalo AWS X-Ray per tracciare e analizzare le richieste degli utenti mentre passano dagli argomenti di Amazon SNS agli abbonamenti endpoint Amazon Data Firehose, Amazon AWS LambdaSQS e HTTP/S.

Con X-Ray, hai una end-to-end visione di ogni richiesta, che ti consente di:

Se chiami un'API Amazon SNS da un servizio che viene già tracciato, Amazon SNS esegue il pass-through del tracciamento, anche se sull'API non è abilitato il tracciamento di X-Ray.

Amazon SNS supporta il tracciamento di X-Ray per gli argomenti standard e FIFO. È possibile abilitare X-Ray per un argomento Amazon SNS utilizzando la console Amazon SNS, l'API SetTopicAttributes Amazon SNS, la documentazione di riferimento della CLI del Servizio di notifica semplice Amazon o AWS CloudFormation.

Per ulteriori informazioni sull'utilizzo di Amazon SNS con X-Ray, consulta Amazon SNS e AWS X-Ray nella Guida per gli sviluppatori di AWS X-Ray .

Autorizzazioni per il tracciamento attivo

Quando si utilizza la console Amazon SNS, Amazon SNS tenta di creare le autorizzazioni necessarie per consentire all'argomento Amazon SNS di chiamare X-Ray. Il tentativo può essere rifiutato se si non dispone di autorizzazioni sufficienti per utilizzare la console Amazon SNS. Per ulteriori informazioni, consulta Identity and Access Management in Amazon SNS e Esempi di casi per il controllo degli accessi Amazon SNS.

Quando si utilizza la CLI, è necessario configurare manualmente le autorizzazioni. Tali autorizzazioni vengono configurate utilizzando le policy delle risorse. Per ulteriori informazioni sull'utilizzo delle autorizzazioni richieste in X-Ray, consulta Amazon SNS e AWS X-Ray.

Abilitazione del tracciamento attivo su un argomento Amazon SNS tramite la console AWS

Quando il tracciamento attivo è abilitato su un argomento Amazon SNS, legge l'ID di tracciamento, lo utilizza per inviare i dati al cliente e lo propaga ai servizi a valle.

Dopo aver abilitato X-Ray per il tuo argomento Amazon SNS, puoi utilizzare la mappa dei servizi X-Ray per visualizzare le tracce e le mappe dei servizi per end-to-end l'argomento.

Abilitazione del tracciamento attivo su un argomento Amazon SNS utilizzando l'SDK AWS

Il seguente esempio di codice mostra come abilitare il tracciamento attivo su un argomento Amazon SNS utilizzando AWS l'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());
        }
    }

Abilitazione del tracciamento attivo su un argomento Amazon SNS utilizzando la CLI AWS

Il seguente esempio di codice mostra come abilitare il tracciamento attivo su un argomento Amazon SNS utilizzando la CLI AWS .

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

Abilitazione del tracciamento attivo su un argomento Amazon SNS utilizzando AWS CloudFormation

Lo AWS CloudFormation stack seguente mostra come abilitare il tracciamento attivo su un argomento di Amazon SNS.

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

Verifica dell'abilitazione del tracciamento attivo per l'argomento

Puoi utilizzare la console Amazon SNS per verificare se il tracciamento attivo è abilitato per il tuo argomento o quando la policy delle risorse non è stata aggiunta.

Test del tracciamento attivo