CloudWatch esempi di utilizzo 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.

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 User Guide. CloudWatch

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 le CloudWatch dashboard di Amazon nella Amazon User Guide. 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 per analizzare i dati ad alta cardinalità nella Amazon User Guide. 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 stream nella Amazon User Guide. CloudWatch

Come recuperare la cronologia di un allarme

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

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

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

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

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 User Guide. 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 per analizzare i dati ad alta cardinalità nella Amazon User Guide. CloudWatch

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.

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 per analizzare i dati ad alta cardinalità nella Amazon User Guide. CloudWatch

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.

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 per analizzare dati ad alta cardinalità nella Amazon User Guide. CloudWatch

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 le CloudWatch dashboard di Amazon nella Amazon CloudWatch User Guide.

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 per analizzare i dati ad alta cardinalità nella Amazon User Guide. CloudWatch

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

L'get-metric-dataesempio seguente recupera i valori delle CloudWatch metriche per l'istanza EC2 con i-abcdef InstanceID utilizzando un'espressione matematica metrica che combina metriche 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 le metriche di fatturazione AWS CloudWatch

L'get-metric-dataesempio seguente recupera la EstimatedCharges CloudWatch metrica dallo spazio dei nomi 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 Amazon User Guide. CloudWatch

Come ottenere ’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 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

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 stream nella Amazon User Guide. 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 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 le CloudWatch dashboard di Amazon nella Amazon User Guide. 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 Amazon User Guide. CloudWatch

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

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 Amazon CloudWatch User Guide.

Come creare un modello di rilevamento delle anomalie

L'put-anomaly-detectoresempio 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 Amazon CloudWatch User Guide.

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 Amazon User Guide. CloudWatch

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 Creazione di una CloudWatch dashboard nella Amazon CloudWatch User Guide.

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 regola Create a Contributor Insights nella CloudWatch Amazon User Guide. CloudWatch

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

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

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 metriche nella Amazon User Guide. CloudWatch

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.

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 User Guide. 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 Amazon User Guide. 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 Amazon CloudWatch User Guide.

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 Amazon CloudWatch User Guide.