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 operazioni sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Sebbene le operazioni mostrino come richiamare le singole funzioni del servizio, è possibile visualizzarle contestualizzate negli scenari correlati.

Ogni esempio include un collegamento al codice sorgente completo, in cui è possibile trovare istruzioni su come configurare ed eseguire il codice nel contesto.

Argomenti

Azioni

Il seguente esempio di codice mostra come utilizzaredelete-alarms.

AWS CLI

Per 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

Per eliminare un modello di rilevamento delle anomalie specificato

L'delete-anomaly-detectoresempio 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

Per eliminare i dashboard specificati

L'delete-dashboardsesempio 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

Per eliminare le regole di Contributor Insights specificate

L'delete-insight-rulesesempio seguente elimina due regole di analisi dei collaboratori denominate Rule-A e Rule-B presenti 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

Per eliminare un flusso metrico specificato

L'delete-metric-streamesempio 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

Per 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

Per 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

Per 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

Per recuperare un elenco di modelli di rilevamento delle anomalie

L'describe-anomaly-detectorsesempio seguente visualizza informazioni sui modelli di rilevatore di anomalie associati allo AWS/Logs spazio dei 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

Per recuperare un elenco di regole di Contributor Insights

L'describe-insight-rulesesempio seguente mostra tutte le regole di Contributor Insight 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

Per 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

Per disabilitare le regole di analisi dei collaboratori specificate

L'disable-insight-rulesesempio seguente disabilita due regole di analisi dei collaboratori denominate Rule-A e Rule-B presenti 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

Per 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

Per abilitare regole specifiche di analisi dei collaboratori

L'enable-insight-rulesesempio seguente abilita due regole di analisi dei collaboratori denominate Rule-A e Rule-B presenti 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

Per recuperare informazioni su un pannello di controllo

L'get-dashboardesempio 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

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

L'get-insight-rule-reportesempio seguente restituisce i dati delle 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

Per recuperare informazioni su un flusso metrico

L'get-metric-streamesempio seguente visualizza le informazioni sullo stream 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

Per recuperare un elenco di dashboard

L'list-dashboardsesempio 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

Per recuperare un elenco di flussi metrici

L'list-metric-streamsesempio 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

Per 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

Per elencare i tag associati a un allarme esistente*

L'list-tags-for-resourceesempio seguente elenca tutti i tag associati a un avviso 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

Per 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

Per creare un allarme cloudwatch composito

L'put-composite-alarmesempio 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

Per creare una dashboard

L'put-dashboardesempio seguente crea 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 una CloudWatch dashboard nella Amazon CloudWatch User Guide.

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

AWS CLI

Per creare una regola Contributor Insights

L'put-insight-ruleesempio seguente crea una regola 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

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

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

Per 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

Per creare un flusso metrico

L'put-metric-streamesempio 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

Per 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

Per avviare un flusso metrico specificato

L'start-metric-streamsesempio 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

Per interrompere un flusso metrico specificato

L'stop-metric-streamsesempio seguente interrompe 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

Per aggiungere uno o più tag alla risorsa specificata

L'tag-resourceesempio 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

Per rimuovere uno o più tag dalla risorsa specificata

L'untag-resourceesempio 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.