View a markdown version of this page

CloudWatch contoh menggunakan AWS CLI - AWS Command Line Interface
Tindakan

Dokumentasi ini AWS CLI hanya untuk Versi 1.

Kami mengumumkan akhir dukungan yang akan datang untuk AWS CLI versi 1. Kami menyarankan Anda bermigrasi ke AWS CLI versi 2. Untuk tanggal, detail tambahan, dan informasi tentang cara bermigrasi, lihat pengumuman. Untuk dokumentasi yang terkait dengan Versi 2 AWS CLI, lihat Panduan Pengguna Versi 2.

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

CloudWatch contoh menggunakan AWS CLI

Contoh kode berikut menunjukkan cara melakukan tindakan dan menerapkan 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.

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 DeleteAlarms di Refer AWS CLI ensi 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 CloudWatch Pengguna Amazon.

Contoh kode berikut menunjukkan cara menggunakandelete-dashboards.

AWS CLI

Untuk menghapus dasbor tertentu

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.

Contoh kode berikut menunjukkan cara menggunakandelete-insight-rules.

AWS CLI

Untuk menghapus aturan wawasan kontributor tertentu

delete-insight-rulesContoh berikut menghapus dua aturan wawasan 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 CloudWatch Pengguna Amazon.

Contoh kode berikut menunjukkan cara menggunakandelete-metric-stream.

AWS CLI

Untuk menghapus aliran metrik tertentu

delete-metric-streamContoh berikut menghapus aliran metrik yang dinamai 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.

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

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 perintah describe-alarms-for-metric untuk menampilkan informasi tentang setiap alarm yang terkait dengan metrik CPUUutilization Amazon EC2 dan instans 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"
        }
    ]
}

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

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 Panduan CloudWatch Pengguna Amazon.

Contoh kode berikut menunjukkan cara menggunakandescribe-insight-rules.

AWS CLI

Untuk mengambil daftar aturan Insights Contributor

describe-insight-rulesContoh berikut menunjukkan semua aturan Insight Kontributor 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 CloudWatch Pengguna Amazon.

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.

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 CloudWatch Pengguna Amazon.

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.

Contoh kode berikut menunjukkan cara menggunakanenable-insight-rules.

AWS CLI

Untuk mengaktifkan aturan wawasan kontributor tertentu

enable-insight-rulesContoh berikut mengaktifkan 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 CloudWatch Pengguna Amazon.

Contoh kode berikut menunjukkan cara menggunakanget-dashboard.

AWS CLI

Untuk mengambil informasi tentang Dasbor

get-dashboardContoh berikut menampilkan informasi tentang dasbor yang dinamai Dashboard-A di 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 GetDashboard di Refer AWS CLI ensi 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 CloudWatch Pengguna Amazon.

Contoh kode berikut menunjukkan cara menggunakanget-metric-data.

AWS CLI

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

get-metric-dataContoh berikut mengambil nilai CloudWatch metrik untuk instance EC2 dengan InstanceID i-abcdef menggunakan ekspresi 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 dari AWS/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.

Contoh kode berikut menunjukkan cara menggunakanget-metric-statistics.

AWS CLI

Cara mendapatkan pemanfaatan CPU per instans EC2

Contoh berikut menggunakan perintah get-metric-statistics untuk mendapatkan pemanfaatan CPU untuk instans EC2 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 nilai. 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 selengkapnya menggunakan get-metric-statistics perintah, lihat Dapatkan 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

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 yang dinamai QuickFull-GuaFbs di 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.

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 instance EC2 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.

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.

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.

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 ListMetrics di Refer AWS CLI ensi 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 yang dinam demo ai 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 penand aan di Panduan CloudWatch Pengguna Amazon.

Contoh kode berikut menunjukkan cara menggunakanput-anomaly-detector.

AWS CLI

Untuk membuat model deteksi anomali

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

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 Panduan CloudWatch Pengguna Amazon.

Contoh kode berikut menunjukkan cara menggunakanput-composite-alarm.

AWS CLI

Untuk membuat alarm cloudwatch komposit

put-composite-alarmContoh berikut membuat alarm komposit bernama ProdAlarm di 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.

Contoh kode berikut menunjukkan cara menggunakanput-dashboard.

AWS CLI

Untuk membuat dasbor

put-dashboardContoh berikut membuat dasbor bernama Dashboard-A di 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 PutDashboard di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanput-insight-rule.

AWS CLI

Untuk membuat aturan wawasan kontributor

put-insight-ruleContoh berikut membuat aturan Wawasan Kontributor yang dinam VPCFlowLogsContributorInsights ai 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 Panduan CloudWatch Pengguna Amazon.

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

Contoh berikut menggambarkan cara menentukan beberapa dimensi. Setiap dimensi ditentukan sebagai Name/Value pasangan, dengan koma antara nama dan nilai. Beberapa dimensi dipisahkan dengan satu spasi:

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

Contoh kode berikut menunjukkan cara menggunakanput-metric-data.

AWS CLI

Untuk menerbitkan metrik khusus ke Amazon CloudWatch

Contoh berikut menggunakan put-metric-data perintah untuk menerbitkan metrik khusus 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

Contoh kode berikut menunjukkan cara menggunakanput-metric-stream.

AWS CLI

Untuk membuat aliran metrik

put-metric-streamContoh berikut membuat aliran metrik bernama QuickFull-GuaFb di akun yang ditentukan.

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 Menyiapkan aliran metrik di Panduan CloudWatch Pengguna Amazon.

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.

Contoh kode berikut menunjukkan cara menggunakanstart-metric-streams.

AWS CLI

Untuk memulai aliran metrik tertentu

start-metric-streamsContoh berikut memulai aliran metrik yang dinamai QuickFull-GuaFbs di 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.

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

Contoh kode berikut menunjukkan cara menggunakantag-resource.

AWS CLI

Untuk menambahkan satu atau lebih tag ke sumber daya yang ditentukan

tag-resourceContoh berikut menambahkan 2 tag ke alarm cloudwatch yang dinamai 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 TagResource di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanuntag-resource.

AWS CLI

Untuk menghapus satu atau lebih tag dari sumber daya yang ditentukan

untag-resourceContoh berikut menghapus 2 tag dari alarm cloudwatch yang dinamai 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.