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.
Úselo AWS X-Ray para rastrear y analizar las solicitudes de los usuarios a medida que pasan por sus temas de Amazon SNS hasta las suscripciones de puntos de conexión Amazon Data Firehose, Amazon AWS LambdaSQS y HTTP/S.
Con X-Ray, obtiene una end-to-end vista de cada solicitud, lo que le permite:
-
Identifique qué es lo que llama a su tema de Amazon SNS y qué servicios son posteriores a sus suscripciones.
-
Analice las latencias, como las siguientes:
-
Tiempo dedicado al tema Amazon SNS antes de procesarlo.
-
Tiempos de entrega para cada punto de conexión suscrito.
-
importante
Es posible que los temas de Amazon SNS con numerosas suscripciones alcancen el límite de tamaño y no se rastreen por completo. Para obtener información sobre los límites de tamaño de los documentos de rastreo, consulte las cuotas de servicio de rayos X en la Referencia AWS general.
Si llama a una API de Amazon SNS desde un servicio que ya se está rastreando, Amazon SNS transmite el rastreo, aunque el rastreo de X-Ray no esté habilitado en la API.
Amazon SNS solo admite rastreo de X-Ray para temas estándar y FIFO. Puede habilitar X-Ray para un tema de Amazon SNS mediante la consola de Amazon SNSSetTopicAttributes de Amazon SNS, la referencia de la CLI de Amazon Simple Notification Service o AWS CloudFormation.
Para obtener más información acerca del uso de Amazon SNS con X-Ray, consulte Amazon SNS and AWS X-Ray (Amazon SNS y AWS X-Ray) en la Guía para desarrolladores de AWS X-Ray .
Permisos de rastreo activo
Al utilizar la consola de Amazon SNS, Amazon SNS intenta crear los permisos necesarios para que el tema de Amazon SNS llame a X-Ray. El intento puede rechazarse si no tiene los permisos suficientes para usar la consola de Amazon SNS. Para obtener más información, consulte Identity and Access Management en Amazon SNS y Ejemplos de casos de control de acceso con Amazon SNS.
Cuando utilice la CLI, debe configurar los permisos manualmente. Estos permisos se configuran mediante políticas de recursos. Para obtener más información acerca del uso de los permisos necesarios en X-Ray, consulte Amazon SNS and AWS X-Ray (Amazon SNS y AWS X-Ray).
Habilitar el rastreo activo en un tema de Amazon SNS mediante la consola AWS
Cuando se habilita el rastreo activo en un tema de Amazon SNS, este lee el identificador de rastreo, envía los datos al cliente en función de ese identificador y lo propaga a los servicios posteriores.
Inicie sesión en la consola de Amazon SNS
. -
Elija un tema o cree uno nuevo. Para obtener más información acerca de la creación de temas, consulte Creación de un tema de Amazon SNS.
-
En la página Crear tema, en la sección Detalles, elija un tipo de tema: FIFO o Estándar.
-
Ingrese un nombre para el nuevo tema.
-
(Opcional) Ingrese un nombre para mostrar para el tema.
-
-
Expanda Active tracing (Rastreo activo) y seleccione Use active tracing (Usar rastreo activo).
Una vez que hayas activado X-Ray para tu tema de Amazon SNS, puedes usar el mapa del servicio de X-Ray para ver las end-to-end trazas y los mapas de servicio del tema.
Habilitar el rastreo activo en un tema de Amazon SNS mediante el SDK AWS
El siguiente ejemplo de código muestra cómo habilitar el rastreo activo en un tema de Amazon SNS mediante AWS el 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());
}
}Habilitar el rastreo activo en un tema de Amazon SNS mediante la CLI AWS
El siguiente ejemplo de código muestra cómo habilitar el rastreo activo en un tema de Amazon SNS mediante la AWS CLI.
aws sns set-topic-attributes \ --topic-arn arn:aws:sns:us-west-2:123456789012:MyTopic \ --attribute-name TracingConfig \ --attribute-value Active
Habilitar el rastreo activo en un tema de Amazon SNS mediante AWS CloudFormation
La siguiente AWS CloudFormation pila muestra cómo habilitar el rastreo activo en un tema de Amazon SNS.
AWSTemplateFormatVersion: 2010-09-09 Resources: MyTopicResource: Type: 'AWS::SNS::Topic' Properties: TopicName: 'MyTopic' TracingConfig: 'Active'
Verificación de que el rastreo activo está habilitado para su tema
Puede utilizar la consola de Amazon SNS para comprobar si el rastreo activo está habilitado para su tema o si no se ha podido añadir la política de recursos.
Inicie sesión en la consola de Amazon SNS
. -
En el panel de navegación izquierdo, elija Topics (Temas).
-
Elija un tema en la página Topics (Temas).
-
Elija la pestaña Integrations (Integraciones).
Cuando el rastreo activo está habilitado, aparece un icono Active (Activo) de color verde.
-
Si ha habilitado el rastreo activo y no ve que se haya añadido la política de recursos, elija Create policy (Crear política) para añadir los permisos adicionales necesarios.
Prueba del rastreo activo
Inicie sesión en la consola de Amazon SNS
. -
Crear un tema de Amazon SNS Para obtener más detalles sobre cómo hacerlo, consulte Para crear un tema mediante el AWS Management Console.
-
Expanda Active tracing (Rastreo activo) y seleccione Use active tracing (Usar rastreo activo).
-
Publique un mensaje en el tema de Amazon SNS. Para obtener más detalles sobre cómo hacerlo, consulte Para publicar mensajes en temas de Amazon SNS mediante la AWS Management Console, siga estos pasos:.
-
Utilice el mapa del servicio de X-Ray para ver las end-to-end trazas y los mapas de servicio del tema.
