Amazon SNS e AWS X-Ray

Puoi utilizzarlo AWS X-Ray con Amazon Simple Notification Service (Amazon SNS) per tracciare e analizzare le richieste man mano che attraversano gli argomenti SNS e arrivano ai tuoi SNS-supported servizi in abbonamento. Usa il X-Ray tracciamento con Amazon SNS per analizzare le latenze nei tuoi messaggi e nei relativi servizi di back-end, ad esempio quanto tempo trascorre una richiesta in un argomento e quanto tempo è necessario per recapitare il messaggio a ciascuno degli abbonamenti dell'argomento. Amazon SNS supporta X-Ray il tracciamento sia per argomenti standard che per argomenti FIFO.

Se pubblichi un argomento su Amazon SNS da un servizio già dotato di strumentazione X-Ray, Amazon SNS trasmette il contesto di tracciamento dall'editore agli abbonati. Inoltre, puoi attivare il tracciamento attivo per inviare dati di segmento relativi ai tuoi abbonamenti Amazon SNS X-Ray per i messaggi pubblicati da un client SNS strumentato. Attiva il tracciamento attivo per un argomento di Amazon SNS utilizzando la console Amazon SNS o utilizzando l'API o l'interfaccia a riga di comando di Amazon SNS. Per ulteriori informazioni sulla strumentazione dei client SNS, consulta Instrumenting your application.

Configura il tracciamento attivo di Amazon SNS

Puoi utilizzare la console Amazon SNS o l'interfaccia a riga di comando o l'SDK per configurare il AWS tracciamento attivo di Amazon SNS.

Quando utilizzi la console Amazon SNS, Amazon SNS tenta di creare le autorizzazioni necessarie per le chiamate da parte di SNS. X-Ray Il tentativo può essere rifiutato se non disponi di autorizzazioni sufficienti per modificare le politiche relative alle risorse. X-Ray Per ulteriori informazioni su queste autorizzazioni, consulta Gestione delle identità e degli accessi in Amazon SNS e Casi di esempio per il controllo degli accessi di Amazon SNS nella Amazon Simple Notification Service Developer Guide. Per ulteriori informazioni sull'attivazione dell'active tracing tramite la console Amazon SNS, consulta l'argomento Enabling active tracing on an Amazon SNS nella Amazon Simple Notification Service Developer Guide.

Quando utilizzi la AWS CLI o l'SDK per attivare l'active tracing, devi configurare manualmente le autorizzazioni utilizzando policy basate sulle risorse. Utilizzalo PutResourcePolicy per configurare X-Ray con la policy basata sulle risorse necessaria a cui consentire ad Amazon SNS di inviare tracce a. X-Ray

{
    Version: "2012-10-17",
    Statement: [
      {
        Sid: "SNSAccess",
        Effect: Allow,
        Principal: {
          Service: "sns.amazonaws.com",
        },
        Action: [
          "xray:PutTraceSegments",
          "xray:GetSamplingRules",
          "xray:GetSamplingTargets"
        ],
        Resource: "*",
        Condition: {
          StringEquals: {
            "aws:SourceAccount": "account-id"
          },
          StringLike: {
            "aws:SourceArn": "arn:partition:sns:region:account-id:topic-name"
          }
        }
      }
    ]
  }

aws xray put-resource-policy --policy-name MyResourcePolicy --policy-document '{ "Version": "2012-10-17", "Statement": [ { "Sid": "SNSAccess", "Effect": "Allow", "Principal": { "Service": "sns.amazonaws.com" }, "Action": [ "xray:PutTraceSegments", "xray:GetSamplingRules", "xray:GetSamplingTargets" ], "Resource": "*", "Condition": { "StringEquals": { "aws:SourceAccount": "account-id" }, "StringLike": { "aws:SourceArn": "arn:partition:sns:region:account-id:topic-name" } } } ] }'

Visualizza le tracce degli editori e degli abbonati di Amazon SNS nella console X-Ray

Usa la X-Ray console per visualizzare una mappa di tracciamento e i dettagli di tracciamento che mostrano una vista connessa degli editori e degli abbonati di Amazon SNS. Quando l'active tracing di Amazon SNS è attivato per un argomento, la mappa di traccia e la mappa dei dettagli di X-Ray traccia mostrano i nodi connessi per gli editori di Amazon SNS, l'argomento Amazon SNS e gli abbonati a valle:

Dopo aver scelto una traccia che includa un editore e un abbonato di Amazon SNS, la pagina dei dettagli della X-Ray traccia mostra una mappa dei dettagli della traccia e una cronologia del segmento.

Esempio Esempio di cronologia con editore e abbonato di Amazon SNS

Questo esempio mostra una sequenza temporale che include un publisher di Amazon SNS che invia un messaggio a un argomento Amazon SNS, che viene elaborato da un abbonato Amazon SQS.

La sequenza temporale di esempio riportata sopra fornisce dettagli sul flusso di messaggi di Amazon SNS:

• Il segmento SNS rappresenta la durata di andata e ritorno della chiamata Publish API dal client.

• Il segmento MyTopic rappresenta la latenza della risposta di Amazon SNS alla richiesta di pubblicazione.

• Il sottosegmento SQS rappresenta il tempo di andata e ritorno impiegato da Amazon SNS per pubblicare il messaggio in una coda Amazon SQS.

• Il tempo che intercorre tra il segmento MyTopic e il sottosegmento SQS rappresenta il tempo di permanenza del messaggio nel sistema Amazon SNS.

Esempio Esempio di cronologia con messaggi Amazon SNS in batch

Se più messaggi Amazon SNS vengono raggruppati in batch all'interno di una singola traccia, la timeline del segmento mostra i segmenti che rappresentano ogni messaggio elaborato.