

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à.

# AWS integrazione per Amazon Location Service
<a name="integration"></a>

Amazon Location Service è integrato con vari AWS servizi per l'autenticazione, il monitoraggio, la gestione e lo sviluppo efficienti.

**Monitoraggio**  
+ **Amazon CloudWatch**: visualizza i parametri sull'utilizzo e lo stato del servizio, tra cui richieste, latenza, errori e log. Per ulteriori informazioni, consulta [Monitora con Amazon CloudWatch](cloudwatch.md).
+ **AWS CloudTrail**— Registra e monitora le tue chiamate API, che includono le azioni intraprese da un utente, un ruolo o un servizio. AWS Per ulteriori informazioni, consulta [Monitora e accedi con AWS CloudTrail](cloudtrail.md).

**Manage (Gestione)**  
+ **AWS CloudFormation**— Amazon Location è integrato con AWS CloudFormation, un servizio che ti aiuta a modellare e configurare AWS le tue risorse in modo da poter dedicare meno tempo alla creazione e alla gestione delle risorse e dell'infrastruttura. Per ulteriori informazioni, consulta [Crea risorse con AWS CloudFormation](cloudformation.md).
+ **Service Quotas**: utilizza la console Service Quotas per richiedere modifiche AWS CLI alle quote regolabili. Per ulteriori informazioni, consulta [Gestisci le quote con Service Quotas](manage-quotas.md).
+ **Tag**: utilizza l'etichettatura delle risorse in Amazon Location per creare tag per classificare le risorse in base a scopo, proprietario, ambiente o criteri. L'etichettatura delle risorse ti aiuta a gestire, identificare, organizzare, cercare e filtrare le tue risorse. Per ulteriori informazioni, consulta [Gestisci le risorse con i tag](manage-resources.md).

**Autenticazione**  
+ **Amazon Cognito**: puoi utilizzare l'autenticazione Amazon Cognito come alternativa all' AWS Identity and Access Management utilizzo diretto (IAM) con richieste HTTPS SDKs frontend e dirette. Per ulteriori informazioni, consulta [Usa Amazon Cognito per l'autenticazione](authenticating-using-cognito.md).
+ **IAM** — AWS Identity and Access Management (IAM) è un AWS servizio che aiuta un amministratore a controllare in modo sicuro l'accesso alle risorse. AWS Gli amministratori IAM controllano chi può essere autenticato (effettuato l'accesso) e autorizzato (disporre delle autorizzazioni) a utilizzare le risorse di Amazon Location Service. Per ulteriori informazioni, consulta [Usa AWS Identity and Access Management per autenticare](security-iam.md).

**Valore aggiunto**  
+ **Amazon EventBridge**: abilita un'architettura applicativa basata sugli eventi in modo da poter utilizzare AWS Lambda le funzioni per attivare altre parti dell'applicazione e dei flussi di lavoro. Per ulteriori informazioni, consulta [Reagisci agli eventi di Amazon Location Service con Amazon EventBridge](location-events.md).
+ **AWS IoT**— Il motore AWS IoT Core delle regole memorizza le domande sugli argomenti dei messaggi dei tuoi dispositivi e ti consente di definire azioni per l'invio di messaggi ad altri AWS servizi, come Amazon Location Service. I dispositivi che conoscono la propria posizione come coordinate possono far sì che le proprie posizioni vengano inoltrate ad Amazon Location tramite il motore delle regole. Per ulteriori informazioni, consulta [Monitora l'utilizzo AWS IoT e l'MQTT con Amazon Location Service](tracking-using-mqtt.md).

**Strumento per sviluppatori**  
+ **SDKs**— Amazon Location Service offre agli sviluppatori una varietà di strumenti per creare applicazioni abilitate alla localizzazione. Questi includono lo standard AWS SDKs, il mobile e il web. SDKs Per ulteriori informazioni, consulta [SDKs e framework per Amazon Location Service](dev-sdks.md).
+ **AWS CLI**— The AWS Command Line Interface (AWS CLI) è uno strumento open source che consente di interagire con i AWS servizi utilizzando i comandi nella shell della riga di comando. Con una configurazione minima. Per ulteriori informazioni, consulta [AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/reference/location/)o scopri di più su [AWS CLI](https://docs.aws.amazon.com/cli/).
+ **Codice di esempio**: utilizza un codice di esempio AWS SDKs, per dispositivi mobili e web SDKs, MapLibre per dimostrare come utilizzare Amazon Location. Per ulteriori informazioni, consulta gli [esempi](https://location.aws.com/samples).
+ **Console Amazon Location Service**: utilizza la console Amazon Location per conoscere informazioni APIs, risorse e iniziare a usare uno strumento di apprendimento visivo e interattivo. Per ulteriori informazioni, consulta la [console Amazon Location Service](https://console.aws.amazon.com/location/explore/home).

**Costo e fatturazione**  
+ **AWS Billing and Cost** Management: il servizio fornisce assistenza per pagare le bollette e ottimizzare i costi. Amazon Web Services fattura l'utilizzo sul tuo account, assicurandoti di pagare solo per quello che usi. Per ulteriori informazioni, consulta [Modello tariffario](pricing.md) o [Gestisci la fatturazione e i costi con AWS Billing and Cost Management](manage-billing.md).

# Gestione delle risorse
<a name="resource-management"></a>

La gestione delle risorse fornisce strumenti e processi per gestire le quote, organizzare le risorse con tag, controllare i costi e automatizzare la creazione di risorse utilizzando. AWS CloudFormation Queste funzionalità ti consentono di allocare, monitorare e gestire in modo efficiente le tue risorse all'interno di Amazon Location.

Utilizza questi strumenti per mantenere l'efficienza operativa impostando limiti di servizio, etichettando le risorse per una migliore organizzazione, monitorando le spese e utilizzando l'infrastruttura come codice per creare e gestire le risorse CloudFormation in modo programmatico.

**Topics**
+ [Gestisci le quote con Service Quotas](manage-quotas.md)
+ [Gestisci le risorse con i tag](manage-resources.md)
+ [Gestisci la fatturazione e i costi con AWS Billing and Cost Management](manage-billing.md)
+ [Crea risorse con AWS CloudFormation](cloudformation.md)

# Gestisci le quote con Service Quotas
<a name="manage-quotas"></a>

La console Service Quotas consente di [richiedere aumenti o riduzioni delle quote per le quote](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas) regolabili. Le quote di servizio sono il numero massimo di chiamate o risorse API che puoi avere per AWS account e regione. AWS Quando richiedi un aumento della quota, seleziona la regione in cui desideri aumentare la quota poiché la maggior parte delle quote è specifica della regione. Amazon Location Service rifiuta le richieste aggiuntive che superano la quota di servizio.

 I limiti di velocità (quote che iniziano con Rate of...) sono il numero massimo di richieste al secondo, con una frequenza di burst dell'80% del limite in qualsiasi parte del secondo, definita per ogni operazione API. Le operazioni con limiti di velocità aumentati per un account tramite Service Quotas possono avere una frequenza di burst inferiore all'80% del limite di velocità aumentato. Amazon Location Service limita le richieste che superano il limite di velocità dell'operazione. 

## Gestione delle quote del servizio Amazon Location
<a name="manage-quotas_how"></a>

 Amazon Location Service è integrato con Service Quotas, un AWS servizio che ti consente di visualizzare e gestire le tue quote da una posizione centrale. Per ulteriori informazioni, consulta [What Is Service Quotas](https://docs.aws.amazon.com/servicequotas/latest/userguide/intro.html)? nella Guida per l'*utente di Service Quotas*.

 Service Quotas semplifica la ricerca del valore delle quote del servizio Amazon Location. 

------
#### [ Console di gestione AWS ]

1. Apri la [console Service Quotas](https://console.aws.amazon.com/servicequotas).

1. Nel pannello di navigazione, scegli **Servizi AWS ** (servizi AWS ).

1. Dall'elenco dei **AWS servizi**, cerca e seleziona **Amazon Location**.

1. Nell'elenco delle **quote di servizio**, puoi vedere il nome della quota di servizio, il valore applicato (se disponibile), la quota AWS predefinita e se il valore della quota è regolabile.

1. Per visualizzare ulteriori informazioni su una quota di servizio, ad esempio la descrizione, scegli il nome della quota.

1. (Facoltativo) Per richiedere un aumento della quota, seleziona la quota che desideri aumentare, seleziona **Richiedi un aumento della quota**, inserisci o seleziona le informazioni richieste e seleziona **Richiedi**.

 Per utilizzare meglio le quote di servizio utilizzando la console, consulta la *Service Quotas* User Guide. Per richiedere un aumento delle quote, consultare [Richiesta di aumento delle quote](https://docs.aws.amazon.com/servicequotas/latest/userguide/request-quota-increase.html) nella *Guida dell'utente di Service Quotas*. 

------
#### [ AWS CLI ]

Esegui il comando seguente per visualizzare le quote predefinite di Amazon Location.

```
aws service-quotas list-aws-default-service-quotas \
    --query 'Quotas[*].{Adjustable:Adjustable,Name:QuotaName,Value:Value,Code:QuotaCode}' \
    --service-code geo \
    --output table
```

*Per utilizzare meglio le quote di servizio utilizzando il AWS CLI, vedere la sezione Service Quotas nel AWS CLI Command Reference.* Per richiedere un aumento della quota, vedere [https://docs.aws.amazon.com/cli/latest/reference/service-quotas/request-service-quota-increase.html](https://docs.aws.amazon.com/cli/latest/reference/service-quotas/request-service-quota-increase.html)nel *AWS CLI Command* Reference. 

------

## Domande frequenti
<a name="manage-quotas_faq"></a>

**Quali sono le quote predefinite per le risorse di Amazon Location Service?**  
Amazon Location Service imposta quote predefinite per aiutare APIs a gestire la capacità del servizio, che possono essere visualizzate nella console di gestione delle [quote di AWS servizio](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas). Puoi trovare i link a tutte queste opzioni nella [Monitoraggio delle quote del servizio Amazon Location](#manage-quotas_monitor) sezione seguente.

**Come posso richiedere un aumento delle quote per Amazon Location Service?**  
Puoi richiedere un aumento delle quote di Amazon Location Service tramite la [console self-service](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas), fino a 2 volte il limite predefinito per ciascuna API. Se i limiti di quota superano il doppio del limite predefinito, richiedilo nella console self-service e verrà inviata una richiesta di assistenza. In alternativa, puoi connettere il tuo team di supporto premium 

**Esistono costi aggiuntivi associati alla richiesta di quote più elevate per Amazon Location Service?**  
Non sono previsti costi diretti per le richieste di aumento delle quote, ma livelli di utilizzo più elevati possono comportare un aumento dei costi di servizio in base alle risorse aggiuntive consumate. 

## Monitoraggio delle quote del servizio Amazon Location
<a name="manage-quotas_monitor"></a>

 Puoi monitorare il tuo utilizzo rispetto alle tue quote con Amazon CloudWatch. Per ulteriori informazioni, consulta [Monitora con Amazon CloudWatch](cloudwatch.md).

[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/location/latest/developerguide/manage-quotas.html)

## Ulteriori informazioni
<a name="manage-quotas_learn"></a>

 Per ulteriori informazioni sulle quote di servizio, consulta la documentazione [Service Quotas](https://docs.aws.amazon.com/servicequotas/latest/userguide/intro.html). 

# Gestisci le risorse con i tag
<a name="manage-resources"></a>

Usa l'etichettatura delle risorse in Amazon Location per creare tag per classificare le tue risorse in base a scopo, proprietario, ambiente o criteri. L'etichettatura delle risorse ti aiuta a gestire, identificare, organizzare, cercare e filtrare le tue risorse. Ad esempio, con AWS Resource Groups, puoi creare gruppi di AWS risorse basati su uno o più tag o porzioni di tag. Puoi anche creare gruppi in base alla loro presenza in uno AWS CloudFormation stack. Utilizzando Resource Groups e Tag Editor, è possibile consolidare e visualizzare i dati per applicazioni che consistono in più servizi, risorse e regioni in un'unica posizione. Per ulteriori informazioni sulle [strategie di tagging comuni](https://docs.aws.amazon.com/tag-editor/latest/userguide/best-practices-and-strats.html), consulta la Guida *AWS generale*.

Ogni tag è un'etichetta composta da una chiave e da un valore definiti dall'utente: 
+ **Tag key**: un'etichetta generale che classifica i valori dei tag. Ad esempio, `CostCenter`. 
+ **Valore del tag**: una descrizione opzionale per la categoria chiave del tag. Ad esempio, `MobileAssetTrackingResourcesProd`. 

Questo argomento ti aiuta a iniziare a utilizzare i tag esaminando le restrizioni relative ai tag. Inoltre, mostra come creare tag e utilizzarli per tenere traccia dei AWS costi per ogni tag attivo utilizzando i report di allocazione dei costi. 

Per ulteriori informazioni su: 
+ *Migliori pratiche per l'etichettatura, consulta [Tagging AWS resources](https://docs.aws.amazon.com/tag-editor/latest/userguide/best-practices-and-strats.html) nel AWS Riferimento generale.*
+ Utilizzo dei tag per controllare l'accesso alle AWS risorse, vedere [Controllo dell'accesso alle AWS risorse tramite tag](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html) nella *AWS Identity and Access Management User Guide*. 

## Restrizioni
<a name="manage-resources_restrictions"></a>

**Nota**  
Se si aggiunge un tag la cui chiave è la stessa di un tag esistente, il nuovo tag sovrascrive il tag esistente.

L'etichettatura consente di organizzare e gestire le risorse in modo più efficace. Questa pagina descrive le regole e i vincoli specifici che regolano l'uso dei tag all'interno di Amazon Location Service. Comprendendo queste restrizioni di etichettatura, puoi garantire la conformità alle migliori pratiche ed evitare potenziali problemi durante l'implementazione di strategie di tagging per le tue risorse e applicazioni basate sulla posizione. 

Ai tag si applicano le seguenti limitazioni di base: 
+ Numero massimo di tag per risorsa: 50 
+ Per ogni risorsa, ogni chiave di tag deve essere unica e ogni chiave di tag può avere un solo valore. 
+ Lunghezza massima della chiave: 128 caratteri Unicode in formato UTF-8 
+ Lunghezza massima del valore: 256 caratteri Unicode in formato UTF-8 
+ I caratteri consentiti nei servizi sono: lettere, numeri e spazi rappresentabili in formato UTF-8 e i seguenti caratteri speciali \$1 – = . \$1 : / @. 
+ Per le chiavi e i valori dei tag viene fatta la distinzione tra maiuscole e minuscole. 
+ Il `aws:` prefisso è riservato all' AWS uso. Se il tag ha una chiave di tag con questo prefisso, non puoi modificare o eliminare la chiave o il valore de tag. I tag con il prefisso aws: non vengono conteggiati ai fini del limite di tag per risorsa. 

## Concedi l'autorizzazione a taggare le risorse
<a name="manage-resources_grant-permission"></a>

Puoi utilizzare le policy IAM per controllare l'accesso alle tue risorse Amazon Location e concedere l'autorizzazione a taggare una risorsa al momento della creazione. Oltre a concedere l'autorizzazione a creare risorse, la policy può includere autorizzazioni Action per consentire operazioni di tagging: 
+ `geo:TagResource`— Consente a un utente di assegnare uno o più tag a una risorsa Amazon Location specificata. 
+ `geo:UntagResource`— Consente a un utente di rimuovere uno o più tag da una risorsa Amazon Location specificata. 
+ `geo:ListTagsForResource`— Consente a un utente di elencare tutti i tag assegnati a una risorsa Amazon Location. 

Di seguito è riportato un esempio di policy per consentire a un utente di creare una raccolta di geofence e taggare le risorse: 

```
{
"Version": "2012-10-17",		 	 	 
    "Statement": [
        {
"Sid": "AllowTaggingForGeofenceCollectionOnCreation",
            "Effect": "Allow",
            "Action": [
                "geo:CreateGeofenceCollection",
                "geo:TagResource"
            ],
            "Resource": "arn:aws:geo:region:accountID:geofence-collection/*"
    ]
}
```

## Aggiungere un tag a una risorsa
<a name="manage-resources_add-tag"></a>

 Puoi aggiungere tag quando crei le tue risorse utilizzando la console Amazon Location, la AWS CLI o Amazon Location: APIs 
+ [Gestisci le tue risorse di raccolta di geofence](managing-geofence-collections.md) 
+ [Crea un localizzatore](start-create-tracker.md) 

**Per etichettare le risorse esistenti, modifica o elimina i tag**

1.  Apri la [console Amazon Location](https://console.aws.amazon.com/location). 

1.  Nel riquadro di navigazione a sinistra, scegli la risorsa che desideri taggare. Ad esempio, **Mappe**. 

1.  Scegli una risorsa dall'elenco. 

1.  Scegli **Gestisci tag** per aggiungere, modificare o eliminare i tag. 

## Come usare i tag
<a name="manage-resources_how-to"></a>

 Puoi utilizzare i tag per l'allocazione dei costi per tenere traccia AWS dei costi in dettaglio. Dopo aver attivato i tag di allocazione dei costi, AWS utilizza i tag di allocazione dei costi per organizzare la fatturazione delle risorse nel rapporto sull'allocazione dei costi. Ciò consente di classificare e tenere traccia dei costi di utilizzo. 

Amazon Location supporta i tag [definiti dall'utente](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/custom-tags.html). Si tratta di tag personalizzati che crei tu. I tag definiti dall'utente utilizzano il `user:` prefisso, ad esempio. `user:CostCenter`

 È necessario attivare ogni tipo di tag singolarmente. Dopo l'attivazione dei tag, puoi [abilitare AWS Cost Explorer](https://docs.aws.amazon.com/cost-management/latest/userguide/ce-enable.html) o visualizzare il rapporto mensile sull'allocazione dei costi. 

**Per attivare i tag definiti dall'utente**

1.  Apri la [console di gestione fatturazione e costi](https://console.aws.amazon.com/billing). 

1.  Nel riquadro di navigazione a sinistra, scegli Tag di **allocazione dei costi**. 

1.  Nella scheda **Tag di allocazione dei costi definiti dall'utente**, seleziona le chiavi dei tag che desideri attivare. 

1.  Selezionare **Attiva**. 

 Dopo aver attivato i tag, AWS genera un [rapporto mensile sull'allocazione dei costi](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/configurecostallocreport.html) per l'utilizzo e i costi delle risorse. Questo rapporto sull'allocazione dei costi include tutti i AWS costi per ogni periodo di fatturazione, comprese le risorse contrassegnate e senza tag. *Per ulteriori informazioni, consulta [Organizzazione e monitoraggio dei costi utilizzando AWS i tag di allocazione dei costi](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) nella Billing User Guide.AWS * 

### Controlla l'accesso alle risorse mediante i tag
<a name="manage-resources_control-access"></a>

 AWS Identity and Access Management Le policy (IAM) supportano condizioni basate su tag, che consentono di gestire l'autorizzazione per le risorse in base a tag, chiavi e valori specifici. Ad esempio, una policy di ruolo IAM può includere condizioni per limitare l'accesso ad ambienti specifici, come lo sviluppo, il test o la produzione, in base ai tag. Per ulteriori informazioni, consulta l'argomento sul [controllo dell'accesso alle risorse in base ai tag](https://docs.aws.amazon.com/location/latest/developerguide/security-iam.html#security_iam_id-based-policy-examples). 

# Gestisci la fatturazione e i costi con AWS Billing and Cost Management
<a name="manage-billing"></a>

AWS Billing and Cost Management è un servizio web che offre funzionalità che consentono di pagare le bollette e ottimizzare i costi. Amazon Web Services fattura l'utilizzo sul tuo account, assicurandoti di pagare solo per quello che usi. 

**Come visualizzare le fatture e gestire i costi**

1. Apri [Billing and Cost](https://console.aws.amazon.com/billing) Management in Console di gestione AWS. 

1. Ricerca del servizio di localizzazione in Amazon Web Services, Inc. addebiti per servizio 

1. Scegli **[\$1] Servizio di localizzazione** 

1. Scegli **[\$1] Nome della regione** 

Per ulteriori informazioni, consulta [Billing and Cost](https://console.aws.amazon.com/costmanagement/home#/getting-started) Management nel Console di gestione AWS. 

# Crea risorse con AWS CloudFormation
<a name="cloudformation"></a>

Amazon Location Service è integrato con CloudFormation, un servizio che ti aiuta a modellare e configurare AWS le tue risorse in modo da dedicare meno tempo alla creazione e alla gestione delle risorse e dell'infrastruttura. Crei un modello che descrive tutte le AWS risorse che desideri (come le risorse di Amazon Location) e fornisce CloudFormation e configura tali risorse per te. 

Quando lo utilizzi CloudFormation, puoi riutilizzare il modello per configurare le risorse di Amazon Location in modo coerente e ripetuto. Descrivi le tue risorse una sola volta, quindi fornisci le stesse risorse più e più volte in più AWS account e regioni. 

## CloudFormation Modelli correlati
<a name="cloudformation_templates"></a>

Per fornire e configurare le risorse per Amazon Location e i servizi correlati, devi conoscere [CloudFormation i modelli](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-guide.html). I modelli sono file di testo formattati in JSON o YAML. Questi modelli descrivono le risorse di cui intendi effettuare il provisioning negli stack CloudFormation . Se non conosci JSON o YAML, puoi utilizzare Infrastructure Composer per iniziare a usare i modelli. CloudFormation *Per ulteriori informazioni, consulta [Infrastructure Composer](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/infrastructure-composer-for-cloudformation.html) nella Guida per l'utente.CloudFormation * 

Amazon Location supporta la creazione dei seguenti tipi di risorse in CloudFormation: 
+ [AWS: :Location: :Tracker](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-location-tracker.html) 
+ [AWS: :Ubicazione:: TrackerConsumer](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-location-trackerconsumer.html) 
+ [AWS: :Ubicazione:: GeofenceCollection](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-location-geofencecollection.html) 

*Per ulteriori informazioni, inclusi esempi di modelli JSON e YAML per le risorse di Amazon Location, consulta il [riferimento al tipo di risorsa Amazon Location Service](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/AWS_Location.html) nel Template Reference.CloudFormation * 

## Scopri di più su CloudFormation
<a name="cloudformation_learn"></a>

Per ulteriori informazioni CloudFormation, consulta le seguenti risorse: 
+ [CloudFormation](https://aws.amazon.com/cloudformation) 
+ [CloudFormation Guida per l'utente](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html) 
+ [CloudFormation Documentazione di riferimento delle API](https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/Welcome.html) 
+ [CloudFormation Guida per l'utente dell'interfaccia a riga di comando](https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/what-is-cloudformation-cli.html) 

# Monitoraggio e revisione
<a name="monitoring-auditing"></a>

Monitoring and Auditing offre funzionalità per tracciare, monitorare e registrare le attività nel tuo ambiente Amazon Location Services. Con Amazon CloudWatch and AWS CloudTrail, puoi garantire l'affidabilità, la sicurezza e la conformità delle tue applicazioni.

Questi strumenti ti aiutano a osservare i parametri prestazionali delle risorse, a rilevare anomalie e a registrare l'attività delle API per il controllo e la risoluzione dei problemi. Utilizzali per migliorare le informazioni operative, diagnosticare i problemi e garantire il rispetto degli standard di conformità.

**Topics**
+ [Monitora con Amazon CloudWatch](cloudwatch.md)
+ [Monitora e accedi con AWS CloudTrail](cloudtrail.md)

# Monitora con Amazon CloudWatch
<a name="cloudwatch"></a>

Amazon CloudWatch monitora AWS le tue risorse e le applicazioni su cui esegui quasi AWS in tempo reale. Puoi monitorare le risorse di Amazon Location utilizzando CloudWatch, che raccoglie dati grezzi ed elabora le metriche in statistiche significative quasi in tempo reale. Puoi visualizzare informazioni storiche per un massimo di 15 mesi o cercare metriche da visualizzare nella CloudWatch console Amazon per avere una prospettiva più approfondita sulle prestazioni della tua applicazione o del tuo servizio. Puoi anche impostare allarmi definendo soglie e inviare notifiche o intraprendere azioni quando tali soglie vengono raggiunte. 

 Per ulteriori informazioni, consulta la [Amazon CloudWatch User Guide](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/)

**Topics**
+ [Metriche e dimensioni di Amazon Location Service](#metrics-exported-to-cloudwatch)
+ [Visualizza i parametri di Amazon Location Service](#view-metrics)
+ [Crea CloudWatch allarmi per le metriche di Amazon Location Service](#create-alarms)
+ [Utilizzalo CloudWatch per monitorare l'utilizzo rispetto alle quote](#alarms-on-quotas)
+ [CloudWatch esempi di metriche per Amazon Location Service](#example-alarms)

## Metriche e dimensioni di Amazon Location Service
<a name="metrics-exported-to-cloudwatch"></a>

Le metriche sono punti dati ordinati nel tempo che vengono esportati in. CloudWatch Una dimensione è una name/value coppia che identifica la metrica. Per ulteriori informazioni, consulta [Using CloudWatch metrics](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html) and [CloudWatch dimensions](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html#Dimension) nella Amazon CloudWatch User Guide.

**Nota**  
Il risultato è approssimativo grazie all'architettura distribuita di Amazon Location Service. Nella maggior parte dei casi, il conteggio dovrebbe essere vicino al numero effettivo di operazioni API inviate.

### Metriche di Amazon Location Service
<a name="service-metrics"></a>

Di seguito sono riportate le metriche in cui Amazon Location Service esporta CloudWatch nel `AWS/Location` namespace.


| Metrica | Description | Dimensioni | 
| --- | --- | --- | 
|  `CallCount`  |  Il numero di chiamate effettuate a un determinato endpoint API.  Statistiche valide: Sum Unità: numero  |  OperationName OperationName, ResourceName ApiKeyName, OperationName ApiKeyName, OperationName, ResourceName OperationName, OperationVersion OperationName, OperationVersion, ResourceName ApiKeyName, OperationName, OperationVersion ApiKeyName, OperationName, OperationVersion, ResourceName  | 
|  `ErrorCount`  |  Il numero di risposte di errore derivanti dalle chiamate effettuate a un determinato endpoint API. Statistiche valide: Sum Unità: numero  |  OperationName OperationName, ResourceName ApiKeyName, OperationName ApiKeyName, OperationName, ResourceName  | 
|  `SuccessCount`  |  Il numero di chiamate riuscite effettuate a un determinato endpoint API.  Statistiche valide: Sum Unità: numero  |  OperationName OperationName, ResourceName ApiKeyName, OperationName ApiKeyName, OperationName, ResourceName  | 
|  `CallLatency`  |  Il tempo impiegato dall'operazione per elaborare e restituire una risposta quando viene effettuata una chiamata a un determinato endpoint API. Statistiche valide: media Unità: millisecondi  |  OperationName OperationName, ResourceName ApiKeyName, OperationName ApiKeyName, OperationName, ResourceName  | 

### Dimensioni di Amazon Location Service per le metriche
<a name="service-dimensions"></a>

Puoi utilizzare le dimensioni nella tabella seguente per filtrare le metriche di Amazon Location Service.


| Dimensione | Description | 
| --- | --- | 
|  OperationName   |  Filtra i parametri di Amazon Location per il funzionamento dell'API con il nome dell'operazione specificato.  | 
|  OperationName, ResourceName  |  Filtra i parametri di Amazon Location per il funzionamento delle API con il nome dell'operazione e il nome della risorsa specificati.  | 
|  ApiKeyName, OperationName  |  Filtra i parametri di Amazon Location per il funzionamento delle API con il nome dell'operazione specificato e utilizzando il nome della chiave API specificato.  | 
|  ApiKeyName, OperationName, ResourceName  |  Filtra i parametri di Amazon Location per il funzionamento delle API con il nome dell'operazione e della risorsa specificati e utilizzando il nome della chiave API specificato.  | 
|  OperationName, OperationVersion  |  Filtra i parametri di Amazon Location per il funzionamento dell'API con il nome dell'operazione specificato.  Le mappe, i luoghi e i percorsi autonomi di Amazon Location Service verranno esportati come metrica di esportazione in questa dimensione.   | 
|  OperationName, OperationVersion, ResourceName   |  Filtra i parametri di Amazon Location per il funzionamento dell'API con il nome dell'operazione, la versione e il nome della risorsa Amazon Location specificati.  Le mappe, i luoghi e i percorsi autonomi di Amazon Location verranno esportati come metrica di esportazione in questa dimensione.   | 
|  ApiKeyName, OperationName, OperationVersion  |  Filtra i parametri di Amazon Location per il funzionamento delle API con il nome dell'operazione, la versione e l'utilizzo del nome chiave API specificato.  Le mappe, i luoghi e i percorsi autonomi di Amazon Location verranno esportati come metrica di esportazione in questa dimensione.   | 
|  ApiKeyName, OperationName, OperationVersion, ResourceName   |  Filtra i parametri di Amazon Location per il funzionamento delle API con il nome dell'operazione, la versione, il nome della risorsa specificati e utilizzando il nome della chiave API specificato.  Le mappe, i luoghi e i percorsi autonomi di Amazon Location verranno esportati come metrica di esportazione in questa dimensione.   | 

## Visualizza i parametri di Amazon Location Service
<a name="view-metrics"></a>

Puoi visualizzare le metriche per Amazon Location Service sulla Amazon CloudWatch console o utilizzando l' Amazon CloudWatch API.

**Per visualizzare le metriche utilizzando la console CloudWatch **

**Example**  

1. Apri la CloudWatch console all'indirizzo [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).

1. Nel riquadro di navigazione, seleziona **Parametri**.

1. **Nella scheda Tutte le metriche**, scegli il namespace **Location**.

1. Seleziona il tipo di metrica da visualizzare.

1. Seleziona la metrica e aggiungila al grafico.
Per ulteriori informazioni, consulta [Visualizza i parametri disponibili](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/viewing_metrics_with_cloudwatch.html) nella *Amazon CloudWatch User Guide*. 

## Crea CloudWatch allarmi per le metriche di Amazon Location Service
<a name="create-alarms"></a>

Puoi utilizzarlo CloudWatch per impostare allarmi in base alle metriche di Amazon Location Service. Ad esempio, puoi creare un allarme per inviare un'e-mail ogni volta che CloudWatch si verifica un picco di conteggio degli errori. 

Gli argomenti seguenti forniscono una panoramica su come impostare gli allarmi utilizzando CloudWatch. Per istruzioni dettagliate, consulta [Using Alarms](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Alarms.html) nella *Amazon CloudWatch User Guide*. 

**Per impostare allarmi utilizzando la console CloudWatch **

**Example**  

1. Apri la CloudWatch console all'indirizzo [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).

1. Nel pannello di navigazione, scegli **Allarme**.

1. Scegli **Crea allarme**.

1. Scegli **Seleziona metrica**.

1. Nella scheda **Tutte le metriche**, seleziona il namespace **Location**.

1. Seleziona una categoria metrica.

1. Trova la riga con la metrica per cui desideri creare un allarme, quindi seleziona la casella di controllo accanto a questa riga.

1. Scegli **Seleziona metrica**.

1. In **Metrica**, inserisci i valori.

1. Specificare le **condizioni** di allarme.

1. Scegli **Next (Successivo)**.

1. Se desideri inviare una notifica quando le condizioni di allarme sono soddisfatte:
   + In **Attivazione dello stato** di allarme, seleziona lo stato di allarme per richiedere l'invio di una notifica.
   + In **Seleziona un argomento SNS**, scegli **Crea nuovo argomento** per creare un nuovo argomento Amazon Simple Notification Service (Amazon SNS). Inserisci il nome dell'argomento e l'e-mail a cui inviare la notifica. 
   + In **Invia una notifica per** inserire altri indirizzi e-mail a cui inviare la notifica.
   + Scegliere **Add notification (Aggiungi notifica)**. Questo elenco viene salvato e visualizzato nel campo per allarmi futuri.

1. Al termine, scegli **Avanti**.

1. Inserisci un nome e una descrizione per l'avviso, quindi scegli **Avanti**.

1. Conferma i dettagli dell'allarme, quindi scegli **Avanti**.

**Nota**  
Quando crei un nuovo argomento Amazon SNS, devi verificare l'indirizzo e-mail prima di poter inviare una notifica. Se l'e-mail non viene verificata, la notifica non verrà ricevuta quando viene avviato un allarme a causa di un cambiamento di stato.

Per ulteriori informazioni su come impostare gli allarmi utilizzando la CloudWatch console, consulta [Create an Alarm that Sends Email](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Alarms.html) nella *Amazon CloudWatch User Guide*. 

## Utilizzalo CloudWatch per monitorare l'utilizzo rispetto alle quote
<a name="alarms-on-quotas"></a>

Puoi creare CloudWatch allarmi Amazon per avvisarti quando l'utilizzo di una determinata quota supera una soglia configurabile. In questo modo puoi riconoscere quando sei vicino ai limiti di quota e adattarne l'utilizzo per evitare superamenti dei costi o richiedere un aumento della quota, se necessario. 

*Per informazioni su come utilizzare per CloudWatch monitorare le quote, consulta la sezione [Visualizzazione delle quote di servizio e impostazione degli allarmi](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Quotas-Visualize-Alarms.html) nella Amazon User Guide. CloudWatch *

## CloudWatch esempi di metriche per Amazon Location Service
<a name="example-alarms"></a>

Puoi utilizzare l'[GetMetricData](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_GetMetricData.html)API per recuperare i parametri per Amazon Location. 
+ Ad esempio, puoi monitorare `CallCount` e impostare un allarme quando si verifica un calo del numero. 

  Il monitoraggio delle `CallCount` metriche `SendDeviceLocation` può aiutarti a darti una prospettiva sugli asset tracciati. Se il dato `CallCount` diminuisce, significa che gli asset tracciati, come una flotta di camion, hanno smesso di inviare la loro posizione attuale. L'impostazione di un allarme in tal senso può aiutarti a notificare che si è verificato un problema.
+ Un altro esempio, è possibile monitorare `ErrorCount` e impostare un allarme quando si verifica un picco di numero.

  I tracker devono essere associati alle raccolte di geofence affinché le posizioni dei dispositivi possano essere valutate rispetto ai geofence. Se disponi di un parco dispositivi che richiede aggiornamenti continui sulla posizione, se visualizzi `BatchEvaluateGeofence` o riduci a zero significa che gli `CallCount` `BatchPutDevicePosition` aggiornamenti non sono più disponibili.

Di seguito è riportato un esempio di output per [GetMetricData](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_GetMetricData.html)con le metriche per `CallCount` e `ErrorCount` per la creazione di risorse cartografiche.

```
{
"StartTime": 1518867432,
  "EndTime": 1518868032,
  "MetricDataQueries": [
    {
"Id": "m1",
      "MetricStat": {
"Metric": {
"Namespace": "AWS/Location",
          "MetricName": "CallCount",
          "Dimensions": [
            {
"Name": "SendDeviceLocation",
              "Value": "100"
            }
          ]
        },
        "Period": 300,
        "Stat": "SampleCount",
        "Unit": "Count"
      }
    },
    {
"Id": "m2",
      "MetricStat": {
"Metric": {
"Namespace": "AWS/Location",
          "MetricName": "ErrorCount",
          "Dimensions": [
            {
"Name": "AssociateTrackerConsumer",
              "Value": "0"
            }
          ]
        },
        "Period": 1,
        "Stat": "SampleCount",
        "Unit": "Count"
      }
    }
  ]
}
```

# Monitora e accedi con AWS CloudTrail
<a name="cloudtrail"></a>

AWS CloudTrail è un servizio che fornisce un registro delle azioni intraprese da un utente, un ruolo o un AWS servizio. CloudTrail registra tutte le chiamate API come eventi. Puoi utilizzare Amazon Location Service con CloudTrail per monitorare le tue chiamate API, che includono le chiamate dalla console di Amazon Location Service e le chiamate AWS SDK alle operazioni dell'API Amazon Location Service. 

CloudTrail viene abilitato automaticamente quando crei il tuo AWS account. Quando si verifica un'attività in Amazon Location Service, tale attività viene registrata in un CloudTrail evento insieme ad altri eventi AWS di servizio nella **cronologia degli eventi**. Puoi visualizzare, cercare e scaricare la cronologia degli eventi degli ultimi 90 giorni per AWS regione.

Per ulteriori informazioni in merito CloudTrail, consulta la [Guida AWS CloudTrail per l'utente](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/). Non sono CloudTrail previsti costi per la visualizzazione della **cronologia degli eventi**.

Per una registrazione continua degli eventi nel tuo AWS account negli ultimi 90 giorni, inclusi gli eventi di Amazon Location Service, crea un trail o un data store [CloudTrail Lake](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. Quando crei un trail in Console di gestione AWS, il trail si applica a tutte le AWS regioni. Il percorso registra gli eventi da tutte le regioni della AWS partizione e consegna i file di registro al bucket S3 specificato. Inoltre, puoi configurare altri AWS servizi per analizzare ulteriormente e agire in base ai dati sugli eventi raccolti nei log. CloudTrail 

Per ulteriori informazioni su come creare un percorso, vedere [Panoramica sulla creazione di un percorso](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html). 

Per un elenco dei servizi e delle integrazioni CloudTrail supportati, consulta [Servizi e integrazioni CloudTrail supportati](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html#cloudtrail-aws-service-specific-topics-integrations).

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 [AWS CloudTrail dei prezzi](https://aws.amazon.com/cloudtrail/pricing/).

Per informazioni sui prezzi di Amazon S3, consulta i prezzi di [Amazon S3](https://aws.amazon.com/s3/pricing/).

**CloudTrail Archivi di dati per eventi Lake**

CloudTrail Lake ti consente di eseguire query basate su SQL sui tuoi eventi. 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](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake.html) with Lake. AWS CloudTrail 

CloudTrail Gli archivi di dati e le query 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 pagina dei prezzi.AWS CloudTrail](https://aws.amazon.com/cloudtrail/pricing/)

**Topics**
+ [Eventi di gestione della posizione Amazon in CloudTrail](#cloudtrail-management-events)
+ [Eventi relativi ai dati sulla posizione di Amazon in CloudTrail](#cloudtrail-data-events)
+ [Scopri le voci dei file di registro di Amazon Location Service](#cloudtrail-log-entries)
+ [Esempio: immissione di un file di CloudTrail registro per un evento di gestione di Amazon Location](#cloudtrail-management-event-example)
+ [Esempio: immissione di un file di CloudTrail registro per un evento di dati Amazon Location](#cloudtrail-data-event-example)

## Eventi di gestione della posizione Amazon in CloudTrail
<a name="cloudtrail-management-events"></a>

Puoi visualizzare gli eventi di gestione di Amazon Location nella cronologia CloudTrail degli eventi. Questi eventi includono tutte le chiamate API che gestiscono le risorse e le configurazioni di Amazon Location. Per un elenco completo delle azioni supportate, consulta i [riferimenti alle API di Amazon Location Service](https://docs.aws.amazon.com/location/latest/APIReference/Welcome.html). 

## Eventi relativi ai dati sulla posizione di Amazon in CloudTrail
<a name="cloudtrail-data-events"></a>

 Gli eventi relativi ai dati forniscono informazioni sulle operazioni eseguite direttamente su una risorsa. Questi eventi, noti anche come operazioni sul piano dati, possono avere un volume elevato. Per impostazione predefinita, CloudTrail non registra gli eventi relativi ai dati e la cronologia degli CloudTrail eventi non li registra. Quando abiliti gli eventi relativi ai dati, ti vengono addebitati costi aggiuntivi. Per ulteriori informazioni sui CloudTrail prezzi, consulta la pagina dei [ CloudTrailprezzi di AWS](https://aws.amazon.com/cloudtrail/pricing/). 

 Puoi scegliere quali tipi di risorse Amazon Location registrano gli eventi relativi ai dati utilizzando la CloudTrail console, la CLI AWS o le operazioni CloudTrail API. Per istruzioni su come abilitare e gestire gli eventi relativi ai dati, consulta [Logging data events con la Console di gestione AWS](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html#logging-data-events-console) e [Logging data events with the 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). 

La tabella seguente elenca i tipi di risorse Amazon Location per i quali è possibile registrare gli eventi relativi ai dati:


**Eventi supportati sui dati di localizzazione di Amazon**  

| Tipo di evento di dati (console) | valore resources.type | Dati APIs registrati su CloudTrail | 
| --- | --- | --- | 
| Mappe geografiche | AWS::GeoMaps::Provider | Consulta il riferimento all'[GeoMaps API](https://docs.aws.amazon.com/location/latest/APIReference/Welcome.html#Welcome_Amazon_Location_Service_Maps) Amazon | 
| Luoghi geografici | AWS::GeoPlaces::Provider | Consulta il riferimento all'[GeoPlaces API](https://docs.aws.amazon.com/location/latest/APIReference/Welcome.html#Welcome_Amazon_Location_Service_Places) Amazon | 
| Percorsi geografici | AWS::GeoRoutes::Provider | Consulta il riferimento all'[GeoRoutes API](https://docs.aws.amazon.com/location/latest/APIReference/Welcome.html#Welcome_Amazon_Location_Service_Routes) Amazon | 

**Nota**  
Amazon Location non pubblica CloudTrail eventi per quanto segue GeoMaps APIs:`GetStyleDescriptor`,`GetGlyphs`, e`GetSprites`. Questi APIs sono gratuiti e non richiedono l'autenticazione. 

 È possibile configurare selettori di eventi avanzati per filtrare gli eventi in base a `eventName``readOnly`, e`resources.ARN`. Questo ti aiuta a registrare solo gli eventi che ti interessano. Per ulteriori informazioni, consulta [ AdvancedFieldSelector ](https://docs.aws.amazon.com/awscloudtrail/latest/APIReference/API_AdvancedFieldSelector.html). 

## Scopri le voci dei file di registro di Amazon Location Service
<a name="cloudtrail-log-entries"></a>

 Quando configuri un trail, CloudTrail invia gli eventi come file di log a un bucket S3 da te specificato o ad Amazon CloudWatch Logs. Per ulteriori informazioni, consulta [Working with CloudTrail log files](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-working-with-log-files.html) nella Guida per l' AWS CloudTrail utente. 

 CloudTrail i file di registro possono contenere una o più voci di registro. Ogni voce di evento rappresenta una singola richiesta proveniente da qualsiasi fonte e include dettagli come l'operazione richiesta, la data e l'ora dell'operazione, i parametri della richiesta e altro ancora. 

**Nota**  
CloudTrail i file di registro non sono una traccia ordinata di chiamate API. Non appaiono in ordine cronologico. Per determinare l'ordine delle operazioni, usa`[eventTime](https://docs.aws.amazon.com/awscloudtrail/latest/APIReference/API_Event.html)`. 

 Ogni evento o voce di registro contiene informazioni su chi ha effettuato la richiesta. Queste informazioni sull'identità consentono di determinare: 
+ Se la richiesta è stata effettuata con credenziali utente o root.
+ Se la richiesta è stata effettuata con credenziali di sicurezza temporanee per un ruolo o un utente federato.
+ Se la richiesta è stata effettuata da un altro AWS servizio.

## Esempio: immissione di un file di CloudTrail registro per un evento di gestione di Amazon Location
<a name="cloudtrail-management-event-example"></a>

 L'esempio seguente mostra una voce di CloudTrail registro relativa all'`CreateTracker`operazione, che crea una risorsa tracker. 

```
{
    "eventVersion": "1.05",
    "userIdentity": {
        "type": "AssumedRole",
        "principalId": "111122223333",
        "arn": "arn:aws:geo:us-east-1:111122223333:tracker/ExampleTracker",
        "accountId": "111122223333",
        "accessKeyId": "AKIAIOSFODNN7EXAMPLE",
        "sessionContext": {
            "sessionIssuer": {
                "type": "Role",
                "principalId": "111122223333",
                "arn": "arn:aws:geo:us-east-1:111122223333:tracker/ExampleTracker",
                "accountId": "111122223333",
                "userName": "exampleUser"
            },
            "webIdFederationData": {},
            "attributes": {
                "mfaAuthenticated": "false",
                "creationDate": "2020-10-22T16:36:07Z"
            }
        }
    },
    "eventTime": "2020-10-22T17:43:30Z",
    "eventSource": "geo.amazonaws.com",
    "eventName": "CreateTracker",
    "awsRegion": "us-east-1",
    "sourceIPAddress": "SAMPLE_IP_ADDRESS",
    "userAgent": "aws-internal/3 aws-sdk-java/1.11.864 Linux/4.14.193-110.317.amzn2.x86_64 OpenJDK_64-Bit_Server_VM/11.0.8+10-LTS java/11.0.8 kotlin/1.3.72 vendor/Amazon.com_Inc. exec-env/AWS_Lambda_java11",
    "requestParameters": {
        "TrackerName": "ExampleTracker",
        "Description": "Resource description"
    },
    "responseElements": {
        "TrackerName": "ExampleTracker",
        "Description": "Resource description",
        "TrackerArn": "arn:partition:service:region:account-id:resource-id",
        "CreateTime": "2020-10-22T17:43:30.521Z"
    },
    "requestID": "557ec619-0674-429d-8e2c-eba0d3f34413",
    "eventID": "3192bc9c-3d3d-4976-bbef-ac590fa34f2c",
    "readOnly": false,
    "eventType": "AwsApiCall",
    "recipientAccountId": "111122223333"
}
```

## Esempio: immissione di un file di CloudTrail registro per un evento di dati Amazon Location
<a name="cloudtrail-data-event-example"></a>

 L'esempio seguente mostra una voce di CloudTrail registro relativa all'`Geocode`operazione, che recupera coordinate, indirizzi e altri dettagli su un luogo. 

```
{
  "eventVersion": "1.09",
  "userIdentity": {
    "type": "AssumedRole",
    "principalId": "AROA6ODU7M35SFGUCGXHMSAMPLE",
    "arn": "arn:aws:sts::111122223333:assumed-role/Admin/vingu-Isengard",
    "accountId": "111122223333",
    "accessKeyId": "ASIA6ODU7M352GLR5CFMSAMPLE",
    "sessionContext": {
      "sessionIssuer": {
        "type": "Role",
        "principalId": "AROA6ODU7M35SFGUCGXHMSAMPLE",
        "arn": "arn:aws:iam::111122223333:role/Admin",
        "accountId": "111122223333",
        "userName": "Admin"
      },
      "attributes": {
        "creationDate": "2024-09-16T14:41:33Z",
        "mfaAuthenticated": "false"
      }
    }
  },
  "eventTime": "2024-09-16T14:42:16Z",
  "eventSource": "geo-places.amazonaws.com",
  "eventName": "Geocode",
  "awsRegion": "us-west-2",
  "sourceIPAddress": "52.94.133.129",
  "userAgent": "Amazon CloudFront",
  "requestParameters": {
    "Query": "***",
    "Filter": {
      "IncludeCountries": [
        "USA"
      ]
    }
  },
  "responseElements": null,
  "requestID": "1ef7e0b8-c9fc-4a20-80c3-b5340d634c4e",
  "eventID": "913d256c-3a9d-40d0-9bdf-705f12c7659f",
  "readOnly": true,
  "resources": [
    {
      "accountId": "111122223333",
      "type": "AWS::GeoPlaces::Provider",
      "ARN": "arn:aws:geoplaces:us-west-2:111122223333:provider"
    }
  ],
  "eventType": "AwsApiCall",
  "managementEvent": false,
  "recipientAccountId": "111122223333",
  "eventCategory": "Data"
}
```

# Best practice
<a name="integration-best-practice"></a>

Di seguito sono riportate alcune best practice per l'integrazione con Amazon Location Service.

## Gestione delle risorse
<a name="resource-best-practice"></a>

Per aiutarti a gestire efficacemente le tue risorse di localizzazione in Amazon Location Service, prendi in considerazione le seguenti best practice:

**Nota**  
Le seguenti best practice si applicano alle risorse autonome utilizzate con la APIs v1. Le mappe, i luoghi e i percorsi v2 non APIs richiedono la creazione di risorse.
+ Utilizza gli endpoint regionali che sono fondamentali per la base di utenti prevista per migliorare la loro esperienza. Per informazioni sugli endpoint regionali, consulta. [Regioni supportate da Amazon Location](location-regions.md)
+ Per le risorse che utilizzano fornitori di dati, come le risorse cartografiche e le risorse relative agli indici di posizione, assicurati di rispettare i termini di utilizzo del fornitore di dati specifico. Per ulteriori informazioni, consulta [Termini di utilizzo e attribuzione dei dati](data-attribution.md).
+ Riduci al minimo la creazione di risorse disponendo di una risorsa per ogni configurazione di mappa, indice dei luoghi o percorsi. All'interno di una regione, in genere è necessaria una sola risorsa per fornitore di dati o stile di mappa. La maggior parte delle applicazioni utilizza risorse esistenti e non crea risorse in fase di esecuzione.
+ Quando utilizzi risorse diverse in un'unica applicazione, ad esempio una risorsa cartografica e un calcolatore di percorso, utilizza lo stesso fornitore di dati in ogni risorsa per garantire che i dati corrispondano. Ad esempio, che la geometria di un percorso creata con il calcolatore di percorso sia allineata con le strade sulla mappa disegnata utilizzando la risorsa della mappa.

## Gestione di costi e fatturazione
<a name="cost-best-practice"></a>

Per aiutarti a gestire i costi e la fatturazione, prendi in considerazione le seguenti best practice:
+ Utilizza strumenti di monitoraggio, come Amazon CloudWatch, per monitorare l'utilizzo delle risorse. Puoi impostare avvisi che ti avvisano quando l'utilizzo sta per superare i limiti specificati. Per ulteriori informazioni, consulta [Creazione di un allarme di fatturazione per monitorare i AWS costi stimati](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/monitor_estimated_charges_with_cloudwatch.html) nella *Amazon CloudWatch User Guide*.

## Quote e utilizzo
<a name="quota-best-practice"></a>

 Account AWS Includi quote che impostano un limite predefinito per la quantità di utilizzo. Puoi impostare allarmi per avvisarti quando l'utilizzo si avvicina al limite e richiedere un aumento di una quota, quando ne hai bisogno. Per informazioni su come utilizzare le quote, consulta i seguenti argomenti.
+ [Gestisci le quote con Service Quotas](manage-quotas.md)
+ [Crea CloudWatch allarmi per le metriche di Amazon Location Service](cloudwatch.md#create-alarms)
+ [Visualizzazione delle quote di servizio e impostazione degli allarmi nella](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Quotas-Visualize-Alarms.html) *Amazon User Guide. CloudWatch *

Puoi creare allarmi per avvisarti in anticipo quando stai per superare i tuoi limiti. Ti consigliamo di impostare allarmi per ogni quota in ciascuna delle aree in Regione AWS cui utilizzi Amazon Location. Ad esempio, puoi monitorare l'utilizzo dell'`SearchPlaceIndexForText`operazione e creare un allarme quando superi l'80% della tua quota attuale.

Quando ricevi un avviso relativo alla tua quota, devi decidere cosa fare. Potresti utilizzare risorse aggiuntive perché la tua base di clienti è cresciuta. In tal caso potresti voler richiedere un aumento della tua quota, ad esempio un aumento del 50% della quota per una chiamata API in quella regione. Oppure, forse c'è un errore nel tuo servizio che ti fa effettuare altre chiamate non necessarie verso Amazon Location. In tal caso, dovresti risolvere il problema nel tuo servizio.