View a markdown version of this page

Amazon SNS y AWS X-Ray - AWS X-Ray

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Amazon SNS y AWS X-Ray

Puede usarlo AWS X-Ray con Amazon Simple Notification Service (Amazon SNS) para rastrear y analizar las solicitudes a medida que pasan por los temas de su SNS hasta sus SNS-supported servicios de suscripción. Utilice el X-Ray rastreo con Amazon SNS para analizar las latencias de sus mensajes y sus servicios de back-end, por ejemplo, cuánto tiempo dura una solicitud en un tema y cuánto tarda en llegar el mensaje a cada una de las suscripciones del tema. Amazon SNS admite el X-Ray rastreo de temas estándar y FIFO.

Si publica en un tema de Amazon SNS desde un servicio con el que ya está equipado X-Ray, Amazon SNS pasa el contexto de seguimiento del editor a los suscriptores. Además, puede activar el rastreo activo para enviar datos segmentados sobre sus suscripciones de Amazon SNS a los mensajes publicados desde un cliente X-Ray de SNS instrumentado. Active el rastreo activo para un tema de Amazon SNS a través de la consola de Amazon SNS o de la API o la CLI de Amazon SNS. Consulte Instrumentación de su solicitud para obtener más información sobre cómo instrumentar sus clientes de SNS.

Configuración del rastreo activo de Amazon SNS

Puede usar la consola de Amazon SNS o la AWS CLI o el SDK para configurar el rastreo activo de Amazon SNS.

Cuando utiliza la consola de Amazon SNS, Amazon SNS intenta crear los permisos necesarios para que SNS pueda realizar llamadas. X-Ray El intento puede rechazarse si no tiene los permisos suficientes para modificar X-Ray las políticas de recursos. Para obtener más información sobre estos permisos consulte Administración de identidades y accesos en Amazon SNS y Ejemplos de casos de control de acceso con Amazon SNS en la Guía para desarrolladores de Amazon Simple Notification Service. Para obtener más información acerca de cómo activar el rastreo activo a través de la consola de Amazon SNS, consulte Habilitar el rastreo activo en un tema de Amazon SNS en la Guía para desarrolladores de Amazon Simple Notification Service.

Cuando utilices la AWS CLI o el SDK para activar el rastreo activo, debes configurar los permisos manualmente mediante políticas basadas en los recursos. PutResourcePolicyUtilícelo para X-Ray configurarlo con la política basada en los recursos necesaria para permitir a Amazon SNS enviar rastreos a. X-Ray

ejemplo Ejemplo de política X-Ray basada en recursos para el rastreo activo de Amazon SNS

Este documento de política de ejemplo especifica los permisos que Amazon SNS necesita para enviar datos de rastreo 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" } } } ] }

Utilice la CLI para crear una política basada en recursos que otorgue a Amazon SNS permisos para enviar datos de seguimiento a: X-Ray

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" } } } ] }'

Para usar estos ejemplos, sustituyapartition, regionaccount-id, y topic-name por su AWS partición, región, ID de cuenta y nombre de tema de Amazon SNS específicos. Para conceder a todos los temas de Amazon SNS permiso para enviar datos de rastreo X-Ray, sustituya el nombre del tema por. *

Consulte los rastros de editores y suscriptores de Amazon SNS en la consola X-Ray

Utilice la X-Ray consola para ver un mapa de seguimiento y los detalles de seguimiento que muestran una vista conectada de los editores y suscriptores de Amazon SNS. Cuando el rastreo activo de Amazon SNS está activado para un tema, el mapa de X-Ray rastreo y los detalles del rastreo muestra los nodos conectados para los editores de Amazon SNS, el tema de Amazon SNS y los suscriptores intermedios:

Mapa de rastros con el publicador y el suscriptor de Amazon SNS

Tras elegir un rastreo que abarque a un publicador y un suscriptor de Amazon SNS, la página de detalles del rastreo muestra un mapa de detalles del X-Ray rastreo y un cronograma de segmentos.

ejemplo Ejemplo de escala de tiempo con el publicador y el suscriptor de Amazon SNS

En este ejemplo se muestra una escala de tiempo que incluye a un publicador de Amazon SNS que envía un mensaje a un tema de Amazon SNS que es procesado por un suscriptor de Amazon SQS.

Escala de tiempo de segmentos con el publicador y el suscriptor de Amazon SNS

El ejemplo de escala de tiempo anterior proporciona detalles sobre el flujo de mensajes de Amazon SNS:

  • El segmento SNS representa la duración de ida y vuelta de la llamada a la API Publish desde el cliente.

  • El segmento myTopic representa la latencia de la respuesta de Amazon SNS a la solicitud de publicación.

  • El subsegmento SQS representa el tiempo de ida y vuelta que tarda Amazon SNS en publicar el mensaje en una cola de Amazon SQS.

  • El tiempo entre el segmento MyTopic y el subsegmento SQS representa el tiempo que el mensaje pasa en el sistema Amazon SNS.

ejemplo Ejemplo de escala de tiempo con mensajes de Amazon SNS por lotes

Si se agrupan varios mensajes de Amazon SNS en un solo lote de un rastro, la escala de tiempo de los segmentos muestra los segmentos que representan cada mensaje que se procesa.

Escala de tiempo de los mensajes por lotes de Amazon SNS