Recupero dei parametri personalizzati con StatsD - Amazon CloudWatch
Visualizzazione dei parametri StatsD importati dall'agente CloudWatch

Recupero dei parametri personalizzati con StatsD

Puoi recuperare i parametri personalizzati aggiuntivi dalle applicazioni o dai servizi utilizzando l'agente CloudWatch con il protocollo StatsD. 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 dell'agente CloudWatch con StatSD, consulta Come monitorare meglio i parametri dell'applicazione personalizzati utilizzando l'agente di Amazon CloudWatch.

StatsD è supportato su server Linux e server che eseguono Windows Server. CloudWatch supporta i seguenti formatiStatsD:

MetricName:value|type|@sample_rate|#tag1:
  value,tag1...

  • MetricName: una stringa senza virgola, barre, caratteri # 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) Elenco di tag separati da virgole. I tag StatsD sono simili alle dimensioni in CloudWatch. Utilizza i due punti per tag chiave/valore, ad esempio env:prod.

Puoi usare qualsiasi client StatsD che segue questo formato per inviare i parametri all'agente CloudWatch. Per ulteriori informazioni su alcuni dei client StatsD disponibili, consulta Pagina del client StatsD su 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 Creazione del file di configurazione dell'agente CloudWatch.

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'agente CloudWatch 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: la frequenza in secondi con cui CloudWatch aggrega i parametri in singoli punti dati. Il valore predefinito è 60 secondi.

    Ad esempio, se metrics_collection_interval è pari a 10 e metrics_aggregation_interval è pari a 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 i parametri originali vengano inviati a CloudWatch, puoi specificare questo parametro con un elenco di parametri. I parametri specificati insieme a questo parametro non hanno i relativi parametri per dimensione riportati a 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 dei parametri StatsD importati dall'agente CloudWatch

Dopo aver importato i parametri StatsD in CloudWatch, è possibile visualizzare questi parametri come grafici di serie temporali e creare allarmi in grado di guardare questi parametri e informare l'utente se violano 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 di allarmi Amazon CloudWatch.

Per visualizzare i parametri StatsD nella console di CloudWatch

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

  2. Nel riquadro di navigazione, scegli Parametri.

  3. Scegli lo spazio dei nomi da utilizzare per i parametri raccolti dall'agente. Per impostazione predefinita, il valore è CWAgent, ma è possibile che sia stato specificato uno spazio dei nomi diverso nel file di configurazione dell'agente CloudWatch.

  4. Scegli una dimensione di parametro (ad esempio, Per-Instance Metrics (Parametri per istanza)).

  5. La scheda All metrics (Tutti i parametri) visualizza tutti i parametri per tale dimensione nello spazio dei nomi. Puoi eseguire le operazioni indicate di seguito:

    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.

    2. Per ordinare la tabella, utilizza l'intestazione della colonna.

    3. Per filtrare per risorsa, scegli l'ID della risorsa e quindi Add to search (Aggiungi alla ricerca).

    4. Per filtrare in base a un parametro, scegli il nome del parametro e quindi Add to search (Aggiungi alla ricerca).

  6. (Facoltativo) Per aggiungere il grafico a un pannello di controllo CloudWatch, seleziona Actions (Operazioni), Add to dashboard (Aggiungi a pannello di controllo).