CloudWatch esempi utilizzando AWS CLI - AWS Command Line Interface
Azioni

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

CloudWatch esempi utilizzando AWS CLI

I seguenti esempi di codice mostrano come eseguire azioni e implementare scenari comuni utilizzando AWS Command Line Interface with CloudWatch.

Le azioni sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Sebbene le azioni mostrino come richiamare le singole funzioni del servizio, è possibile visualizzarle contestualizzate negli scenari correlati.

Ogni esempio include un link al codice sorgente completo, in cui vengono fornite le istruzioni su come configurare ed eseguire il codice nel contesto.

Argomenti

Azioni

Il seguente esempio di codice mostra come utilizzaredelete-alarms.

AWS CLI

Come eliminare un allarme

L'esempio seguente utilizza il delete-alarms comando per eliminare l' CloudWatch allarme Amazon denominato «myalarm»:

aws cloudwatch delete-alarms --alarm-names myalarm

Output:

This command returns to the prompt if successful.

Il seguente esempio di codice mostra come utilizzaredelete-anomaly-detector.

AWS CLI

Come eliminare un modello di rilevamento delle anomalie specificato

L’esempio delete-anomaly-detector seguente elimina un modello di rilevatore di anomalie nell’account specificato.

aws cloudwatch delete-anomaly-detector \
    --namespace AWS/Logs \
    --metric-name IncomingBytes \
    --stat SampleCount

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Eliminazione di un modello di rilevamento delle anomalie nella Amazon CloudWatch User Guide.

Il seguente esempio di codice mostra come utilizzaredelete-dashboards.

AWS CLI

Come eliminare le dashboard specificate

L’esempio delete-dashboards seguente elimina due dashboard denominate Dashboard-A e Dashboard-B presenti nell’account specificato.

aws cloudwatch delete-dashboards \
    --dashboard-names Dashboard-A Dashboard-B

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta i CloudWatch dashboard di Amazon nella Amazon CloudWatch User Guide.

Il seguente esempio di codice mostra come utilizzaredelete-insight-rules.

AWS CLI

Come eliminare le regole di Contributor Insights specificate

L’esempio delete-insight-rules seguente elimina due regole di Contributor Insights denominate Rule-A e Rule-B nell’account specificato.

aws cloudwatch delete-insight-rules \
    --rule-names Rule-A Rule-B

Output:

{
    "Failures": []
}

Per ulteriori informazioni, consulta Usa Contributor Insights per analizzare i dati ad alta cardinalità nella Amazon CloudWatch User Guide.

Il seguente esempio di codice mostra come utilizzaredelete-metric-stream.

AWS CLI

Come eliminare un flusso di metriche specificato

L’esempio delete-metric-stream seguente elimina il flusso di metriche denominato QuickPartial-gSCKvO nell’account specificato.

aws cloudwatch delete-metric-stream \
    --name QuickPartial-gSCKvO

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Use metric Streams nella Amazon CloudWatch User Guide.

Il seguente esempio di codice mostra come utilizzaredescribe-alarm-history.

AWS CLI

Come recuperare la cronologia di un allarme

L'esempio seguente utilizza il describe-alarm-history comando per recuperare la cronologia dell'CloudWatch allarme Amazon denominato «myalarm»:

aws cloudwatch describe-alarm-history --alarm-name "myalarm" --history-item-type StateUpdate

Output:

{
    "AlarmHistoryItems": [
        {
            "Timestamp": "2014-04-09T18:59:06.442Z",
            "HistoryItemType": "StateUpdate",
            "AlarmName": "myalarm",
            "HistoryData": "{\"version\":\"1.0\",\"oldState\":{\"stateValue\":\"ALARM\",\"stateReason\":\"testing purposes\"},\"newState\":{\"stateValue\":\"OK\",\"stateReason\":\"Threshold Crossed: 2 datapoints were not greater than the threshold (70.0). The most recent datapoints: [38.958, 40.292].\",\"stateReasonData\":{\"version\":\"1.0\",\"queryDate\":\"2014-04-09T18:59:06.419+0000\",\"startDate\":\"2014-04-09T18:44:00.000+0000\",\"statistic\":\"Average\",\"period\":300,\"recentDatapoints\":[38.958,40.292],\"threshold\":70.0}}}",
            "HistorySummary": "Alarm updated from ALARM to OK"
        },
        {
            "Timestamp": "2014-04-09T18:59:05.805Z",
            "HistoryItemType": "StateUpdate",
            "AlarmName": "myalarm",
            "HistoryData": "{\"version\":\"1.0\",\"oldState\":{\"stateValue\":\"OK\",\"stateReason\":\"Threshold Crossed: 2 datapoints were not greater than the threshold (70.0). The most recent datapoints: [38.839999999999996, 39.714].\",\"stateReasonData\":{\"version\":\"1.0\",\"queryDate\":\"2014-03-11T22:45:41.569+0000\",\"startDate\":\"2014-03-11T22:30:00.000+0000\",\"statistic\":\"Average\",\"period\":300,\"recentDatapoints\":[38.839999999999996,39.714],\"threshold\":70.0}},\"newState\":{\"stateValue\":\"ALARM\",\"stateReason\":\"testing purposes\"}}",
            "HistorySummary": "Alarm updated from OK to ALARM"
        }
    ]
}

Il seguente esempio di codice mostra come utilizzaredescribe-alarms-for-metric.

AWS CLI

Come visualizzare informazioni sugli allarmi associati a un parametro

L'esempio seguente utilizza il describe-alarms-for-metric comando per visualizzare informazioni su eventuali allarmi associati al EC2 CPUUtilization parametro Amazon e all'istanza con l'ID i-0c986c72. :

aws cloudwatch describe-alarms-for-metric --metric-name CPUUtilization --namespace AWS/EC2 --dimensions Name=InstanceId,Value=i-0c986c72

Output:

{
    "MetricAlarms": [
        {
            "EvaluationPeriods": 10,
            "AlarmArn": "arn:aws:cloudwatch:us-east-1:111122223333:alarm:myHighCpuAlarm2",
            "StateUpdatedTimestamp": "2013-10-30T03:03:51.479Z",
            "AlarmConfigurationUpdatedTimestamp": "2013-10-30T03:03:50.865Z",
            "ComparisonOperator": "GreaterThanOrEqualToThreshold",
            "AlarmActions": [
                "arn:aws:sns:us-east-1:111122223333:NotifyMe"
            ],
            "Namespace": "AWS/EC2",
            "AlarmDescription": "CPU usage exceeds 70 percent",
            "StateReasonData": "{\"version\":\"1.0\",\"queryDate\":\"2013-10-30T03:03:51.479+0000\",\"startDate\":\"2013-10-30T02:08:00.000+0000\",\"statistic\":\"Average\",\"period\":300,\"recentDatapoints\":[40.698,39.612,42.432,39.796,38.816,42.28,42.854,40.088,40.760000000000005,41.316],\"threshold\":70.0}",
            "Period": 300,
            "StateValue": "OK",
            "Threshold": 70.0,
            "AlarmName": "myHighCpuAlarm2",
            "Dimensions": [
                {
                    "Name": "InstanceId",
                    "Value": "i-0c986c72"
                }
            ],
            "Statistic": "Average",
            "StateReason": "Threshold Crossed: 10 datapoints were not greater than or equal to the threshold (70.0). The most recent datapoints: [40.760000000000005, 41.316].",
            "InsufficientDataActions": [],
            "OKActions": [],
            "ActionsEnabled": true,
            "MetricName": "CPUUtilization"
        },
        {
            "EvaluationPeriods": 2,
            "AlarmArn": "arn:aws:cloudwatch:us-east-1:111122223333:alarm:myHighCpuAlarm",
            "StateUpdatedTimestamp": "2014-04-09T18:59:06.442Z",
            "AlarmConfigurationUpdatedTimestamp": "2014-04-09T22:26:05.958Z",
            "ComparisonOperator": "GreaterThanThreshold",
            "AlarmActions": [
                "arn:aws:sns:us-east-1:111122223333:HighCPUAlarm"
            ],
            "Namespace": "AWS/EC2",
            "AlarmDescription": "CPU usage exceeds 70 percent",
            "StateReasonData": "{\"version\":\"1.0\",\"queryDate\":\"2014-04-09T18:59:06.419+0000\",\"startDate\":\"2014-04-09T18:44:00.000+0000\",\"statistic\":\"Average\",\"period\":300,\"recentDatapoints\":[38.958,40.292],\"threshold\":70.0}",
            "Period": 300,
            "StateValue": "OK",
            "Threshold": 70.0,
            "AlarmName": "myHighCpuAlarm",
            "Dimensions": [
                {
                    "Name": "InstanceId",
                    "Value": "i-0c986c72"
                }
            ],
            "Statistic": "Average",
            "StateReason": "Threshold Crossed: 2 datapoints were not greater than the threshold (70.0). The most recent datapoints: [38.958, 40.292].",
            "InsufficientDataActions": [],
            "OKActions": [],
            "ActionsEnabled": false,
            "MetricName": "CPUUtilization"
        }
    ]
}

Il seguente esempio di codice mostra come utilizzaredescribe-alarms.

AWS CLI

Come elencare le informazioni di un allarme

L’esempio seguente utilizza il comando describe-alarms per fornire informazioni sull’allarme denominato "myalarm":

aws cloudwatch describe-alarms --alarm-names "myalarm"

Output:

{
    "MetricAlarms": [
        {
            "EvaluationPeriods": 2,
            "AlarmArn": "arn:aws:cloudwatch:us-east-1:123456789012:alarm:myalarm",
            "StateUpdatedTimestamp": "2014-04-09T18:59:06.442Z",
            "AlarmConfigurationUpdatedTimestamp": "2012-12-27T00:49:54.032Z",
            "ComparisonOperator": "GreaterThanThreshold",
            "AlarmActions": [
                "arn:aws:sns:us-east-1:123456789012:myHighCpuAlarm"
            ],
            "Namespace": "AWS/EC2",
            "AlarmDescription": "CPU usage exceeds 70 percent",
            "StateReasonData": "{\"version\":\"1.0\",\"queryDate\":\"2014-04-09T18:59:06.419+0000\",\"startDate\":\"2014-04-09T18:44:00.000+0000\",\"statistic\":\"Average\",\"period\":300,\"recentDatapoints\":[38.958,40.292],\"threshold\":70.0}",
            "Period": 300,
            "StateValue": "OK",
            "Threshold": 70.0,
            "AlarmName": "myalarm",
            "Dimensions": [
                {
                    "Name": "InstanceId",
                    "Value": "i-0c986c72"
                }
            ],
            "Statistic": "Average",
            "StateReason": "Threshold Crossed: 2 datapoints were not greater than the threshold (70.0). The most recent datapoints: [38.958, 40.292].",
            "InsufficientDataActions": [],
            "OKActions": [],
            "ActionsEnabled": true,
            "MetricName": "CPUUtilization"
        }
    ]
}

Il seguente esempio di codice mostra come utilizzaredescribe-anomaly-detectors.

AWS CLI

Come recuperare un elenco di modelli di rilevamento delle anomalie

L’esempio describe-anomaly-detectors seguente visualizza le informazioni sui modelli di rilevatore di anomalie associati al namespace AWS/Logs nomi nell’account specificato.

aws cloudwatch describe-anomaly-detectors \
    --namespace AWS/Logs

Output:

{
    "AnomalyDetectors": [
        {
            "Namespace": "AWS/Logs",
            "MetricName": "IncomingBytes",
            "Dimensions": [],
            "Stat": "SampleCount",
            "Configuration": {
                "ExcludedTimeRanges": []
            },
            "StateValue": "TRAINED",
            "SingleMetricAnomalyDetector": {
                "AccountId": "123456789012",
                "Namespace": "AWS/Logs",
                "MetricName": "IncomingBytes",
                "Dimensions": [],
                "Stat": "SampleCount"
            }
        },
        {
            "Namespace": "AWS/Logs",
            "MetricName": "IncomingBytes",
            "Dimensions": [
                {
                    "Name": "LogGroupName",
                    "Value": "demo"
                }
            ],
            "Stat": "Average",
            "Configuration": {
                "ExcludedTimeRanges": []
            },
            "StateValue": "PENDING_TRAINING",
            "SingleMetricAnomalyDetector": {
                "AccountId": "123456789012",
                "Namespace": "AWS/Logs",
                "MetricName": "IncomingBytes",
                "Dimensions": [
                    {
                        "Name": "LogGroupName",
                        "Value": "demo"
                    }
                ],
                "Stat": "Average"
            }
        }
    ]
}

Per ulteriori informazioni, consulta Using CloudWatch anomaly detection nella Amazon CloudWatch User Guide.

Il seguente esempio di codice mostra come utilizzaredescribe-insight-rules.

AWS CLI

Come recuperare un elenco di regole di Contributor Insights

L’esempio describe-insight-rules seguente mostra tutte le regole di Contributor Insights nell’account specificato.

aws cloudwatch describe-insight-rules

Output:

{
    "InsightRules": [
        {
            "Name": "Rule-A",
            "State": "ENABLED",
            "Schema": "CloudWatchLogRule/1",
            "Definition": "{\n\t\"AggregateOn\": \"Count\",\n\t\"Contribution\": {\n\t\t\"Filters\": [],\n\t\t\"Keys\": [\n\t\t\t\"$.requestId\"\n\t\t]\n\t},\n\t\"LogFormat\": \"JSON\",\n\t\"Schema\": {\n\t\t\"Name\": \"CloudWatchLogRule\",\n\t\t\"Version\": 1\n\t},\n\t\"LogGroupARNs\": [\n\t\t\"arn:aws:logs:us-east-1:123456789012:log-group:demo\"\n\t]\n}",
            "ManagedRule": false
        },
        {
            "Name": "Rule-B",
            "State": "ENABLED",
            "Schema": "CloudWatchLogRule/1",
            "Definition": "{\n\t\"AggregateOn\": \"Count\",\n\t\"Contribution\": {\n\t\t\"Filters\": [],\n\t\t\"Keys\": [\n\t\t\t\"$.requestId\"\n\t\t]\n\t},\n\t\"LogFormat\": \"JSON\",\n\t\"Schema\": {\n\t\t\"Name\": \"CloudWatchLogRule\",\n\t\t\"Version\": 1\n\t},\n\t\"LogGroupARNs\": [\n\t\t\"arn:aws:logs:us-east-1:123456789012:log-group:demo-1\"\n\t]\n}",
            "ManagedRule": false
        }
    ]
}

Per ulteriori informazioni, consulta Usa Contributor Insights per analizzare i dati ad alta cardinalità nella Amazon CloudWatch User Guide.

Il seguente esempio di codice mostra come utilizzaredisable-alarm-actions.

AWS CLI

Come disattivare le operazioni su un allarme

L’esempio seguente utilizza il comando disable-alarm-actions per disabilitare tutte le operazioni per l’allarme denominato myalarm:

aws cloudwatch disable-alarm-actions --alarm-names myalarm

In caso di esito positivo, il comando torna al prompt.

Il seguente esempio di codice mostra come utilizzaredisable-insight-rules.

AWS CLI

Come disabilitare le regole di Contributor Insights specificate

L’esempio disable-insight-rules seguente disabilita due regole di Contributor Insights denominate Rule-A e Rule-B nell’account specificato.

aws cloudwatch disable-insight-rules \
    --rule-names Rule-A Rule-B

Output:

{
    "Failures": []
}

Per ulteriori informazioni, consulta Usa Contributor Insights per analizzare i dati ad alta cardinalità nella Amazon CloudWatch User Guide.

Il seguente esempio di codice mostra come utilizzareenable-alarm-actions.

AWS CLI

Come abilitare tutte le operazioni relative a un allarme

L’esempio seguente utilizza il comando enable-alarm-actions per abilitare tutte le operazioni per l’allarme denominato myalarm:

aws cloudwatch enable-alarm-actions --alarm-names myalarm

In caso di esito positivo, il comando torna al prompt.

Il seguente esempio di codice mostra come utilizzareenable-insight-rules.

AWS CLI

Come abilitare le regole di Contributor Insights specificate

L’esempio enable-insight-rules seguente abilita due regole di Contributor Insights denominate Rule-A e Rule-B nell’account specificato.

aws cloudwatch enable-insight-rules \
    --rule-names Rule-A Rule-B

Output:

{
    "Failures": []
}

Per ulteriori informazioni, consulta Usa Contributor Insights per analizzare i dati ad alta cardinalità nella Amazon CloudWatch User Guide.

Il seguente esempio di codice mostra come utilizzareget-dashboard.

AWS CLI

Come recuperare le informazioni relative a una dashboard

L’esempio get-dashboard seguente visualizza le informazioni sulla dashboard denominata Dashboard-A nell’account specificato.

aws cloudwatch get-dashboard \
    --dashboard-name Dashboard-A

Output:

{
    "DashboardArn": "arn:aws:cloudwatch::123456789012:dashboard/Dashboard-A",
    "DashboardBody": "{\"widgets\":[{\"type\":\"metric\",\"x\":0,\"y\":0,\"width\":6,\"height\":6,\"properties\":{\"view\":\"timeSeries\",\"stacked\":false,\"metrics\":[[\"AWS/EC2\",\"NetworkIn\",\"InstanceId\",\"i-0131f062232ade043\"],[\".\",\"NetworkOut\",\".\",\".\"]],\"region\":\"us-east-1\"}}]}",
    "DashboardName": "Dashboard-A"
}

Per ulteriori informazioni, consulta i CloudWatch dashboard di Amazon nella Amazon CloudWatch User Guide.

Il seguente esempio di codice mostra come utilizzareget-insight-rule-report.

AWS CLI

Come recuperare i dati di serie temporali raccolti da una regola di Contributor Insights

L’esempio get-insight-rule-report seguente restituisce i dati di serie temporali raccolti da una regola di Contributor Insights.

aws cloudwatch get-insight-rule-report \
    --rule-name Rule-A \
    --start-time 2024-10-13T20:15:00Z \
    --end-time 2024-10-13T20:30:00Z \
    --period 300

Output:

{
    "KeyLabels": [
        "PartitionKey"
    ],
    "AggregationStatistic": "Sum",
    "AggregateValue": 0.5,
    "ApproximateUniqueCount": 1,
    "Contributors": [
        {
            "Keys": [
                "RequestID"
            ],
            "ApproximateAggregateValue": 0.5,
            "Datapoints": [
                {
                    "Timestamp": "2024-10-13T21:00:00+00:00",
                    "ApproximateValue": 0.5
                }
            ]
        }
    ],
    "RuleAttributes": []
}

Per ulteriori informazioni, consulta Usa Contributor Insights per analizzare i dati ad alta cardinalità nella Amazon CloudWatch User Guide.

Il seguente esempio di codice mostra come utilizzareget-metric-data.

AWS CLI

Esempio 1: Per ottenere gli IOPS totali medi per il valore specificato EC2 utilizzando un'espressione matematica

L'get-metric-dataesempio seguente recupera i valori delle CloudWatch metriche per l' EC2 istanza con InstanceID i-abcdef utilizzando un'espressione matematica metrica che combina e metriche. EBSReadOps EBSWriteOps

aws cloudwatch get-metric-data \
    --metric-data-queries file://file.json \
    --start-time 2024-09-29T22:10:00Z \
    --end-time 2024-09-29T22:15:00Z

Contenuto di file.json:

[
    {
        "Id": "m3",
        "Expression": "(m1+m2)/300",
        "Label": "Avg Total IOPS"
    },
    {
        "Id": "m1",
        "MetricStat": {
            "Metric": {
                "Namespace": "AWS/EC2",
                "MetricName": "EBSReadOps",
                "Dimensions": [
                    {
                        "Name": "InstanceId",
                        "Value": "i-abcdef"
                    }
                ]
            },
            "Period": 300,
            "Stat": "Sum",
            "Unit": "Count"
        },
        "ReturnData": false
    },
    {
        "Id": "m2",
        "MetricStat": {
            "Metric": {
                "Namespace": "AWS/EC2",
                "MetricName": "EBSWriteOps",
                "Dimensions": [
                    {
                        "Name": "InstanceId",
                        "Value": "i-abcdef"
                    }
                ]
            },
            "Period": 300,
            "Stat": "Sum",
            "Unit": "Count"
        },
        "ReturnData": false
    }
]

Output:

{
    "MetricDataResults": [
        {
            "Id": "m3",
            "Label": "Avg Total IOPS",
            "Timestamps": [
                "2024-09-29T22:10:00+00:00"
            ],
            "Values": [
                96.85
            ],
            "StatusCode": "Complete"
        }
    ],
    "Messages": []
}

Esempio 2: per monitorare gli addebiti stimati utilizzando i parametri di fatturazione AWS CloudWatch

L'get-metric-dataesempio seguente recupera la EstimatedCharges CloudWatch metrica dallo spazio dei nomi /Billing. AWS

aws cloudwatch get-metric-data \
    --metric-data-queries '[{"Id":"m1","MetricStat":{"Metric":{"Namespace":"AWS/Billing","MetricName":"EstimatedCharges","Dimensions":[{"Name":"Currency","Value":"USD"}]},"Period":21600,"Stat":"Maximum"}}]' \
    --start-time 2024-09-26T12:00:00Z \
    --end-time 2024-09-26T18:00:00Z \
    --region us-east-1

Output:

{
    "MetricDataResults": [
        {
            "Id": "m1",
            "Label": "EstimatedCharges",
            "Timestamps": [
                "2024-09-26T12:00:00+00:00"
            ],
            "Values": [
                542.38
            ],
            "StatusCode": "Complete"
        }
    ],
    "Messages": []
}

Per ulteriori informazioni, consulta Using math expression with CloudWatch metrics nella Amazon CloudWatch User Guide.

  • Per i dettagli sull'API, consulta AWS CLI Command GetMetricDataReference.

Il seguente esempio di codice mostra come utilizzareget-metric-statistics.

AWS CLI

Per ottenere l'utilizzo della CPU per istanza EC2

L'esempio seguente utilizza il get-metric-statistics comando per ottenere l'utilizzo della CPU per un' EC2istanza con l'ID i-abcdef.

aws cloudwatch get-metric-statistics --metric-name CPUUtilization --start-time 2014-04-08T23:18:00Z --end-time 2014-04-09T23:18:00Z --period 3600 --namespace AWS/EC2 --statistics Maximum --dimensions Name=InstanceId,Value=i-abcdef

Output:

{
    "Datapoints": [
        {
            "Timestamp": "2014-04-09T11:18:00Z",
            "Maximum": 44.79,
            "Unit": "Percent"
        },
        {
            "Timestamp": "2014-04-09T20:18:00Z",
            "Maximum": 47.92,
            "Unit": "Percent"
        },
        {
            "Timestamp": "2014-04-09T19:18:00Z",
            "Maximum": 50.85,
            "Unit": "Percent"
        },
        {
            "Timestamp": "2014-04-09T09:18:00Z",
            "Maximum": 47.92,
            "Unit": "Percent"
        },
        {
            "Timestamp": "2014-04-09T03:18:00Z",
            "Maximum": 76.84,
            "Unit": "Percent"
        },
        {
            "Timestamp": "2014-04-09T21:18:00Z",
            "Maximum": 48.96,
            "Unit": "Percent"
        },
        {
            "Timestamp": "2014-04-09T14:18:00Z",
            "Maximum": 47.92,
            "Unit": "Percent"
        },
        {
            "Timestamp": "2014-04-09T08:18:00Z",
            "Maximum": 47.92,
            "Unit": "Percent"
        },
        {
            "Timestamp": "2014-04-09T16:18:00Z",
            "Maximum": 45.55,
            "Unit": "Percent"
        },
        {
            "Timestamp": "2014-04-09T06:18:00Z",
            "Maximum": 47.92,
            "Unit": "Percent"
        },
        {
            "Timestamp": "2014-04-09T13:18:00Z",
            "Maximum": 45.08,
            "Unit": "Percent"
        },
        {
            "Timestamp": "2014-04-09T05:18:00Z",
            "Maximum": 47.92,
            "Unit": "Percent"
        },
        {
            "Timestamp": "2014-04-09T18:18:00Z",
            "Maximum": 46.88,
            "Unit": "Percent"
        },
        {
            "Timestamp": "2014-04-09T17:18:00Z",
            "Maximum": 52.08,
            "Unit": "Percent"
        },
        {
            "Timestamp": "2014-04-09T07:18:00Z",
            "Maximum": 47.92,
            "Unit": "Percent"
        },
        {
            "Timestamp": "2014-04-09T02:18:00Z",
            "Maximum": 51.23,
            "Unit": "Percent"
        },
        {
            "Timestamp": "2014-04-09T12:18:00Z",
            "Maximum": 47.67,
            "Unit": "Percent"
        },
        {
            "Timestamp": "2014-04-08T23:18:00Z",
            "Maximum": 46.88,
            "Unit": "Percent"
        },
        {
            "Timestamp": "2014-04-09T10:18:00Z",
            "Maximum": 51.91,
            "Unit": "Percent"
        },
        {
            "Timestamp": "2014-04-09T04:18:00Z",
            "Maximum": 47.13,
            "Unit": "Percent"
        },
        {
            "Timestamp": "2014-04-09T15:18:00Z",
            "Maximum": 48.96,
            "Unit": "Percent"
        },
        {
            "Timestamp": "2014-04-09T00:18:00Z",
            "Maximum": 48.16,
            "Unit": "Percent"
        },
        {
            "Timestamp": "2014-04-09T01:18:00Z",
            "Maximum": 49.18,
            "Unit": "Percent"
        }
    ],
    "Label": "CPUUtilization"
}

Specifica di più dimensioni

Nell’esempio seguente viene illustrato come specificare più dimensioni. Ogni dimensione è specificata come Name/Value coppia, con una virgola tra il nome e il valore. Più dimensioni sono separate da uno spazio. Se un unico parametro include più dimensioni, è necessario specificare un valore per ogni dimensione definita.

Per altri esempi di utilizzo del get-metric-statistics comando, consulta Get Statistics for a Metric nella Amazon CloudWatch Developer Guide.

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

Il seguente esempio di codice mostra come utilizzareget-metric-stream.

AWS CLI

Come recuperare informazioni su un flusso di metriche

L’esempio get-metric-stream seguente visualizza informazioni sul flusso di metriche denominato QuickFull-GuaFbs nell’account specificato.

aws cloudwatch get-metric-stream \
    --name QuickFull-GuaFbs

Output:

{
    "Arn": "arn:aws:cloudwatch:us-east-1:123456789012:metric-stream/QuickFull-GuaFbs",
    "Name": "QuickFull-GuaFbs",
    "FirehoseArn": "arn:aws:firehose:us-east-1:123456789012:deliverystream/MetricStreams-QuickFull-GuaFbs-WnySbECG",
    "RoleArn": "arn:aws:iam::123456789012:role/service-role/MetricStreams-FirehosePutRecords-JN10W9B3",
    "State": "running",
    "CreationDate": "2024-10-11T18:48:59.187000+00:00",
    "LastUpdateDate": "2024-10-11T18:48:59.187000+00:00",
    "OutputFormat": "json",
    "IncludeLinkedAccountsMetrics": false
}

Per ulteriori informazioni, consulta Use metric Streams nella Amazon CloudWatch User Guide.

  • Per i dettagli sull'API, consulta AWS CLI Command GetMetricStreamReference.

Il seguente esempio di codice mostra come utilizzareget-metric-widget-image.

AWS CLI

Per recuperare un grafico istantaneo di CPUUtilization

L'get-metric-widget-imageesempio seguente recupera il grafico dell'istantanea per la metrica CPUUtilization dell' EC2 istanza con l'ID i-abcde e salva l'immagine recuperata come file denominato "image.png" sul computer locale.

aws cloudwatch get-metric-widget-image \
    --metric-widget '{"metrics":[["AWS/EC2","CPUUtilization","InstanceId","i-abcde"]]}' \
    --output-format png \
    --output text | base64 --decode > image.png

Questo comando non produce alcun output.

Il seguente esempio di codice mostra come utilizzarelist-dashboards.

AWS CLI

Come recuperare un elenco di dashboard

L’esempio list-dashboards seguente elenca tutte le dashboard dell’account specificato.

aws cloudwatch list-dashboards

Output:

{
    "DashboardEntries": [
        {
            "DashboardName": "Dashboard-A",
            "DashboardArn": "arn:aws:cloudwatch::123456789012:dashboard/Dashboard-A",
            "LastModified": "2024-10-11T18:40:11+00:00",
            "Size": 271
        },
        {
            "DashboardName": "Dashboard-B",
            "DashboardArn": "arn:aws:cloudwatch::123456789012:dashboard/Dashboard-B",
            "LastModified": "2024-10-11T18:44:41+00:00",
            "Size": 522
        }
    ]
}

Per ulteriori informazioni, consulta i CloudWatch dashboard di Amazon nella Amazon CloudWatch User Guide.

Il seguente esempio di codice mostra come utilizzarelist-metric-streams.

AWS CLI

Come recuperare un elenco di flussi di metriche

L’esempio list-metric-streams seguente elenca tutti i flussi di metriche nell’account specificato.

aws cloudwatch list-metric-streams

Output:

{
    "Entries": [
        {
            "Arn": "arn:aws:cloudwatch:us-east-1:123456789012:metric-stream/QuickFull-GuaFbs",
            "CreationDate": "2024-10-11T18:48:59.187000+00:00",
            "LastUpdateDate": "2024-10-11T18:48:59.187000+00:00",
            "Name": "QuickFull-GuaFbs",
            "FirehoseArn": "arn:aws:firehose:us-east-1:123456789012:deliverystream/MetricStreams-QuickFull-GuaFbs-WnySbECG",
            "State": "running",
            "OutputFormat": "json"
        }
    ]
}

Per ulteriori informazioni, consulta Use metric Streams nella Amazon CloudWatch User Guide.

Il seguente esempio di codice mostra come utilizzarelist-metrics.

AWS CLI

Come elencare i parametri per Amazon SNS

L’esempio list-metrics seguente mostra i parametri per Amazon SNS.

aws cloudwatch list-metrics \
    --namespace "AWS/SNS"

Output:

{
    "Metrics": [
        {
            "Namespace": "AWS/SNS",
            "Dimensions": [
                {
                    "Name": "TopicName",
                    "Value": "NotifyMe"
                }
            ],
            "MetricName": "PublishSize"
        },
        {
            "Namespace": "AWS/SNS",
            "Dimensions": [
                {
                    "Name": "TopicName",
                    "Value": "CFO"
                }
            ],
            "MetricName": "PublishSize"
        },
        {
            "Namespace": "AWS/SNS",
            "Dimensions": [
                {
                    "Name": "TopicName",
                    "Value": "NotifyMe"
                }
            ],
            "MetricName": "NumberOfNotificationsFailed"
        },
        {
            "Namespace": "AWS/SNS",
            "Dimensions": [
                {
                    "Name": "TopicName",
                    "Value": "NotifyMe"
                }
            ],
            "MetricName": "NumberOfNotificationsDelivered"
        },
        {
            "Namespace": "AWS/SNS",
            "Dimensions": [
                {
                    "Name": "TopicName",
                    "Value": "NotifyMe"
                }
            ],
            "MetricName": "NumberOfMessagesPublished"
        },
        {
            "Namespace": "AWS/SNS",
            "Dimensions": [
                {
                    "Name": "TopicName",
                    "Value": "CFO"
                }
            ],
            "MetricName": "NumberOfMessagesPublished"
        },
        {
            "Namespace": "AWS/SNS",
            "Dimensions": [
                {
                    "Name": "TopicName",
                    "Value": "CFO"
                }
            ],
            "MetricName": "NumberOfNotificationsDelivered"
        },
        {
            "Namespace": "AWS/SNS",
            "Dimensions": [
                {
                    "Name": "TopicName",
                    "Value": "CFO"
                }
            ],
            "MetricName": "NumberOfNotificationsFailed"
        }
    ]
}

Il seguente esempio di codice mostra come utilizzarelist-tags-for-resource.

AWS CLI

Come elencare i tag associati a un allarme esistente*

L’esempio list-tags-for-resource seguente elenca tutti i tag associati a un allarme denominato demo nell’account specificato.

aws cloudwatch list-tags-for-resource \
    --resource-arn arn:aws:cloudwatch:us-east-1:123456789012:alarm:demo

Output:

{
    "Tags": [
        {
            "Key": "stack",
            "Value": "Production"
        },
        {
            "Key": "team",
            "Value": "Devops"
        }
    ]
}

Per ulteriori informazioni, consulta Allarmi e tag nella Amazon CloudWatch User Guide.

Il seguente esempio di codice mostra come utilizzareput-anomaly-detector.

AWS CLI

Come creare un modello di rilevamento delle anomalie

L'put-anomaly-detectoresempio seguente crea un modello di rilevamento delle anomalie per una CloudWatch metrica.

aws cloudwatch put-anomaly-detector \
    --namespace AWS/Logs \
    --metric-name IncomingBytes \
    --stat SampleCount

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Using CloudWatch anomaly detection nella Amazon CloudWatch User Guide.

Il seguente esempio di codice mostra come utilizzareput-composite-alarm.

AWS CLI

Come creare un allarme CloudWatch composito

L’esempio put-composite-alarm seguente crea un allarme composito denominato ProdAlarm nell’account specificato.

aws cloudwatch put-composite-alarm \
    --alarm-name ProdAlarm \
    --alarm-rule "ALARM(CPUUtilizationTooHigh) AND ALARM(MemUsageTooHigh)" \
    --alarm-actions arn:aws:sns:us-east-1:123456789012:demo \
    --actions-enabled

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Creare un allarme composito nella Amazon CloudWatch User Guide.

Il seguente esempio di codice mostra come utilizzareput-dashboard.

AWS CLI

Come creare una dashboard

L’esempio put-dashboard seguente elenca una dashboard denominata Dashboard-A nell’account specificato.

aws cloudwatch put-dashboard \
    --dashboard-name Dashboard-A \
    --dashboard-body '{"widgets":[{"height":6,"width":6,"y":0,"x":0,"type":"metric","properties":{"view":"timeSeries","stacked":false,"metrics":[["Namespace","CPUUtilization","Environment","Prod","Type","App"]],"region":"us-east-1"}}]}'

Output:

{
    "DashboardValidationMessages": []
}

Per ulteriori informazioni, consulta la sezione Creazione di un CloudWatch pannello di controllo nella Amazon CloudWatch User Guide.

Il seguente esempio di codice mostra come utilizzareput-insight-rule.

AWS CLI

Come creare una regola di Contributor Insights

L’esempio put-insight-rule seguente crea una regola di Contributor Insights denominata VPCFlowLogsContributorInsights nell’account specificato.

aws cloudwatch put-insight-rule \
    --rule-name VPCFlowLogsContributorInsights \
    --rule-definition file://insight-rule.json \
    --rule-state ENABLED

Contenuto di insight-rule.json:

{
    "Schema": {
        "Name": "CloudWatchLogRule",
        "Version": 1
    },
    "AggregateOn": "Count",
    "Contribution": {
        "Filters": [],
        "Keys": [
            "tcp-flag"
        ]
    },
    "LogFormat": "CLF",
    "LogGroupNames": [
        "/vpc/flowlogs/*"
    ],
    "Fields": {
        "23": "tcp-flag"
    }
}

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta la sezione Create a Contributor Insights CloudWatch nella Amazon CloudWatch User Guide.

Il seguente esempio di codice mostra come utilizzareput-metric-alarm.

AWS CLI

Come inviare un messaggio e-mail Amazon Simple Notification Service quando l’utilizzo della CPU supera il 70%

Nell’esempio seguente viene utilizzato il comando put-metric-alarm per inviare un messaggio e-mail Amazon Simple Notification Service quando l’utilizzo della CPU supera il 70%:

aws cloudwatch put-metric-alarm --alarm-name cpu-mon --alarm-description "Alarm when CPU exceeds 70 percent" --metric-name CPUUtilization --namespace AWS/EC2 --statistic Average --period 300 --threshold 70 --comparison-operator GreaterThanThreshold  --dimensions "Name=InstanceId,Value=i-12345678" --evaluation-periods 2 --alarm-actions arn:aws:sns:us-east-1:111122223333:MyTopic --unit Percent

In caso di esito positivo, il comando torna al prompt. Se esiste già un allarme con lo stesso nome, verrà sovrascritto dal nuovo allarme.

Come specificare più dimensioni

Nell’esempio seguente viene illustrato come specificare più dimensioni. Ogni dimensione è specificata come Name/Value coppia, con una virgola tra il nome e il valore. Più dimensioni sono separate da uno spazio:

aws cloudwatch put-metric-alarm --alarm-name "Default_Test_Alarm3" --alarm-description "The default example alarm" --namespace "CW EXAMPLE METRICS" --metric-name Default_Test --statistic Average --period 60 --evaluation-periods 3 --threshold 50 --comparison-operator GreaterThanOrEqualToThreshold --dimensions Name=key1,Value=value1 Name=key2,Value=value2

Il seguente esempio di codice mostra come utilizzareput-metric-data.

AWS CLI

Per pubblicare una metrica personalizzata su Amazon CloudWatch

L'esempio seguente utilizza il put-metric-data comando per pubblicare una metrica personalizzata su Amazon CloudWatch:

aws cloudwatch put-metric-data --namespace "Usage Metrics" --metric-data file://metric.json

I valori del parametro stesso sono memorizzati nel file JSON, metric.json.

Ecco i contenuti del file:

[
  {
    "MetricName": "New Posts",
    "Timestamp": "Wednesday, June 12, 2013 8:28:20 PM",
    "Value": 0.50,
    "Unit": "Count"
  }
]

Per ulteriori informazioni, consulta Publishing Custom Metrics nella Amazon CloudWatch Developer Guide.

Come specificare più dimensioni

Nell'esempio seguente viene illustrato come specificare più dimensioni. Ogni dimensione è specificata come coppia Name=Valore. Più dimensioni sono separate da una virgola:

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

Il seguente esempio di codice mostra come utilizzareput-metric-stream.

AWS CLI

Come creare un flusso di metriche

L’esempio put-metric-stream seguente crea un flusso di metriche denominato QuickFull-GuaFb nell’account specificato.

aws cloudwatch put-metric-stream \
    --name QuickFull-GuaFbs \
    --firehose-arn arn:aws:firehose:us-east-1:123456789012:deliverystream/MetricStreams-QuickFull-GuaFbs-WnySbECG \
    --role-arn arn:aws:iam::123456789012:role/service-role/MetricStreams-FirehosePutRecords-JN10W9B3 \
    --output-format json \
    --no-include-linked-accounts-metrics

Output:

{
    "Arn": "arn:aws:cloudwatch:us-east-1:123456789012:metric-stream/QuickFull-GuaFbs"
}

Per ulteriori informazioni, consulta Configurare un flusso di parametri nella Amazon CloudWatch User Guide.

Il seguente esempio di codice mostra come utilizzareset-alarm-state.

AWS CLI

Come modificare temporaneamente lo stato di un allarme

L'esempio seguente utilizza il set-alarm-state comando per modificare temporaneamente lo stato di un CloudWatch allarme Amazon denominato «myalarm» e impostarlo sullo stato ALARM a scopo di test:

aws cloudwatch set-alarm-state --alarm-name "myalarm" --state-value ALARM --state-reason "testing purposes"

In caso di esito positivo, il comando torna al prompt.

Il seguente esempio di codice mostra come utilizzarestart-metric-streams.

AWS CLI

Come avviare un flusso di metriche specificato

L’esempio start-metric-streams seguente avvia il flusso di metriche denominato QuickFull-GuaFbs nell’account specificato.

aws cloudwatch start-metric-streams \
    --names QuickFull-GuaFbs

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Use metric Streams nella Amazon CloudWatch User Guide.

Il seguente esempio di codice mostra come utilizzarestop-metric-streams.

AWS CLI

Come arrestare un flusso di metriche specificato

L’esempio stop-metric-streams seguente arresta il flusso di metriche denominato QuickFull-GuaFbs nell’account specificato.

aws cloudwatch stop-metric-streams \
    --names QuickFull-GuaFbs

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Use metric Streams nella Amazon CloudWatch User Guide.

Il seguente esempio di codice mostra come utilizzaretag-resource.

AWS CLI

Come aggiungere uno o più tag alla risorsa specificata

L’esempio tag-resource seguente aggiunge 2 tag all’allarme CloudWatch denominato demo nell’account specificato.

aws cloudwatch tag-resource \
    --resource-arn arn:aws:cloudwatch:us-east-1:123456789012:alarm:demo \
    --tags Key=stack,Value=Production Key=team,Value=Devops

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Taggare le CloudWatch risorse Amazon nella Amazon CloudWatch User Guide.

Il seguente esempio di codice mostra come utilizzareuntag-resource.

AWS CLI

Come rimuovere uno o più tag dalla risorsa specificata

L’esempio untag-resource seguente rimuove 2 tag dall’allarme CloudWatch denominato demo nell’account specificato.

aws cloudwatch untag-resource \
    --resource-arn arn:aws:cloudwatch:us-east-1:123456789012:alarm:demo \
    --tag-keys stack team

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Taggare le CloudWatch risorse Amazon nella Amazon CloudWatch User Guide.