

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

# 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"
      }
    }
  ]
}
```