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

Publish custom metrics

Puoi pubblicare le tue metriche CloudWatch utilizzando AWS CLI o un. API Puoi visualizzare grafici statistici delle metriche pubblicate con. AWS Management Console

CloudWatch archivia i dati relativi a una metrica come una serie di punti dati. Ogni punto dati viene associato a un timestamp. Puoi inoltre pubblicare un set aggregato di punti di dati denominato set di statistiche.

Parametri ad alta risoluzione

Ogni parametro appartiene a una delle seguenti categorie:

Per impostazione predefinita, le metriche prodotte dai AWS servizi hanno una risoluzione standard. Quando pubblichi un parametro personalizzato, puoi definirlo sia come risoluzione standard che come alta risoluzione. Quando pubblichi una metrica ad alta risoluzione, la CloudWatch archivia con una risoluzione di 1 secondo e puoi leggerla e recuperarla con un periodo di 1 secondo, 5 secondi, 10 secondi, 30 secondi o qualsiasi multiplo di 60 secondi.

I parametri ad alta risoluzione ti offrono un'analisi più immediata sull'attività inferiore al minuto dell'applicazione. Tieni presente che ogni chiamata PutMetricData per un parametro personalizzato viene addebitata, quindi frequenti chiamate a PutMetricData su un parametro ad alta risoluzione potrebbero portare a costi più elevati. Per ulteriori informazioni sui CloudWatch prezzi, consulta la pagina CloudWatch dei prezzi di Amazon.

Se imposti un allarme su un parametro ad alta risoluzione, puoi specificare un allarme ad alta risoluzione con un periodo di 10 secondi o 30 secondi, oppure puoi impostare un allarme regolare con un periodo di qualsiasi multiplo di più di 60 secondi. Viene addebitato un costo maggiore per gli allarmi ad alta risoluzione con un periodo di 10 o 30 secondi.

Utilizzo delle dimensioni

Nei parametri personalizzati, il parametro --dimensions è comune. Una dimensione chiarisce ulteriormente le caratteristiche del parametro e i dati archiviati. Puoi avere un massimo di 30 dimensioni assegnate a un parametro, ognuna delle quali è definita da una coppia formata da nome e valore.

Il modo in cui si specifica una dimensione è diverso quando utilizzi comandi differenti. Con put-metric-data, specifichi ogni dimensione come MyName=MyValuee con get-metric-statisticso put-metric-alarmsi utilizza il formato Name=MyName, Value=MyValue. Ad esempio, il comando seguente pubblica una Buffers metrica con due dimensioni denominate InstanceId e. InstanceType

aws cloudwatch put-metric-data --metric-name Buffers --namespace MyNameSpace --unit Bytes --value 231434333 --dimensions InstanceId=1-23456789,InstanceType=m1.small

Questo comando recupera le statistiche per quello stesso parametro. Separa con virgole le parti di Nome e Valore di una singola dimensione, ma utilizza uno spazio tra una dimensione e quella successiva se disponi di più dimensioni.

aws cloudwatch get-metric-statistics --metric-name Buffers --namespace MyNameSpace --dimensions Name=InstanceId,Value=1-23456789 Name=InstanceType,Value=m1.small --start-time 2016-10-15T04:00:00Z --end-time 2016-10-19T07:00:00Z --statistics Average --period 60

Se una singola metrica include più dimensioni, è necessario specificare un valore per ogni dimensione definita quando si utilizza. get-metric-statistics Ad esempio, il parametro Amazon S3 BucketSizeBytes include le dimensioni BucketName eStorageType, pertanto, è necessario specificare entrambe le dimensioni con. get-metric-statistics

aws cloudwatch get-metric-statistics --metric-name BucketSizeBytes --start-time 2017-01-23T14:23:00Z --end-time 2017-01-26T19:30:00Z --period 3600 --namespace AWS/S3 --statistics Maximum --dimensions Name=BucketName,Value=amzn-s3-demo-bucket Name=StorageType,Value=StandardStorage --output table

Per visualizzare le dimensioni definite per un parametro, è disponibile il comando list-metrics.

Pubblicazione di singoli punti dati

Per pubblicare un singolo punto dati per una metrica nuova o esistente, usa il put-metric-datacomando con un valore e un timestamp. Ad esempio, ciascuna delle seguenti operazioni pubblica un punto dati.

aws cloudwatch put-metric-data --metric-name PageViewCount --namespace MyService --value 2 --timestamp 2016-10-20T12:00:00.000Z
aws cloudwatch put-metric-data --metric-name PageViewCount --namespace MyService --value 4 --timestamp 2016-10-20T12:00:01.000Z
aws cloudwatch put-metric-data --metric-name PageViewCount --namespace MyService --value 5 --timestamp 2016-10-20T12:00:02.000Z

Se chiami questo comando con un nuovo nome di metrica, CloudWatch crea una metrica per te. Altrimenti, CloudWatch associa i tuoi dati alla metrica esistente che hai specificato.

Sebbene sia possibile pubblicare punti dati con timestamp granulari fino a un millesimo di secondo, CloudWatch aggrega i dati con una granularità minima di 1 secondo. CloudWatch registra la media (somma di tutti gli elementi divisa per il numero di elementi) dei valori ricevuti per ogni periodo, nonché il numero di campioni, il valore massimo e il valore minimo per lo stesso periodo di tempo. Ad esempio, il parametro PageViewCount degli esempi precedenti contiene tre punti di dati con timestamp distanti di pochi secondi. Se il periodo è impostato su 1 minuto, CloudWatch aggrega i tre punti dati perché hanno tutti un timestamp entro un periodo di 1 minuto.

Puoi utilizzare il comando get-metric-statistics per recuperare le statistiche in base ai punti dati pubblicati.

aws cloudwatch get-metric-statistics --namespace MyService --metric-name PageViewCount \
--statistics "Sum" "Maximum" "Minimum" "Average" "SampleCount" \
--start-time 2016-10-20T12:00:00.000Z --end-time 2016-10-20T12:05:00.000Z --period 60

Di seguito è riportato un output di esempio.

{
    "Datapoints": [
        {
            "SampleCount": 3.0, 
            "Timestamp": "2016-10-20T12:00:00Z", 
            "Average": 3.6666666666666665, 
            "Maximum": 5.0, 
            "Minimum": 2.0, 
            "Sum": 11.0, 
            "Unit": "None"
        }
    ], 
    "Label": "PageViewCount"
}

Pubblicazione di set di statistiche

Puoi aggregare i tuoi dati prima di pubblicarli su. CloudWatch Quando sono presenti più punti dati al minuto, l'aggregazione dei dati riduce al minimo il numero di chiamate a put-metric-data. Ad esempio, invece di chiamare più volte put-metric-data per tre punti dati a distanza di 3 secondi l'uno dall'altro, è possibile aggregare i dati in un set di statistiche da pubblicare con un'unica chiamata, tramite il parametro --statistic-values.

aws cloudwatch put-metric-data --metric-name PageViewCount --namespace MyService --statistic-values Sum=11,Minimum=2,Maximum=5,SampleCount=3 --timestamp 2016-10-14T12:00:00.000Z

CloudWatch necessita di punti dati grezzi per calcolare i percentili. Se pubblichi dati utilizzando un set di statistiche, invece, non potrai recuperarne le relative statistiche dei percentili, a meno che non si verifichi una delle seguenti condizioni:

Pubblicazione del valore zero

Quando i tuoi dati sono più sporadici e sono presenti periodi senza dati associati, puoi scegliere di pubblicare il valore zero (0) per tale periodo oppure nessun valore. Se utilizzi chiamate periodiche a PutMetricData per monitorare lo stato delle applicazioni, potresti voler pubblicare zero invece di nessun valore. Ad esempio, puoi impostare un CloudWatch allarme per avvisarti se l'applicazione non riesce a pubblicare le metriche ogni cinque minuti. Desideri che tale applicazione pubblichi valori zero per i periodi senza dati associati.

Puoi inoltre pubblicare valori zero se intendi monitorare il numero totale di punti di dati o se desideri che le statistiche di tipo minima e media includano i punti di dati con il valore 0.

Interrompi i parametri di pubblicazione

Per interrompere la pubblicazione di metriche personalizzate su CloudWatch, modifica il codice dell'applicazione o del servizio in modo che smetta di utilizzarle. PutMetricData CloudWatch non estrae metriche dalle applicazioni, riceve solo ciò che gli viene inviato, quindi per interrompere la pubblicazione delle metriche è necessario interromperle alla fonte.