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à.
# Recupero dei parametri personalizzati con StatsD
Puoi recuperare metriche personalizzate aggiuntive dalle tue applicazioni o servizi utilizzando l' CloudWatch agente con il `StatsD` protocollo. StatSD è una soluzione open source popolare in grado di raccogliere parametri da un'ampia varietà di applicazioni. StatSD è particolarmente utile per la strumentazione dei parametri. Per un esempio di utilizzo congiunto dell' CloudWatch agente e StatSD, consulta [Come monitorare meglio i parametri delle applicazioni personalizzate utilizzando Amazon](https://aws.amazon.com/blogs/devops/new-how-to-better-monitor-your-custom-application-metrics-using-amazon-cloudwatch-agent/) Agent. CloudWatch
`StatsD`è supportato sia su server Linux che su server che eseguono Windows Server. CloudWatch supporta il seguente `StatsD` formato:
```
MetricName:value|type|@sample_rate|#tag1:
value,tag1...
```
+ `MetricName`: una stringa senza virgola, barre, caratteri \$1 o @.
+ `value`: questo può essere un numero intero o float.
+ `type`: specifica `c` per il contatore, `g` per il misuratore, `ms` per il timer, `h` per l'istogramma o `s` per il set.
+ `sample_rate` (facoltativo) Un float compreso tra 0 e 1, inclusi. Utilizza solo per contatore, istogramma e parametri timer. Il valore predefinito è 1 (campionamento 100% del tempo).
+ `tags`— (Facoltativo) Un elenco di tag separati da virgole. `StatsD`i tag sono simili alle dimensioni di. CloudWatch Utilizza i due punti per tag chiave/valore, ad esempio `env:prod`.
Puoi utilizzare qualsiasi `StatsD` client che segue questo formato per inviare le metriche all' CloudWatch agente. Per ulteriori informazioni su alcuni dei `StatsD` client disponibili, vedere la [pagina del client StatSD su](https://github.com/etsy/statsd/wiki#client-implementations). GitHub
Per raccogliere questi parametri personalizzati, aggiungi una riga `"statsd": {}` alla sezione `metrics_collected` del file di configurazione dell'agente. È possibile aggiungere questa riga manualmente. Se utilizzi la procedura guidata per creare il file di configurazione, è già tutto previsto. Per ulteriori informazioni, consulta la pagina [Create il file di configurazione dell' CloudWatch agente](create-cloudwatch-agent-configuration-file.md).
La configurazione predefinita `StatsD` funziona per la maggior parte degli utenti. È possibile aggiungere dei campi facoltativi alla sezione **statsd** del file di configurazione dell'agente in base alle esigenze:
+ `service_address`— L'indirizzo del servizio che l' CloudWatch agente deve ascoltare. Il formato è `ip:port`. Se ometti l'indirizzo IP, l'agente ascolta su tutte le interfacce disponibili. È supportato solo il formato UDP, perciò non devi specificare un prefisso UDP.
Il valore predefinito è `:8125`.
+ `metrics_collection_interval`: la frequenza in secondi con cui il plug-in `StatsD` viene eseguito e raccoglie i parametri. Il valore predefinito è 10 secondi. L'intervallo varia tra 1 e 172.000.
+ `metrics_aggregation_interval`— Con quale frequenza, in secondi, CloudWatch aggrega le metriche in singoli punti dati. Il valore predefinito è 60 secondi.
Ad esempio, se `metrics_collection_interval` è 10 ed `metrics_aggregation_interval` è 60, CloudWatch raccoglie i dati ogni 10 secondi. Al termine di ogni minuto, le sei letture di dati di quel minuto vengono aggregate in un singolo punto dati, che viene inviato a CloudWatch.
L'intervallo varia tra 0 e 172.000. Impostando `metrics_aggregation_interval` su 0 si disabilita l'aggregazione dei parametri `StatsD`.
+ `allowed_pending_messages`: il numero di messaggi UDP che possono essere messi in coda. Quando la coda è piena, il server StatsD inizia a eliminare i pacchetti. Il valore predefinito è 10000.
+ `drop_original_metrics` : Opzionale. Se utilizzi il campo `aggregation_dimensions` nella sezione `metrics` per raggruppare i parametri in risultati aggregati, per impostazione predefinita l'agente invia sia i parametri aggregati che i parametri originali separati per ogni valore della dimensione. Se non desideri che le metriche originali vengano inviate a CloudWatch, puoi specificare questo parametro con un elenco di metriche. Le metriche specificate insieme a questo parametro non hanno le relative metriche per dimensione riportate. CloudWatch Vengono invece riportati solo i parametri aggregati. Ciò riduce il numero di parametri raccolti dall'agente, riducendo i costi.
Di seguito è riportato un esempio della sezione **statsd** del file di configurazione dell'agente, utilizzando la porta di default e intervalli personalizzati di raccolta e aggregazione.
```
{
"metrics":{
"metrics_collected":{
"statsd":{
"service_address":":8125",
"metrics_collection_interval":60,
"metrics_aggregation_interval":300
}
}
}
}
```
## Visualizzazione delle metriche StatsD importate dall'agente CloudWatch
Dopo aver importato le metriche StatsD CloudWatch in, puoi visualizzare queste metriche come grafici di serie temporali e creare allarmi in grado di guardare queste metriche e avvisarti se superano una soglia specificata. La procedura seguente mostra come visualizzare le parametri StatsD come grafico di serie temporali. Per ulteriori informazioni sull'impostazione degli allarmi, consulta [Utilizzo degli CloudWatch allarmi Amazon](CloudWatch_Alarms.md).
**Per visualizzare le metriche StatsD nella console CloudWatch**
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. Scegli lo spazio dei nomi da utilizzare per i parametri raccolti dall'agente. Per impostazione predefinita, lo è **CWAgent**, ma è possibile che sia stato specificato uno spazio dei nomi diverso nel file di configurazione dell' CloudWatch agente.
1. Scegli una dimensione di parametro (ad esempio, **Per-Instance Metrics** (Parametri per istanza)).
1. La scheda **All metrics** (Tutti i parametri) visualizza tutti i parametri per tale dimensione nello spazio dei nomi. È possibile effettuare le seguenti operazioni:
1. Per creare il grafico di un parametro, seleziona la casella di controllo accanto al parametro. Per selezionare tutte i parametri, seleziona la casella di controllo nella riga dell'intestazione della tabella.
1. Per ordinare la tabella, utilizza l'intestazione della colonna.
1. Per filtrare per risorsa, scegli l'ID della risorsa e quindi **Add to search** (Aggiungi alla ricerca).
1. Per filtrare in base a un parametro, scegli il nome del parametro e quindi **Add to search** (Aggiungi alla ricerca).
1. (Facoltativo) Per aggiungere questo grafico a una CloudWatch dashboard, scegli **Azioni**, **Aggiungi alla dashboard**.