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à.
# Registrazione e monitoraggio in Amazon SNS
Amazon SNS ti consente di tracciare e monitorare l'attività di messaggistica registrando le chiamate API CloudTrail e monitorando gli argomenti con. CloudWatch Questi strumenti ti aiutano a ottenere informazioni dettagliate sulla consegna dei messaggi, a risolvere i problemi e a garantire lo stato dei flussi di lavoro di messaggistica. Questo argomento comprende quanto segue:
+ [Registrazione delle chiamate API AWS SNS utilizzando AWS CloudTrail](logging-using-cloudtrail.md). Questa registrazione ti consente di tenere traccia delle azioni eseguite sugli argomenti di Amazon SNS, come la creazione di argomenti, la gestione delle sottoscrizioni e la pubblicazione dei messaggi. Analizzando CloudTrail i log, puoi identificare chi ha effettuato richieste API specifiche e quando sono state effettuate, aiutandoti a controllare e risolvere i problemi dell'utilizzo di Amazon SNS.
+ [Monitoraggio degli argomenti di Amazon SNS tramite CloudWatch](sns-monitoring-using-cloudwatch.md). CloudWatch fornisce metriche che consentono di osservare le prestazioni e lo stato degli argomenti di Amazon SNS in tempo reale. Imposta allarmi in base a questi parametri, in modo da rispondere tempestivamente a eventuali anomalie, come errori di consegna o latenza elevata dei messaggi. Questa funzionalità di monitoraggio garantisce la possibilità di mantenere l'affidabilità del sistema di messaggistica basato su SNS risolvendo in modo proattivo i potenziali problemi.
# Registrazione delle chiamate API AWS SNS utilizzando AWS CloudTrail
AWS SNS è integrato con [AWS CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-user-guide.html), un servizio che fornisce un registro delle azioni intraprese da un utente, ruolo o un. Servizio AWS CloudTrail acquisisce tutte le chiamate API per SNS come eventi. Le chiamate acquisite includono chiamate dalla console SNS e chiamate di codice alle operazioni dell'API SNS. Utilizzando le informazioni raccolte da CloudTrail, è possibile determinare la richiesta effettuata a SNS, l'indirizzo IP da cui è stata effettuata, quando è stata effettuata e ulteriori dettagli.
Ogni evento o voce di log contiene informazioni sull’utente che ha generato la richiesta. Le informazioni di identità consentono di determinare quanto segue:
+ Se la richiesta è stata effettuata con le credenziali utente root o utente.
+ Se la richiesta è stata effettuata per conto di un utente del Centro identità IAM.
+ Se la richiesta è stata effettuata con le credenziali di sicurezza temporanee per un ruolo o un utente federato.
+ Se la richiesta è stata effettuata da un altro Servizio AWS.
CloudTrail è attivo nel tuo account Account AWS quando crei l'account e hai automaticamente accesso alla **cronologia degli CloudTrail eventi**. La **cronologia CloudTrail degli eventi** fornisce un record visualizzabile, ricercabile, scaricabile e immutabile degli ultimi 90 giorni di eventi di gestione registrati in un. Regione AWS*Per ulteriori informazioni, consulta [Lavorare con la cronologia degli CloudTrail eventi](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html) nella Guida per l'utente.AWS CloudTrail * Non sono CloudTrail previsti costi per la visualizzazione della **cronologia degli eventi**.
Per un registro continuo degli eventi degli Account AWS ultimi 90 giorni, crea un trail o un data store di eventi [CloudTrailLake](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake.html).
**CloudTrail sentieri**
Un *trail* consente di CloudTrail inviare file di log a un bucket Amazon S3. Tutti i percorsi creati utilizzando il Console di gestione AWS sono multiregionali. È possibile creare un trail per una singola Regione o per più Regioni tramite AWS CLI. La creazione di un percorso multiregionale è consigliata in quanto consente di registrare l'intera attività del proprio Regioni AWS account. Se si crea un trail per una singola Regione, è possibile visualizzare solo gli eventi registrati nella Regione AWS del trail. Per ulteriori informazioni sui trail, consulta [Creating a trail for your Account AWS](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html) e [Creating a trail for an organization](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/creating-trail-organization.html) nella *Guida per l'utente di AWS CloudTrail *.
Puoi inviare gratuitamente una copia dei tuoi eventi di gestione in corso al tuo bucket Amazon S3 CloudTrail creando un percorso, tuttavia ci sono costi di storage di Amazon S3. [Per ulteriori informazioni sui CloudTrail prezzi, consulta la pagina Prezzi.AWS CloudTrail](https://aws.amazon.com/cloudtrail/pricing/) Per informazioni sui prezzi di Amazon S3, consulta [Prezzi di Amazon S3](https://aws.amazon.com/s3/pricing/).
**CloudTrail Archivi di dati sugli eventi di Lake**
*CloudTrail Lake* ti consente di eseguire query basate su SQL sui tuoi eventi. CloudTrail [Lake converte gli eventi esistenti in formato JSON basato su righe in formato Apache ORC.](https://orc.apache.org/) ORC è un formato di archiviazione a colonne ottimizzato per il recupero rapido dei dati. Gli eventi vengono aggregati in *archivi di dati degli eventi*, che sono raccolte di eventi immutabili basate sui criteri selezionati applicando i [selettori di eventi avanzati](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake-concepts.html#adv-event-selectors). I selettori applicati a un archivio di dati degli eventi controllano quali eventi persistono e sono disponibili per l'esecuzione della query. *Per ulteriori informazioni su CloudTrail Lake, consulta [Working with AWS CloudTrail Lake](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake.html) nella Guida per l'utente.AWS CloudTrail *
CloudTrail Gli archivi e le richieste di dati sugli eventi di Lake comportano dei costi. Quando crei un datastore di eventi, scegli l'[opzione di prezzo](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake-manage-costs.html#cloudtrail-lake-manage-costs-pricing-option) da utilizzare per tale datastore. L'opzione di prezzo determina il costo per l'importazione e l'archiviazione degli eventi, nonché il periodo di conservazione predefinito e quello massimo per il datastore di eventi. [Per ulteriori informazioni sui CloudTrail prezzi, consulta la sezione Prezzi.AWS CloudTrail](https://aws.amazon.com/cloudtrail/pricing/)
## Eventi relativi ai dati SNS in CloudTrail
Gli [eventi di dati](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html#logging-data-events) forniscono informazioni sulle operazioni delle risorse eseguite su o in una risorsa (ad esempio, lettura o scrittura su un oggetto Amazon S3). Queste operazioni sono definite anche operazioni del piano dei dati. Gli eventi di dati sono spesso attività che interessano volumi elevati di dati. Per impostazione predefinita, CloudTrail non registra gli eventi relativi ai dati. La **cronologia CloudTrail degli eventi** non registra gli eventi relativi ai dati.
Per gli eventi di dati sono previsti costi aggiuntivi. Per ulteriori informazioni sui CloudTrail prezzi, consulta la sezione [AWS CloudTrail Prezzi](https://aws.amazon.com/cloudtrail/pricing/).
Puoi registrare gli eventi relativi ai dati per i tipi di risorse SNS utilizzando la CloudTrail console o AWS CLI le operazioni CloudTrail API. Per ulteriori informazioni su come registrare gli eventi relativi ai dati, consulta [Registrazione di eventi relativi ai dati con Console di gestione AWS](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html#logging-data-events-console) e [Registrazione di eventi di dati con AWS Command Line Interface](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html#creating-data-event-selectors-with-the-AWS-CLI) nella *Guida per l'utente AWS CloudTrail *.
La tabella seguente elenca i tipi di risorse SNS per i quali è possibile registrare gli eventi relativi ai dati. La colonna **Data event type (console)** mostra il valore da scegliere dall'elenco **Data event type** (console) sulla CloudTrail console. La colonna del **valore resources.type** mostra il `resources.type` valore, da specificare durante la configurazione dei selettori di eventi avanzati utilizzando o. AWS CLI CloudTrail APIs La CloudTrail colonna **Dati APIs registrati mostra le chiamate API registrate per** il tipo di risorsa. CloudTrail
| Tipo di evento di dati (console) | valore resources.type | Dati registrati APIs su CloudTrail |
| --- | --- | --- |
| Argomento SNS | [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sns-topic.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sns-topic.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/sns/latest/dg/logging-using-cloudtrail.html) |
| Endpoint della piattaforma SNS | AWS::SNS::PlatformEndpoint | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/sns/latest/dg/logging-using-cloudtrail.html) |
**Nota**
Il tipo di risorsa SNS non `AWS::SNS::PhoneNumber` è registrato da. CloudTrail
È possibile configurare selettori di eventi avanzati per filtrare i campi `eventName`, `readOnly` e `resources.ARN` per registrare solo gli eventi importanti per l'utente. Per ulteriori informazioni su questi campi, consulta [https://docs.aws.amazon.com/awscloudtrail/latest/APIReference/API_AdvancedFieldSelector.html](https://docs.aws.amazon.com/awscloudtrail/latest/APIReference/API_AdvancedFieldSelector.html) in *Riferimento API AWS CloudTrail *.
Per informazioni sulla registrazione degli eventi relativi ai dati, vedere Registrazione degli eventi relativi ai dati con Console di gestione AWS e Registrazione degli eventi relativi ai dati con the nella Guida per l' AWS CLI utente. CloudTrail
## Eventi di gestione SNS in CloudTrail
[Gli eventi di gestione](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-management-events-with-cloudtrail.html#logging-management-events) forniscono informazioni sulle operazioni di gestione eseguite sulle risorse presenti nell'ambiente Account AWS. Queste operazioni sono definite anche operazioni del piano di controllo (control-plane). Per impostazione predefinita, CloudTrail registra gli eventi di gestione.
AWS *SNS registra le seguenti operazioni del piano di controllo SNS come eventi di CloudTrail gestione.*
+ `[AddPermission](https://docs.aws.amazon.com/sns/latest/api/API_AddPermission.html)`
+ `[CheckIfPhoneNumberIsOptedOut](https://docs.aws.amazon.com/sns/latest/api/API_CheckIfPhoneNumberIsOptedOut.html)`
+ `[ConfirmSubscription](https://docs.aws.amazon.com/sns/latest/api/API_ConfirmSubscription.html)`
+ `[CreatePlatformApplication](https://docs.aws.amazon.com/sns/latest/api/API_CreatePlatformApplication.html)`
+ `[CreatePlatformEndpoint](https://docs.aws.amazon.com/sns/latest/api/API_CreatePlatformEndpoint.html)`
+ `[CreateSMSSandboxPhoneNumber](https://docs.aws.amazon.com/sns/latest/api/API_CreateSMSSandboxPhoneNumber.html)`
+ `[CreateTopic](https://docs.aws.amazon.com/sns/latest/api/API_CreateTopic.html)`
+ `[DeleteEndpoint](https://docs.aws.amazon.com/sns/latest/api/API_DeleteEndpoint.html)`
+ `[DeletePlatformApplication](https://docs.aws.amazon.com/sns/latest/api/API_DeletePlatformApplication.html)`
+ `[DeleteSMSSandboxPhoneNumber](https://docs.aws.amazon.com/sns/latest/api/API_DeleteSMSSandboxPhoneNumber.html)`
+ `[DeleteTopic](https://docs.aws.amazon.com/sns/latest/api/API_DeleteTopic.html)`
+ `[GetDataProtectionPolicy](https://docs.aws.amazon.com/sns/latest/api/API_GetDataProtectionPolicy.html)`
+ `[GetEndpointAttributes](https://docs.aws.amazon.com/sns/latest/api/API_GetEndpointAttributes.html)`
+ `[GetPlatformApplicationAttributes](https://docs.aws.amazon.com/sns/latest/api/API_GetPlatformApplicationAttributes.html)`
+ `[GetSMSAttributes](https://docs.aws.amazon.com/sns/latest/api/API_GetSMSAttributes.html)`
+ `[GetSMSSandboxAccountStatus](https://docs.aws.amazon.com/sns/latest/api/API_GetSMSSandboxAccountStatus.html)`
+ `[GetSubscriptionAttributes](https://docs.aws.amazon.com/sns/latest/api/API_GetSubscriptionAttributes.html)`
+ `[GetTopicAttributes](https://docs.aws.amazon.com/sns/latest/api/API_GetTopicAttributes.html)`
+ `[ListEndpointsByPlatformApplication](https://docs.aws.amazon.com/sns/latest/api/API_ListEndpointsByPlatformApplication.html)`
+ `[ListOriginationNumbers](https://docs.aws.amazon.com/sns/latest/api/API_ListOriginationNumbers.html)`
+ `[ListPhoneNumbersOptedOut](https://docs.aws.amazon.com/sns/latest/api/API_ListPhoneNumbersOptedOut.html)`
+ `[ListPlatformApplications](https://docs.aws.amazon.com/sns/latest/api/API_ListPlatformApplications.html)`
+ `[ListSMSSandboxPhoneNumbers](https://docs.aws.amazon.com/sns/latest/api/API_ListSMSSandboxPhoneNumbers.html)`
+ `[ListSubscriptions](https://docs.aws.amazon.com/sns/latest/api/API_ListSubscriptions.html)`
+ `[ListSubscriptionsByTopic](https://docs.aws.amazon.com/sns/latest/api/API_ListSubscriptionsByTopic.html)`
+ `[ListTagsForResource](https://docs.aws.amazon.com/sns/latest/api/API_ListTagsForResource.html)`
+ `[ListTopics](https://docs.aws.amazon.com/sns/latest/api/API_ListTopics.html)`
+ `[OptInPhoneNumber](https://docs.aws.amazon.com/sns/latest/api/API_OptInPhoneNumber.html)`
+ `[PutDataProtectionPolicy](https://docs.aws.amazon.com/sns/latest/api/API_PutDataProtectionPolicy.html)`
+ `[RemovePermission](https://docs.aws.amazon.com/sns/latest/api/API_RemovePermission.html)`
+ `[SetEndpointAttributes](https://docs.aws.amazon.com/sns/latest/api/API_SetEndpointAttributes.html)`
+ `[SetPlatformApplicationAttributes](https://docs.aws.amazon.com/sns/latest/api/API_SetPlatformApplicationAttributes.html)`
+ `[SetSMSAttributes](https://docs.aws.amazon.com/sns/latest/api/API_SetSMSAttributes.html)`
+ `[SetSubscriptionAttributes](https://docs.aws.amazon.com/sns/latest/api/API_SetSubscriptionAttributes.html)`
+ `[SetTopicAttributes](https://docs.aws.amazon.com/sns/latest/api/API_SetTopicAttributes.html)`
+ `[Subscribe](https://docs.aws.amazon.com/sns/latest/api/API_Subscribe.html)`
+ `[TagResource](https://docs.aws.amazon.com/sns/latest/api/API_TagResource.html)`
+ `[Unsubscribe](https://docs.aws.amazon.com/sns/latest/api/API_Unsubscribe.html)`
+ `[UntagResource](https://docs.aws.amazon.com/sns/latest/api/API_UntagResource.html)`
+ `[VerifySMSSandboxPhoneNumber](https://docs.aws.amazon.com/sns/latest/api/API_VerifySMSSandboxPhoneNumber.html)`
**Nota**
Se non hai effettuato l'accesso ad Amazon Web Services (modalità non autenticata) e vengono richiamate [https://docs.aws.amazon.com/sns/latest/api/API_Unsubscribe.html](https://docs.aws.amazon.com/sns/latest/api/API_Unsubscribe.html)le azioni [https://docs.aws.amazon.com/sns/latest/api/API_ConfirmSubscription.html](https://docs.aws.amazon.com/sns/latest/api/API_ConfirmSubscription.html)o, queste non verranno registrate. CloudTrail Ad esempio, quando scegli il collegamento fornito in una notifica e-mail per confermare una sottoscrizione in sospeso a un argomento, l'operazione `ConfirmSubscription` viene richiamata in modalità non autenticata. In questo esempio, l'`ConfirmSubscription`azione non verrebbe registrata. CloudTrail
## Esempi di eventi SNS
Un evento rappresenta una singola richiesta proveniente da qualsiasi fonte e include informazioni sull'operazione API richiesta, la data e l'ora dell'operazione, i parametri della richiesta e così via. CloudTrail i file di registro non sono una traccia ordinata dello stack delle chiamate API pubbliche, quindi gli eventi non vengono visualizzati in un ordine specifico.
L'esempio seguente mostra un CloudTrail evento che dimostra le azioni **`ListTopics`**`CreateTopic`, e`DeleteTopic`.
```
{
"Records": [
{
"eventVersion": "1.02",
"userIdentity": {
"type": "IAMUser",
"userName": "Bob",
"principalId": "EX_PRINCIPAL_ID",
"arn": "arn:aws:iam::123456789012:user/Bob",
"accountId": "123456789012",
"accessKeyId": "AKIAIOSFODNN7EXAMPLE"
},
"eventTime": "2014-09-30T00:00:00Z",
"eventSource": "sns.amazonaws.com",
"eventName": "ListTopics",
"awsRegion": "us-west-2",
"sourceIPAddress": "127.0.0.1",
"userAgent": "aws-sdk-java/unknown-version",
"requestParameters": {
"nextToken": "ABCDEF1234567890EXAMPLE=="
},
"responseElements": null,
"requestID": "example1-b9bb-50fa-abdb-80f274981d60",
"eventID": "example0-09a3-47d6-a810-c5f9fd2534fe",
"eventType": "AwsApiCall",
"recipientAccountId": "123456789012"
},
{
"eventVersion": "1.02",
"userIdentity": {
"type": "IAMUser",
"userName": "Bob",
"principalId": "EX_PRINCIPAL_ID",
"arn": "arn:aws:iam::123456789012:user/Bob",
"accountId": "123456789012",
"accessKeyId": "AKIAIOSFODNN7EXAMPLE"
},
"eventTime": "2014-09-30T00:00:00Z",
"eventSource": "sns.amazonaws.com",
"eventName": "CreateTopic",
"awsRegion": "us-west-2",
"sourceIPAddress": "127.0.0.1",
"userAgent": "aws-sdk-java/unknown-version",
"requestParameters": {
"name": "hello"
},
"responseElements": {
"topicArn": "arn:aws:sns:us-west-2:123456789012:hello-topic"
},
"requestID": "example7-5cd3-5323-8a00-f1889011fee9",
"eventID": "examplec-4f2f-4625-8378-130ac89660b1",
"eventType": "AwsApiCall",
"recipientAccountId": "123456789012"
},
{
"eventVersion": "1.02",
"userIdentity": {
"type": "IAMUser",
"userName": "Bob",
"principalId": "EX_PRINCIPAL_ID",
"arn": "arn:aws:iam::123456789012:user/Bob",
"accountId": "123456789012",
"accessKeyId": "AKIAIOSFODNN7EXAMPLE"
},
"eventTime": "2014-09-30T00:00:00Z",
"eventSource": "sns.amazonaws.com",
"eventName": "DeleteTopic",
"awsRegion": "us-west-2",
"sourceIPAddress": "127.0.0.1",
"userAgent": "aws-sdk-java/unknown-version",
"requestParameters": {
"topicArn": "arn:aws:sns:us-west-2:123456789012:hello-topic"
},
"responseElements": null,
"requestID": "example5-4faa-51d5-aab2-803a8294388d",
"eventID": "example8-6443-4b4d-abfd-1b867280d964",
"eventType": "AwsApiCall",
"recipientAccountId": "123456789012"
}
]
}
```
L'esempio seguente mostra un CloudTrail evento che dimostra l'`Publish`azione.
```
{
"eventVersion": "1.09",
"userIdentity": {
"type": "AssumedRole",
"principalId": "EX_PRINCIPAL_ID",
"arn": "arn:aws:iam::123456789012:user/Bob",
"accountId": "123456789012",
"accessKeyId": "AKIAIOSFODNN7EXAMPLE",
"sessionContext": {
"sessionIssuer": {
"type": "Role",
"principalId": "AKIAIOSFODNN7EXAMPLE",
"arn": "arn:aws:iam::123456789012:role/Admin",
"accountId": "123456789012",
"userName": "ExampleUser"
},
"attributes": {
"creationDate": "2023-08-21T16:44:05Z",
"mfaAuthenticated": "false"
}
}
},
"eventTime": "2023-08-21T16:48:37Z",
"eventSource": "sns.amazonaws.com",
"eventName": "Publish",
"awsRegion": "us-east-1",
"sourceIPAddress": "192.0.2.0",
"userAgent": "aws-cli/1.29.16 md/Botocore#1.31.16 ua/2.0 os/linux#5.4.250-173.369.amzn2int.x86_64 md/arch#x86_64 lang/python#3.8.17 md/pyimpl#CPython cfg/retry-mode#legacy botocore/1.31.16",
"requestParameters": {
"topicArn": "arn:aws:sns:us-east-1:123456789012:ExampleSNSTopic",
"message": "HIDDEN_DUE_TO_SECURITY_REASONS",
"subject": "HIDDEN_DUE_TO_SECURITY_REASONS",
"messageStructure": "json",
"messageAttributes": "HIDDEN_DUE_TO_SECURITY_REASONS"
},
"responseElements": {
"messageId": "0787cd1e-d92b-521c-a8b4-90434e8ef840"
},
"requestID": "0a8ab208-11bf-5e01-bd2d-ef55861b545d",
"eventID": "bb3496d4-5252-4660-9c28-3c6aebdb21c0",
"readOnly": false,
"resources": [
{
"accountId": "123456789012",
"type": "AWS::SNS::Topic",
"ARN": "arn:aws:sns:us-east-1:123456789012:ExampleSNSTopic"
}
],
"eventType": "AwsApiCall",
"managementEvent": false,
"recipientAccountId": "123456789012",
"eventCategory": "Data",
"tlsDetails": {
"tlsVersion": "TLSv1.2",
"cipherSuite": "ECDHE-RSA-AES128-GCM-SHA256",
"clientProvidedHostHeader": "sns.us-east-1.amazonaws.com"
}
}
```
L'esempio seguente mostra un CloudTrail evento che dimostra l'`PublishBatch`azione.
```
{
"eventVersion": "1.09",
"userIdentity": {
"type": "AssumedRole",
"principalId": "EX_PRINCIPAL_ID",
"arn": "arn:aws:iam::123456789012:user/Bob",
"accountId": "123456789012",
"accessKeyId": "AKIAIOSFODNN7EXAMPLE",
"sessionContext": {
"sessionIssuer": {
"type": "Role",
"principalId": "AKIAIOSFODNN7EXAMPLE",
"arn": "arn:aws:iam::123456789012:role/Admin",
"accountId": "123456789012",
"userName": "ExampleUser"
},
"attributes": {
"creationDate": "2023-08-21T19:20:49Z",
"mfaAuthenticated": "false"
}
}
},
"eventTime": "2023-08-21T19:22:01Z",
"eventSource": "sns.amazonaws.com",
"eventName": "PublishBatch",
"awsRegion": "us-east-1",
"sourceIPAddress": "192.0.2.0",
"userAgent": "aws-cli/1.29.16 md/Botocore#1.31.16 ua/2.0 os/linux#5.4.250-173.369.amzn2int.x86_64 md/arch#x86_64 lang/python#3.8.17 md/pyimpl#CPython cfg/retry-mode#legacy botocore/1.31.16",
"requestParameters": {
"topicArn": "arn:aws:sns:us-east-1:123456789012:ExampleSNSTopic",
"publishBatchRequestEntries": [
{
"id": "1",
"message": "HIDDEN_DUE_TO_SECURITY_REASONS"
},
{
"id": "2",
"message": "HIDDEN_DUE_TO_SECURITY_REASONS"
}
]
},
"responseElements": {
"successful": [
{
"id": "1",
"messageId": "30d68101-a64a-5573-9e10-dc5c1dd3af2f"
},
{
"id": "2",
"messageId": "c0aa0c5c-561d-5455-b6c4-5101ed84de09"
}
],
"failed": []
},
"requestID": "e2cdf7f3-1b35-58ad-ac9e-aaaea0ace2f1",
"eventID": "10da9a14-0154-4ab6-b3a5-1825b229a7ed",
"readOnly": false,
"resources": [
{
"accountId": "123456789012",
"type": "AWS::SNS::Topic",
"ARN": "arn:aws:sns:us-east-1:123456789012:ExampleSNSTopic"
}
],
"eventType": "AwsApiCall",
"managementEvent": false,
"recipientAccountId": "123456789012",
"eventCategory": "Data",
"tlsDetails": {
"tlsVersion": "TLSv1.2",
"cipherSuite": "ECDHE-RSA-AES128-GCM-SHA256",
"clientProvidedHostHeader": "sns.us-east-1.amazonaws.com"
}
}
```
Per informazioni sul contenuto dei CloudTrail record, consultate il [contenuto dei CloudTrail record](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-record-contents.html) nella *Guida per l'AWS CloudTrail utente*.
# Monitoraggio degli argomenti di Amazon SNS tramite CloudWatch
Amazon SNS e Amazon CloudWatch sono integrati in modo da poter raccogliere, visualizzare e analizzare i parametri per ogni notifica Amazon SNS attiva. Dopo aver configurato CloudWatch Amazon SNS, puoi ottenere informazioni più dettagliate sulle prestazioni degli argomenti di Amazon SNS, delle notifiche push e delle consegne di SMS. Ad esempio, puoi impostare un allarme per ricevere una notifica tramite e-mail se una soglia specificata viene raggiunta per un parametro Amazon SNS come `NumberOfNotificationsFailed`. Per un elenco di tutte le metriche CloudWatch inviate da Amazon SNS, consulta. [Parametri di Amazon SNS](#sns-metrics) Per ulteriori informazioni sulle notifiche push Amazon SNS, consulta [Invio di notifiche push per dispositivi mobili con Amazon SNS](sns-mobile-application-as-subscriber.md).
**Nota**
*Le metriche con cui configuri CloudWatch gli argomenti di Amazon SNS vengono raccolte automaticamente e inserite CloudWatch a intervalli di 1 minuto.* Queste metriche sono raccolte su tutti gli argomenti che soddisfano le linee guida per essere attivi. CloudWatch Un argomento è considerato attivo CloudWatch per un massimo di sei ore dall'ultima attività (ovvero qualsiasi chiamata API) sull'argomento.
I parametri di Amazon SNS riportati in sono gratuiti CloudWatch; vengono forniti come parte del servizio Amazon SNS.
## Visualizza i CloudWatch parametri per Amazon SNS
Puoi monitorare i parametri per Amazon SNS utilizzando CloudWatch la console CloudWatch, l'interfaccia a riga di comando (CLI) propria o utilizzando l'API a livello di codice. CloudWatch Le procedure seguenti mostrano come accedere ai parametri mediante la Console di gestione AWS.
**Per visualizzare le metriche utilizzando la console CloudWatch**
1. Accedi alla [console CloudWatch](https://console.aws.amazon.com/cloudwatch).
1. Nel pannello di navigazione, scegli **Metrics** (Parametri).
1. Nella scheda **All metrics (Tutti i parametri)** scegliere **SNS**, quindi scegliere una delle seguenti dimensioni:
+ **Country, SMS Type (Paese, tipo SMS)**
+ **PhoneNumber**
+ **Topic Metrics (Parametri argomento)**
+ **Metrics with no dimensions (Parametri senza dimensioni)**
1. Per visualizzare ulteriori dettagli, scegli un elemento specifico. Ad esempio, se scegli **Topic Metrics** e poi scegli **NumberOfMessagesPublished**, viene visualizzato il numero medio di messaggi Amazon SNS pubblicati per un periodo di 1 minuto nell'intervallo di tempo di 6 ore.
1. Per visualizzare i parametri di utilizzo di Amazon SNS, nella scheda **All metrics** (Tutti i parametri), scegli **Usage** (Utilizzo) e seleziona il **parametro di utilizzo di Amazon SNS target** (ad esempio, `NumberOfMessagesPublishedPerAccount`).
## Imposta CloudWatch allarmi per i parametri di Amazon SNS
CloudWatch consente inoltre di impostare allarmi quando viene raggiunta una soglia per una metrica. Ad esempio, è possibile impostare un allarme per la metrica **NumberOfNotificationsFailed**, in modo che quando il numero di soglia specificato viene raggiunto entro il periodo di campionamento, venga inviata una notifica via e-mail per informarti dell'evento.
**Per impostare allarmi utilizzando la console CloudWatch**
1. Accedi a Console di gestione AWS e apri la CloudWatch console all'indirizzo [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. Seleziona **Alarms (Allarmi)**, quindi scegli il pulsante **Create Alarm (Crea allarme)**. Viene avviata la procedura guidata per la **creazione di allarmi**.
1. Scorri i parametri Amazon SNS per individuare quello per cui vuoi impostare un allarme. Seleziona il parametro per il quale vuoi creare un allarme e scegli **Continue (Continua)**.
1. Indica i valori **Name (Nome)**, **Description (Descrizione)**, **Threshold (Soglia)** e **Time (Ora)** per il parametro e scegli **Continue (Continua)**.
1. Scegli **Alarm (Allarme)** come stato dell'allarme. Se desideri CloudWatch inviarti un'e-mail quando viene raggiunto lo stato di allarme, scegli un argomento Amazon SNS esistente o scegli **Crea nuovo argomento e-mail**. Se scegli **Create New Email Topic (Crea nuovo argomento e-mail)**, puoi impostare il nome e gli indirizzi e-mail per un nuovo argomento. Questo elenco viene salvato ed è visualizzato nella casella di riepilogo a discesa per gli allarmi futuri. Scegli **Continue (Continua)**.
**Nota**
Se utilizzi **Create New Email Topic (Crea nuovo argomento e-mail)** per creare un nuovo argomento Amazon SNS, gli indirizzi e-mail devono essere verificati prima di ricevere le notifiche. Le e-mail sono inviate solo quando l'allarme passa allo stato definito. Se lo stato cambia prima della verifica degli indirizzi e-mail, questi non riceveranno una notifica.
1. A questo punto, la procedura guidata per la **creazione di allarmi** ti consente di esaminare l'allarme che stai per creare. Se devi apportare delle modifiche, puoi utilizzare i collegamenti **Edit** (Modifica) a destra. Al termine, scegli **Create Alarm (Crea allarme)**.
[Per ulteriori informazioni sull'utilizzo CloudWatch e sugli allarmi, consulta la CloudWatch documentazione.](https://aws.amazon.com/documentation/cloudwatch)
## Parametri di Amazon SNS
Amazon SNS invia le seguenti metriche a. CloudWatch
| Namespace | Metrica | Description |
| --- | --- | --- |
| AWS/SNS | NumberOfMessagesPublished | Il numero di messaggi pubblicati ai tuoi argomenti Amazon SNS. **Unità:** numero **Dimensioni valide:** applicazione PhoneNumber, piattaforma e TopicName **Statistiche valide:** somma |
| AWS/SNS | NumberOfNotificationsDelivered | Il numero di messaggi consegnati con successo dai tuoi argomenti Amazon SNS agli endpoint sottoscritti. Affinché un tentativo di invio abbia successo, la sottoscrizione dell'endpoint deve accettare il messaggio. Una sottoscrizione accetta un messaggio se a.) manca di un criterio di filtro o b.) i criteri di filtro includono attributi che corrispondono a quelli assegnati al messaggio. Se la sottoscrizione rifiuta il messaggio, il tentativo di invio non viene conteggiato per questo parametro. **Unità:** numero **Dimensioni valide:** applicazione PhoneNumber, piattaforma e TopicName **Statistiche valide:** somma |
| AWS/SNS | NumberOfNotificationsFailed | Il numero di messaggi non consegnati da Amazon SNS. Per Amazon SQS, e-mail, SMS o endpoint push mobili, il parametro aumenta di 1 quando Amazon SNS interrompe i tentativi di consegna dei messaggi. Per gli endpoint HTTP o HTTPS, il parametro include ogni tentativo di invio non riuscito, inclusi i nuovi tentativi che seguono il tentativo iniziale. Per tutti gli altri endpoint, il numero aumenta di 1 quando il messaggio non viene distribuito (indipendentemente dal numero di tentativi). Questo parametro non include i messaggi rifiutati da policy di filtro di sottoscrizione. Puoi controllare il numero di nuovi tentativi per gli endpoint HTTP. Per ulteriori informazioni, consulta [Tentativi di consegna dei messaggi di Amazon SNS](sns-message-delivery-retries.md). **Unità:** numero **Dimensioni valide:** applicazione PhoneNumber, piattaforma e TopicName **Statistiche valide:** somma, media |
| AWS/SNS | NumberOfNotificationsFilteredOut | Il numero di messaggi rifiutati da policy di filtro di sottoscrizione. Una policy di filtro rifiuta un messaggio quando gli attributi del messaggio non corrispondono agli attributi della policy. **Unità:** numero **Dimensioni valide:** applicazione PhoneNumber, piattaforma e TopicName **Statistiche valide:** somma, media |
| AWS/SNS | NumberOfNotificationsFilteredOut-MessageAttributes | Il numero di messaggi rifiutati dalle policy di filtro delle sottoscrizioni per il filtro basato su attributi. **Unità:** numero **Dimensioni valide:** applicazione PhoneNumber, piattaforma e TopicName **Statistiche valide:** somma, media |
| AWS/SNS | NumberOfNotificationsFilteredOut-MessageBody | Il numero di messaggi rifiutati dalle policy di filtro delle sottoscrizioni per il filtro basato sul payload. **Unità:** numero **Dimensioni valide:** applicazione PhoneNumber, piattaforma e TopicName **Statistiche valide:** somma, media |
| AWS/SNS | NumberOfNotificationsFilteredOut-InvalidAttributes | Il numero di messaggi rifiutati dalle policy di filtro di sottoscrizione perché gli attributi dei messaggi non sono validi - ad esempio perché l'attributo JSON non è formattato correttamente. **Unità:** numero **Dimensioni valide:** applicazione PhoneNumber, piattaforma e TopicName **Statistiche valide:** somma, media |
| AWS/SNS | NumberOfNotificationsFilteredOut-NoMessageAttributes | Il numero di messaggi che sono stati rifiutati da policy di filtro di sottoscrizione perché i messaggi non hanno attributi. **Unità:** numero **Dimensioni valide:** applicazione PhoneNumber, piattaforma e TopicName **Statistiche valide:** somma, media |
| AWS/SNS | NumberOfNotificationsFilteredOut-InvalidMessageBody | Il numero di messaggi rifiutati dalle policy di filtro delle sottoscrizioni perché il corpo del messaggio non è valido per il filtro (ad esempio, corpo del messaggio JSON non valido). **Unità:** numero **Dimensioni valide:** applicazione PhoneNumber, piattaforma e TopicName **Statistiche valide:** somma, media |
| AWS/SNS | NumberOfNotificationsRedrivenToDlq | Numero di messaggi che sono stati spostati in una coda dead-letter. **Unità:** numero **Dimensioni valide:** applicazione PhoneNumber, piattaforma e TopicName **Statistiche valide:** somma, media |
| AWS/SNS | NumberOfNotificationsFailedToRedriveToDlq | Numero di messaggi che non possono essere spostati in una coda dead-letter. **Unità:** numero **Dimensioni valide:** applicazione PhoneNumber, piattaforma e TopicName **Statistiche valide:** somma, media |
| AWS/SNS | PublishSize | Dimensione dei messaggi pubblicati. **Unità:** byte **Dimensioni valide:** applicazione PhoneNumber, piattaforma e TopicName **Statistiche valide:** minimo, massimo, medio e conteggio |
| AWS/SNS | SMSMonthToDateSpentUSD | I costi che hai cumulato dall'inizio del mese di calendario corrente per l'invio di SMS. Puoi impostare un allarme per questa metrica per sapere quando i tuoi month-to-date addebiti si avvicinano alla quota di spesa mensile per SMS del tuo account. Quando Amazon SNS determina che l'invio di un SMS comporterebbe un costo superiore a tale limite, interrompe la pubblicazione di SMS nel giro di alcuni minuti. Per informazioni sull'impostazione del limite di spesa SMS mensile o sulla richiesta di aumento del limite di spesa con AWS, consulta [Impostazione delle preferenze di messaggistica SMS in Amazon SNS](sms_preferences.md). **Unità: USD** **Dimensioni valide:** nessuna **Statistiche valide:** somma |
| AWS/SNS | SMSSuccessRate | Il tasso di consegne SMS riuscite. **Unità:** numero **Dimensioni valide:** PhoneNumber **Statistiche valide:** somma, media, campioni di dati |
## Dimensioni per i parametri Amazon SNS
Amazon Simple Notification Service invia le seguenti dimensioni a CloudWatch.
| Dimensione | Description |
| --- | --- |
| Application | Filtri sugli oggetti dell'applicazione, che rappresentano un'app e un dispositivo registrati con uno dei servizi di notifica push supportati, ad APNs esempio FCM. |
| Application,Platform | Filtri sugli oggetti dell'applicazione e della piattaforma, dove gli oggetti della piattaforma sono per i servizi di notifica push supportati, come APNs FCM. |
| Country | Filtra in base al paese o alla regione di destinazione di un SMS. Il paese o la regione è rappresentato dal relativo codice ISO 3166-1 alpha-2. |
| PhoneNumber | Filtra il numero di telefono quando pubblichi SMS direttamente su un numero di telefono (senza argomento). |
| Platform | Filtri sugli oggetti della piattaforma per i servizi di notifica push, come APNs FCM. |
| TopicName | Filtra in base ai nomi di argomenti Amazon SNS. |
| SMSType | Filtra in base al tipo di SMS. Può essere *promozionale* o *transazionale*. |
## Parametri di utilizzo di Amazon SNS
Amazon Simple Notification Service invia i seguenti parametri di utilizzo a CloudWatch.
| Namespace | Servizio | Metrica | Risorsa | Tipo | Description |
| --- | --- | --- | --- | --- | --- |
| AWS/Usage | SNS | ResourceCount | NumberOfMessagesPublishedPerAccount | Risorsa | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/sns/latest/dg/sns-monitoring-using-cloudwatch.html) |
| AWS/Usage | SNS | ResourceCount | ApproximateNumberOfTopics | Risorsa | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/sns/latest/dg/sns-monitoring-using-cloudwatch.html) |
| AWS/Usage | SNS | ResourceCount | ApproximateNumberOfFilterPolicies | Risorsa | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/sns/latest/dg/sns-monitoring-using-cloudwatch.html) |
| AWS/Usage | SNS | ResourceCount | ApproximateNumberOfPendingSubscriptions | Risorsa | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/sns/latest/dg/sns-monitoring-using-cloudwatch.html) |
| AWS/Usage | SNS | CallCount | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/sns/latest/dg/sns-monitoring-using-cloudwatch.html) | "Hello, World\$1" | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/sns/latest/dg/sns-monitoring-using-cloudwatch.html) |