CloudWatch contoh menggunakan AWS CLI

Contoh kode berikut menunjukkan cara melakukan tindakan dan mengimplementasikan skenario umum dengan menggunakan AWS Command Line Interface with CloudWatch.

Tindakan merupakan kutipan kode dari program yang lebih besar dan harus dijalankan dalam konteks. Sementara tindakan menunjukkan cara memanggil fungsi layanan individual, Anda dapat melihat tindakan dalam konteks dalam skenario terkait.

Setiap contoh menyertakan tautan ke kode sumber lengkap, di mana Anda dapat menemukan instruksi tentang cara mengatur dan menjalankan kode dalam konteks.

Topik

Tindakan

Tindakan

Contoh kode berikut menunjukkan cara menggunakandelete-alarms.

AWS CLI

Cara menghapus sebuah alarm

Contoh berikut menggunakan delete-alarms perintah untuk menghapus CloudWatch alarm Amazon bernama “myalarm”:


aws cloudwatch delete-alarms --alarm-names myalarm

Output:


This command returns to the prompt if successful.

Untuk detail API, lihat DeleteAlarmsdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakandelete-anomaly-detector.

AWS CLI

Untuk menghapus model deteksi anomali tertentu

delete-anomaly-detectorContoh berikut menghapus model detektor anomali di akun yang ditentukan.


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

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Menghapus model deteksi anomali di Panduan Pengguna Amazon CloudWatch .

Untuk detail API, lihat DeleteAnomalyDetectordi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakandelete-dashboards.

AWS CLI

Untuk menghapus dasbor yang ditentukan

delete-dashboardsContoh berikut menghapus dua dasbor bernama Dashboard-A dan Dashboard-B di akun yang ditentukan.


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

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat CloudWatch dasbor Amazon di Panduan CloudWatch Pengguna Amazon.

Untuk detail API, lihat DeleteDashboardsdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakandelete-insight-rules.

AWS CLI

Untuk menghapus aturan wawasan kontributor yang ditentukan

delete-insight-rulesContoh berikut menghapus dua aturan insight kontributor bernama Rule-A dan Rule-B di akun yang ditentukan.


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

Output:


{
    "Failures": []
}

Untuk informasi selengkapnya, lihat Menggunakan Wawasan Kontributor untuk menganalisis data kardinalitas tinggi di Panduan Pengguna Amazon. CloudWatch

Untuk detail API, lihat DeleteInsightRulesdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakandelete-metric-stream.

AWS CLI

Untuk menghapus aliran metrik tertentu

delete-metric-streamContoh berikut menghapus aliran metrik bernama QuickPartial-gSCKvO di akun yang ditentukan.


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

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Menggunakan aliran metrik di Panduan CloudWatch Pengguna Amazon.

Untuk detail API, lihat DeleteMetricStreamdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakandescribe-alarm-history.

AWS CLI

Cara mengambil riwayat untuk sebuah alarm

Contoh berikut menggunakan describe-alarm-history perintah untuk mengambil riwayat untuk CloudWatch alarm Amazon bernama “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"
        }
    ]
}

Untuk detail API, lihat DescribeAlarmHistorydi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakandescribe-alarms-for-metric.

AWS CLI

Untuk menampilkan informasi tentang alarm-alarm yang terkait dengan sebuah metrik

Contoh berikut menggunakan describe-alarms-for-metric perintah untuk menampilkan informasi tentang alarm apa pun yang terkait dengan EC2 CPUUtilization metrik Amazon dan instance dengan 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"
        }
    ]
}

Untuk detail API, lihat DescribeAlarmsForMetricdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakandescribe-alarms.

AWS CLI

Cara membuat daftar informasi tentang sebuah alarm

Contoh berikut menggunakan perintah describe-alarms untuk memberikan informasi tentang alarm yang bernama "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"
        }
    ]
}

Untuk detail API, lihat DescribeAlarmsdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakandescribe-anomaly-detectors.

AWS CLI

Untuk mengambil daftar model deteksi anomali

describe-anomaly-detectorsContoh berikut menampilkan informasi tentang model detektor anomali yang terkait dengan AWS/Logs namespace di akun yang ditentukan.


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

Untuk informasi selengkapnya, lihat Menggunakan deteksi CloudWatch anomali di CloudWatch Panduan Pengguna Amazon.

Untuk detail API, lihat DescribeAnomalyDetectorsdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakandescribe-insight-rules.

AWS CLI

Untuk mengambil daftar aturan Contributor Insights

describe-insight-rulesContoh berikut menunjukkan semua aturan Contributor Insight di akun yang ditentukan.


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

Untuk informasi selengkapnya, lihat Menggunakan Wawasan Kontributor untuk menganalisis data kardinalitas tinggi di Panduan Pengguna Amazon. CloudWatch

Untuk detail API, lihat DescribeInsightRulesdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakandisable-alarm-actions.

AWS CLI

Cara menonaktifkan tindakan untuk sebuah alarm

Contoh berikut menggunakan perintah disable-alarm-actions untuk menonaktifkan semua tindakan untuk alarm bernama myalarm.:


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

Perintah ini akan kembali ke prompt jika berhasil.

Untuk detail API, lihat DisableAlarmActionsdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakandisable-insight-rules.

AWS CLI

Untuk menonaktifkan aturan wawasan kontributor tertentu

disable-insight-rulesContoh berikut menonaktifkan dua aturan wawasan kontributor bernama Rule-A dan Rule-B di akun yang ditentukan.


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

Output:


{
    "Failures": []
}

Untuk informasi selengkapnya, lihat Menggunakan Wawasan Kontributor untuk menganalisis data kardinalitas tinggi di Panduan Pengguna Amazon. CloudWatch

Untuk detail API, lihat DisableInsightRulesdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanenable-alarm-actions.

AWS CLI

Cara mengaktifkan semua tindakan untuk sebuah alarm

Contoh berikut menggunakan perintah enable-alarm-actions untuk mengaktifkan semua tindakan untuk alarm bernama myalarm.:


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

Perintah ini akan kembali ke prompt jika berhasil.

Untuk detail API, lihat EnableAlarmActionsdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanenable-insight-rules.

AWS CLI

Untuk mengaktifkan aturan wawasan kontributor yang ditentukan

enable-insight-rulesContoh berikut memungkinkan dua aturan wawasan kontributor bernama Rule-A dan Rule-B di akun yang ditentukan.


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

Output:


{
    "Failures": []
}

Untuk informasi selengkapnya, lihat Menggunakan Wawasan Kontributor untuk menganalisis data kardinalitas tinggi di Panduan Pengguna Amazon. CloudWatch

Untuk detail API, lihat EnableInsightRulesdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanget-dashboard.

AWS CLI

Untuk mengambil informasi tentang Dashboard

get-dashboardContoh berikut menampilkan informasi tentang dasbor bernama Dashboard-A dalam akun yang ditentukan.


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

Untuk informasi selengkapnya, lihat CloudWatch dasbor Amazon di Panduan CloudWatch Pengguna Amazon.

Untuk detail API, lihat GetDashboarddi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanget-insight-rule-report.

AWS CLI

Untuk mengambil data deret waktu yang dikumpulkan oleh aturan Contributor Insights

get-insight-rule-reportContoh berikut mengembalikan data deret waktu yang dikumpulkan oleh aturan 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": []
}

Untuk informasi selengkapnya, lihat Menggunakan Wawasan Kontributor untuk menganalisis data kardinalitas tinggi di Panduan Pengguna Amazon. CloudWatch

Untuk detail API, lihat GetInsightRuleReportdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanget-metric-data.

AWS CLI

Contoh 1: Untuk mendapatkan IOPS Total Rata-rata untuk ekspresi matematika yang ditentukan EC2 menggunakan

get-metric-dataContoh berikut mengambil nilai CloudWatch metrik untuk EC2 instance dengan i-abcdef InstanceId menggunakan exprssion matematika metrik yang menggabungkan dan metrik. 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

Isi dari 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": []
}

Contoh 2: Untuk memantau estimasi AWS biaya menggunakan metrik CloudWatch penagihan

get-metric-dataContoh berikut mengambil EstimatedCharges CloudWatch metrik AWS dari/Billing namespace.


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

Untuk informasi selengkapnya, lihat Menggunakan ekspresi matematika dengan CloudWatch metrik di Panduan CloudWatch Pengguna Amazon.

Untuk detail API, lihat GetMetricDatadi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanget-metric-statistics.

AWS CLI

Untuk mendapatkan pemanfaatan CPU per instance EC2

Contoh berikut menggunakan get-metric-statistics perintah untuk mendapatkan pemanfaatan CPU untuk sebuah EC2 instance dengan 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"
}

Menentukan beberapa dimensi

Contoh berikut menggambarkan cara menentukan beberapa dimensi. Setiap dimensi ditentukan sebagai Name/Value pasangan, dengan koma antara nama dan nilainya. Beberapa dimensi dipisahkan dengan satu spasi. Jika sebuah metrik mencakup beberapa dimensi, Anda harus menetapkan sebuah nilai untuk masing-masing dimensi yang ditetapkan.

Untuk contoh lainnya menggunakan get-metric-statistics perintah, lihat Mendapatkan Statistik untuk Metrik di Panduan CloudWatch Pengembang Amazon.


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

Untuk detail API, lihat GetMetricStatisticsdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanget-metric-stream.

AWS CLI

Untuk mengambil informasi tentang aliran metrik

get-metric-streamContoh berikut menampilkan informasi tentang aliran metrik bernama QuickFull-GuaFbs dalam akun yang ditentukan.


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
}

Untuk informasi selengkapnya, lihat Menggunakan aliran metrik di Panduan CloudWatch Pengguna Amazon.

Untuk detail API, lihat GetMetricStreamdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanget-metric-widget-image.

AWS CLI

Untuk mengambil grafik snapshot dari CPUUtilization

get-metric-widget-imageContoh berikut mengambil grafik snapshot untuk metrik CPUUtilization EC2 instance dengan ID i-abcde dan menyimpan gambar yang diambil sebagai file bernama "image.png" di mesin lokal Anda.


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

Perintah ini tidak menghasilkan output.

Untuk detail API, lihat GetMetricWidgetImagedi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanlist-dashboards.

AWS CLI

Untuk mengambil daftar Dasbor

list-dashboardsContoh berikut mencantumkan semua Dasbor di akun yang ditentukan.


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

Untuk informasi selengkapnya, lihat CloudWatch dasbor Amazon di Panduan CloudWatch Pengguna Amazon.

Untuk detail API, lihat ListDashboardsdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanlist-metric-streams.

AWS CLI

Untuk mengambil daftar aliran metrik

list-metric-streamsContoh berikut mencantumkan semua aliran metrik di akun yang ditentukan.


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

Untuk informasi selengkapnya, lihat Menggunakan aliran metrik di Panduan CloudWatch Pengguna Amazon.

Untuk detail API, lihat ListMetricStreamsdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanlist-metrics.

AWS CLI

Cara membuat daftar metrik untuk Amazon SNS

Contoh list-metrics berikut menampilkan metrik-metrik untuk 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"
        }
    ]
}

Untuk detail API, lihat ListMetricsdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanlist-tags-for-resource.

AWS CLI

Untuk membuat daftar tag yang terkait dengan alarm yang ada*

list-tags-for-resourceContoh berikut mencantumkan semua tag yang terkait dengan alarm bernama demo di akun yang ditentukan.


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

Untuk informasi selengkapnya, lihat Alarm dan penandaan di CloudWatch Panduan Pengguna Amazon.

Untuk detail API, lihat ListTagsForResourcedi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanput-anomaly-detector.

AWS CLI

Untuk membuat model deteksi anomali

put-anomaly-detectorContoh berikut membuat model deteksi anomali untuk metrik. CloudWatch


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

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Menggunakan deteksi CloudWatch anomali di CloudWatch Panduan Pengguna Amazon.

Untuk detail API, lihat PutAnomalyDetectordi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanput-composite-alarm.

AWS CLI

Untuk membuat alarm cloudwatch komposit

put-composite-alarmContoh berikut membuat alarm komposit bernama ProdAlarm dalam akun yang ditentukan.


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

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Membuat alarm komposit di Panduan CloudWatch Pengguna Amazon.

Untuk detail API, lihat PutCompositeAlarmdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanput-dashboard.

AWS CLI

Untuk membuat dasbor

put-dashboardContoh berikut membuat dasbor bernama Dashboard-A dalam akun yang ditentukan.


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

Untuk informasi selengkapnya, lihat Membuat CloudWatch dasbor di Panduan CloudWatch Pengguna Amazon.

Untuk detail API, lihat PutDashboarddi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanput-insight-rule.

AWS CLI

Untuk membuat aturan wawasan kontributor

put-insight-ruleContoh berikut membuat aturan Contributor Insights bernama VPCFlowLogsContributorInsights di akun yang ditentukan.


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

Isi dari insight-rule.json:


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

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Membuat aturan Wawasan Kontributor CloudWatch di CloudWatch Panduan Pengguna Amazon.

Untuk detail API, lihat PutInsightRuledi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanput-metric-alarm.

AWS CLI

Untuk mengirim sebuah pesan email Layanan Notifkasi Sederhana Amazon saat pemanfaatan CPU melebihi 70 persen

Contoh berikut menggunakan perintah put-metric-alarm untuk mengirim sebuah pesan email Amazon Simple Notification Service ketika penggunaan CPU melebihi 70 persen:


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

Perintah ini akan kembali ke prompt jika berhasil. Jika suatu alarm yang memiliki nama yang sama sudah ada, alarm itu akan ditimpa oleh alarm yang baru.

Cara menentukan beberapa dimensi


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

Untuk detail API, lihat PutMetricAlarmdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanput-metric-data.

AWS CLI

Untuk mempublikasikan metrik khusus ke Amazon CloudWatch

Contoh berikut menggunakan put-metric-data perintah untuk menerbitkan metrik kustom ke Amazon CloudWatch:


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

Nilai-nilai untuk metrik itu sendiri disimpan dalam file JSON, metric.json.

Berikut adalah isi dari file tersebut:


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

Untuk informasi selengkapnya, lihat Menerbitkan Metrik Kustom di Panduan CloudWatch Pengembang Amazon.

Cara menentukan beberapa dimensi

Contoh berikut menggambarkan cara menentukan beberapa dimensi. Masing-masing dimensi ditentukan sebagai sebuah pasangan Name=Value. Beberapa dimensi dipisahkan menggunakan koma.:


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

Untuk detail API, lihat PutMetricDatadi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanput-metric-stream.

AWS CLI

Untuk membuat aliran metrik

put-metric-streamContoh berikut membuat aliran metrik bernama QuickFull-GuaFb dalam akun tertentu.


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

Untuk informasi selengkapnya, lihat Mengatur aliran metrik di Panduan CloudWatch Pengguna Amazon.

Untuk detail API, lihat PutMetricStreamdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanset-alarm-state.

AWS CLI

Untuk sementara mengubah status alarm

Contoh berikut menggunakan set-alarm-state perintah untuk sementara mengubah status CloudWatch alarm Amazon bernama “myalarm” dan mengaturnya ke status ALARM untuk tujuan pengujian:


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

Perintah ini akan kembali ke prompt jika berhasil.

Untuk detail API, lihat SetAlarmStatedi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanstart-metric-streams.

AWS CLI

Untuk memulai aliran metrik tertentu

start-metric-streamsContoh berikut memulai aliran metrik bernama QuickFull-GuaFbs dalam akun yang ditentukan.


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

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Menggunakan aliran metrik di Panduan CloudWatch Pengguna Amazon.

Untuk detail API, lihat StartMetricStreamsdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanstop-metric-streams.

AWS CLI

Untuk menghentikan aliran metrik tertentu

stop-metric-streamsContoh berikut menghentikan aliran metrik yang dinamai QuickFull-GuaFbs dalam akun yang ditentukan.


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

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Menggunakan aliran metrik di Panduan CloudWatch Pengguna Amazon.

Untuk detail API, lihat StopMetricStreamsdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakantag-resource.

AWS CLI

Untuk menambahkan satu atau beberapa tag ke sumber daya yang ditentukan

tag-resourceContoh berikut menambahkan 2 tag ke alarm cloudwatch yang disebutkan demo di akun yang ditentukan.


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

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Menandai CloudWatch sumber daya Amazon Anda di Panduan CloudWatch Pengguna Amazon.

Untuk detail API, lihat TagResourcedi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanuntag-resource.

AWS CLI

Untuk menghapus satu atau beberapa tag dari sumber daya yang ditentukan

untag-resourceContoh berikut menghapus 2 tag dari alarm cloudwatch yang disebutkan demo di akun yang ditentukan.


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

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Menandai CloudWatch sumber daya Amazon Anda di Panduan CloudWatch Pengguna Amazon.

Untuk detail API, lihat UntagResourcedi Referensi AWS CLI Perintah.

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

CloudTrail

CloudWatch Log