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.

Rastreo activo en Amazon SNS

Utilice AWS X-Ray para rastrear y analizar las solicitudes de los usuarios cuando pasen por sus temas de Amazon SNS hasta las suscripciones de Amazon Data Firehose, AWS Lambda, Amazon SQS y de punto de conexión HTTP/S.

Con X-Ray, obtiene una vista integral de cada solicitud, lo que le permite:

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 SNS, la API SetTopicAttributes de Amazon SNS, la referencia de la CLI de Amazon Simple Notification Service o CloudFormation.

Para obtener más información acerca del uso de Amazon SNS con X-Ray, consulte 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 y AWS X-Ray.

Habilitación del rastreo activo en un tema de Amazon SNS mediante la consola de 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.

Una vez que haya habilitado X-Ray en su tema de Amazon SNS, puede utilizar el mapa del servicio X-Ray para ver los rastreos y los mapas de servicio integrales del tema.

Habilitación del rastreo activo en un tema de Amazon SNS mediante el SDK de AWS

En el siguiente código de ejemplo, se muestra cómo habilitar el rastreo activo en un tema de Amazon SNS con AWS SDK para 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());
        }
    }

Habilitación del rastreo activo en un tema de Amazon SNS mediante la CLI de AWS

En el siguiente código de ejemplo, se muestra cómo habilitar el rastreo activo en un tema de Amazon SNS con la CLI de AWS.

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

Habilitación del rastreo activo en un tema de Amazon SNS mediante CloudFormation

La siguiente pila de CloudFormation indica 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.

Prueba del rastreo activo