Esempi per CloudWatch con la AWS CLI

Per eliminare un allarme

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

aws cloudwatch delete-alarms --alarm-names myalarm

Output:

This command returns to the prompt if successful.

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 Deleting an anomaly detection model nella Guida per l’utente di Amazon CloudWatch.

Come eliminare le dashboard specificate

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

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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Amazon CloudWatch dashboards nella Guida per l’utente di Amazon CloudWatch.

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 Use Contributor Insights to analyze high-cardinality data nella Guida per l’utente Amazon CloudWatch.

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 Guida per l’utente di Amazon CloudWatch.

Per recuperare la cronologia di un allarme

L'esempio seguente utilizza il comando describe-alarm-history per recuperare la cronologia dell'allarme Amazon CloudWatch 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"
        }
    ]
}

Per visualizzare informazioni sugli allarmi associati a un parametro

L'esempio seguente utilizza il comando describe-alarms-for-metric per visualizzare informazioni su eventuali allarmi associati al parametro CPUUtilization di Amazon EC2 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"
        }
    ]
}

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"
        }
    ]
}

Come recuperare un elenco di modelli di rilevamento delle anomalie

L’esempio describe-anomaly-detectors seguente visualizza informazioni sui modelli di rilevatore di anomalie associati al namespace AWS/Logs 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 Guida per l’utente di Amazon CloudWatch.

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 Use Contributor Insights to analyze high-cardinality data nella Guida per l’utente Amazon CloudWatch.

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.

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 Use Contributor Insights to analyze high-cardinality data nella Guida per l’utente Amazon CloudWatch.

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.

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 Use Contributor Insights to analyze high-cardinality data nella Guida per l’utente Amazon CloudWatch.

Come recuperare informazioni su una dashboard

L’esempio get-dashboard seguente visualizza 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 Amazon CloudWatch dashboards nella Guida per l’utente di Amazon CloudWatch.

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 Use Contributor Insights to analyze high-cardinality data nella Guida per l’utente Amazon CloudWatch.

Esempio 1: ottenere il valore IOPS totale medio per l’istanza EC2 specificata utilizzando un’espressione matematica

L’esempio get-metric-data seguente recupera i valori dei parametri CloudWatch per l’istanza EC2 con InstanceID i-abcdef utilizzando un’espressione matematica metrica che combina le metriche EBSReadOps e 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: monitorare gli addebiti AWS stimati utilizzando le metriche di fatturazione di CloudWatch

L’esempio get-metric-data seguente recupera la metrica EstimatedCharges di CloudWatch dal namespace AWS/Billing.

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 expressions with CloudWatch metrics nella Guida per l’utente di Amazon CloudWatch.

Come ottenere l’utilizzo della CPU per un’istanza EC2

L'esempio seguente utilizza il comando get-metric-statistics per ottenere l'utilizzo della CPU per un'istanza EC2 con 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 coppia nome/valore, 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 comando get-metric-statistics, consulta Ottenimento di statistiche di un parametro nella Guida per gli sviluppatori di Amazon CloudWatch.

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

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 Guida per l’utente di Amazon CloudWatch.

Come recuperare un grafico snapshot per CPUUtilization

L’esempio get-metric-widget-image seguente recupera il grafico snapshot per la metrica CPUUtilization dell’istanza EC2 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.

Come recuperare un elenco di dashboard

L’esempio list-dashboards seguente elenca tutte le dashboard nell’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 Amazon CloudWatch dashboards nella Guida per l’utente di Amazon CloudWatch.

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 Guida per l’utente di Amazon CloudWatch.

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"
        }
    ]
}

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 Alarms and tagging nella Guida per l’utente di Amazon CloudWatch.

Come creare un modello di rilevamento delle anomalie

L’esempio put-anomaly-detector seguente crea un modello di rilevamento delle anomalie per una metrica CloudWatch.

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 Guida per l’utente di Amazon CloudWatch.

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 Create a composite alarm nella Guida per l’utente di Amazon CloudWatch.

Come creare una dashboard

L’esempio put-dashboard 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 Creating a CloudWatch dashboard nella Guida per l’utente di Amazon CloudWatch.

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 Create a Contributor Insights rule in CloudWatch nella Guida per l’utente di Amazon CloudWatch Logs.

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 coppia nome/valore, 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

Per pubblicare parametri personalizzati in Amazon CloudWatch

L'esempio seguente utilizza il comando put-metric-data per pubblicare un parametro personalizzato 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 Pubblicazione di parametri personalizzati nella Guida per gli sviluppatori di Amazon CloudWatch.

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

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 Set up a metric stream nella Guida per l’utente di Amazon CloudWatch.

Come modificare temporaneamente lo stato di un allarme

L’esempio seguente utilizza il comando set-alarm-state per modificare temporaneamente lo stato di un allarme Amazon CloudWatch denominato “myalarm” e impostarlo sullo stato ALARM per scopi 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.

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 Guida per l’utente di Amazon CloudWatch.

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 Guida per l’utente di Amazon CloudWatch.

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 Tagging your Amazon CloudWatch resources nella Guida per l’utente di Amazon CloudWatch.

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 Tagging your Amazon CloudWatch resources nella Guida per l’utente di Amazon CloudWatch.