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à.
# Tracciamento attivo in Amazon SNS
AWS X-Ray Utilizzalo per tracciare e analizzare le richieste degli utenti mentre passano dagli argomenti di Amazon SNS ad Amazon Data [Firehose, Amazon [AWS Lambda](https://docs.aws.amazon.com/xray/latest/devguide/xray-services-lambda.html)](sns-firehose-as-subscriber.md)SQS e agli abbonamenti [endpoint](https://docs.aws.amazon.com/xray/latest/devguide/xray-services-sqs.html). HTTP/S
Con X-Ray, hai una end-to-end visione di ogni richiesta, che ti consente di:
+ Identifica il tuo argomento di Amazon SNS e quali servizi derivano dai relativi abbonamenti.
+ Analizza le latenze, ad esempio:
+ Tempo dedicato all'argomento Amazon SNS prima dell'elaborazione.
+ Tempi di consegna per ogni endpoint sottoscritto.
**Importante**
Gli argomenti di Amazon SNS con numerose sottoscrizioni possono raggiungere il limite di dimensioni consentito e non essere tracciati del tutto. Per informazioni sui limiti di dimensione dei documenti di traccia, consultate la sezione [X-ray service quotas](https://docs.aws.amazon.com/general/latest/gr/xray.html#limits_xray) nella sezione General Reference. AWS
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](https://console.aws.amazon.com/sns/v3/home), [l'API `SetTopicAttributes` Amazon SNS](https://docs.aws.amazon.com/sns/latest/api/API_SetTopicAttributes.html), [la documentazione di riferimento della CLI del Servizio di notifica semplice Amazon](https://docs.aws.amazon.com/cli/latest/reference/sns/) o [CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sns-topic.html).
Per ulteriori informazioni sull'utilizzo di Amazon SNS con X-Ray, consulta [Amazon SNS e AWS X-Ray](https://docs.aws.amazon.com/xray/latest/devguide/xray-services-sns.html) 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, consultare [Identity and Access Management in Amazon SNS](security-iam.md) e [Esempi di casi per il controllo degli accessi Amazon SNS](sns-access-policy-use-cases.md).
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](https://docs.aws.amazon.com/xray/latest/devguide/xray-services-sns.html).
## 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.
1. Accedi alla [console Amazon SNS](https://console.aws.amazon.com/sns/home).
1. Scegli un argomento o creane uno nuovo. Per ulteriori dettagli sulla creazione di argomenti, consulta [Creare un argomento Amazon SNS](sns-create-topic.md).
1. Nella pagina **Crea argomento**, nella sezione **Dettagli** scegli un tipo di argomento: **FIFO** o **Standard**.
1. Inserisci un **Nome** per l’argomento.
1. (Facoltativo) Compilare il **Display name (Nome visualizzato)** per l'argomento.
1. Espandi **Active tracing** (Monitoraggio attivo) e scegli **Use active tracing** (Usa tracciamento attivo).
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](https://docs.aws.amazon.com/xray/latest/devguide/xray-services-sns.html) 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 CloudFormation
Lo 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.
1. Accedi alla [console Amazon SNS](https://console.aws.amazon.com/sns/home).
1. Nel pannello di navigazione a sinistra, selezionare **Topics (Argomenti)**.
1. Nella pagina **Topics** (Argomenti), scegli un argomento.
1. Seleziona la scheda **Integrazioni**.
Quando il tracciamento attivo è abilitato, viene mostrata l'icona verde **Active** (Attivo).
1. Se hai abilitato il tracciamento attivo e non vedi che la policy delle risorse è stata aggiunta, scegli **Create policy** (Crea policy) per aggiungere le ulteriori autorizzazioni richieste.
![\[Schermata che mostra i dettagli di un argomento di Amazon SNS denominato "SampleTopic" nel. Console di gestione AWS Indica che il tracciamento AWS X-Ray attivo è abilitato per questo argomento, ma manca una politica delle risorse che consenta ad Amazon SNS di inviare dati di traccia. Viene fornito un pulsante «Crea policy» per risolvere questo problema.\]](http://docs.aws.amazon.com/it_it/sns/latest/dg/images/xray.png)
## Test del tracciamento attivo
1. Accedi alla [console Amazon SNS](https://console.aws.amazon.com/sns/home).
1. Creazione di un argomento Amazon SNS. Per informazioni dettagliate su come eseguire questa operazione, consulta [Per creare un argomento utilizzando il Console di gestione AWS](sns-create-topic.md#create-topic-aws-console).
1. Espandi **Active tracing** (Monitoraggio attivo) e scegli **Use active tracing** (Usa tracciamento attivo).
1. Pubblica un messaggio nel tuo argomento Amazon SNS. Per informazioni dettagliate su come eseguire questa operazione, consulta [Per pubblicare messaggi su argomenti di Amazon SNS utilizzando Console di gestione AWS](sns-publishing.md#sns-publishing-messages).
1. Utilizza la [mappa dei servizi X-Ray](https://docs.aws.amazon.com/xray/latest/devguide/xray-services-sns.html) per visualizzare le end-to-end tracce e le mappe dei servizi per l'argomento.
![\[Visualizza una mappa dei AWS X-Ray servizi che mostra la traccia di una richiesta proveniente da un client verso un argomento di Amazon SNS denominato "». xray-topic Da lì, il messaggio viene distribuito a vari servizi downstream, tra cui una coda Amazon SQS, una funzione Lambda, un Kinesis Firehose e un servizio remoto. Ogni connessione mostra parametri come la latenza in millisecondi (ms) e la velocità delle transazioni al minuto (t/min), aiutando ad analizzare le prestazioni e identificare eventuali problemi di latenza nel processo di consegna dei messaggi.\]](http://docs.aws.amazon.com/it_it/sns/latest/dg/images/xray-troubleshooting.png)