AWS CLI를 사용하는 CloudWatch 예제

다음 코드 예제에서는 CloudWatch에서 AWS Command Line Interface를 사용하여 작업을 수행하고 일반적인 시나리오를 구현하는 방법을 보여 줍니다.

작업은 대규모 프로그램에서 발췌한 코드이며 컨텍스트에 맞춰 실행해야 합니다. 작업은 관련 시나리오의 컨텍스트에 따라 표시되며, 개별 서비스 함수를 직접적으로 호출하는 방법을 보여줍니다.

각 예시에는 전체 소스 코드에 대한 링크가 포함되어 있으며, 여기에서 컨텍스트에 맞춰 코드를 설정하고 실행하는 방법에 대한 지침을 찾을 수 있습니다.

작업

delete-alarms

다음 코드 예시는 delete-alarms의 사용 방법을 보여 줍니다.

AWS CLI

경보를 삭제하는 방법

다음 예제에서는 delete-alarms 명령을 사용하여 'myalarm'이라는 Amazon CloudWatch 경보를 삭제합니다.

aws cloudwatch delete-alarms --alarm-names myalarm

출력:

This command returns to the prompt if successful.

• API 세부 정보는 AWS CLI Command Reference의 DeleteAlarms를 참조하세요.

delete-anomaly-detector

다음 코드 예시는 delete-anomaly-detector의 사용 방법을 보여 줍니다.

AWS CLI

지정된 이상 탐지 모델을 삭제하려면 다음을 수행합니다.

다음 delete-anomaly-detector 예제에서는 지정된 계정에서 이상 탐지기 모델을 삭제합니다.

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

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 Amazon CloudWatch 사용 설명서의 이상 탐지 모델 삭제 섹션을 참조하세요.

• API 세부 정보는 AWS CLI 명령 참조의 DeleteAnomalyDetector을 참조하세요.

delete-dashboards

다음 코드 예시는 delete-dashboards의 사용 방법을 보여 줍니다.

AWS CLI

지정된 대시보드를 삭제하려면 다음을 수행합니다.

다음 delete-dashboards 예제에서는 지정된 계정에서 Dashboard-A 및 Dashboard-B라는 대시보드 2개를 삭제합니다.

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

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 Amazon CloudWatch 사용 설명서의 Amazon CloudWatch 대시보드 사용 섹션을 참조하세요.

• API 세부 정보는 AWS CLI 명령 참조의 DeleteDashboards를 참조하세요.

delete-insight-rules

다음 코드 예시는 delete-insight-rules의 사용 방법을 보여 줍니다.

AWS CLI

지정된 Contributor Insights 규칙을 삭제하려면

다음 delete-insight-rules 예제에서는 지정된 계정에서 Rule-A 및 Rule-B라는 Contributor Insights 2개를 삭제합니다.

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

출력:

{
    "Failures": []
}

자세한 내용을 알아보려면 Amazon CloudWatch 사용 설명서의 Contributor Insights를 사용하여 카디널리티가 높은 데이터 분석하기를 참조하세요.

• API 세부 정보는 AWS CLI 명령 참조의 DeleteInsightRules를 참조하세요.

delete-metric-stream

다음 코드 예시는 delete-metric-stream의 사용 방법을 보여 줍니다.

AWS CLI

지정된 지표 스트림을 삭제하려면

다음 delete-metric-stream 예제에서는 지정된 계정에서 QuickPartial-gSCKvO라는 지표 스트림를 삭제합니다.

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

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 Amazon CloudWatch 사용 설명서의 지표 스트림 사용 섹션을 참조하세요.

• API 세부 정보는 AWS CLI 명령 참조의 DeleteMetricStream를 참조하세요.

describe-alarm-history

다음 코드 예시는 describe-alarm-history의 사용 방법을 보여 줍니다.

AWS CLI

경보에 대한 기록을 검색하는 방법

다음 예제에서는 describe-alarm-history 명령을 사용하여 'myalarm'이라는 Amazon CloudWatch 경보에 대한 기록을 검색합니다.

aws cloudwatch describe-alarm-history --alarm-name "myalarm" --history-item-type StateUpdate

출력:

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

• API 세부 정보는 AWS CLI Command Reference의 DescribeAlarmHistory를 참조하세요.

describe-alarms-for-metric

다음 코드 예시는 describe-alarms-for-metric의 사용 방법을 보여 줍니다.

AWS CLI

지표와 관련된 경보에 대한 정보를 표시하는 방법

다음 예제에서는 describe-alarms-for-metric 명령을 사용하여 Amazon EC2 CPUUtilization 지표 및 ID i-0c986c72의 인스턴스와 관련된 모든 경보에 대한 정보를 표시합니다.

aws cloudwatch describe-alarms-for-metric --metric-name CPUUtilization --namespace AWS/EC2 --dimensions Name=InstanceId,Value=i-0c986c72

출력:

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

• API 세부 정보는 AWS CLI Command Reference의 DescribeAlarmsForMetric을 참조하세요.

describe-alarms

다음 코드 예시는 describe-alarms의 사용 방법을 보여 줍니다.

AWS CLI

경보에 대한 정보를 나열하는 방법

다음 예제에서는 describe-alarms 명령을 사용하여 'myalarm'이라는 경보에 대한 정보를 제공합니다.

aws cloudwatch describe-alarms --alarm-names "myalarm"

출력:

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

• API 세부 정보는 AWS CLI Command Reference의 DescribeAlarms를 참조하세요.

describe-anomaly-detectors

다음 코드 예시는 describe-anomaly-detectors의 사용 방법을 보여 줍니다.

AWS CLI

이상 탐지 모델 목록을 검색하려면 다음을 수행합니다.

다음 describe-anomaly-detectors 예제에서는 지정된 계정의 AWS/Logs 네임스페이스와 연결된 이상 탐지기 모델에 대한 정보를 표시합니다.

aws cloudwatch describe-anomaly-detectors \
    --namespace AWS/Logs

출력:

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

자세한 내용은 Amazon CloudWatch 사용 설명서의 CloudWatch 이상 탐지 사용 섹션을 참조하세요.

• API 세부 정보는 AWS CLI 명령 참조의 DescribeAnomalyDetectors를 참조하세요.

describe-insight-rules

다음 코드 예시는 describe-insight-rules의 사용 방법을 보여 줍니다.

AWS CLI

Contributor Insights 규칙 목록을 검색하려면

다음 describe-insight-rules 예제에서는 지정된 계정의 모든 Contributor Insight 규칙을 보여줍니다.

aws cloudwatch describe-insight-rules

출력:

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

자세한 내용을 알아보려면 Amazon CloudWatch 사용 설명서의 Contributor Insights를 사용하여 카디널리티가 높은 데이터 분석하기를 참조하세요.

• API 세부 정보는 AWS CLI 명령 참조의 DescribeInsightRules를 참조하세요.

disable-alarm-actions

다음 코드 예시는 disable-alarm-actions의 사용 방법을 보여 줍니다.

AWS CLI

경보에 대한 작업을 비활성화하는 방법

다음 예제에서는 disable-alarm-actions 명령을 사용하여 myalarm이라는 경보에 대한 모든 작업을 비활성화합니다.

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

이 명령은 성공하면 프롬프트로 돌아갑니다.

• API 세부 정보는 AWS CLI Command Reference의 DisableAlarmActions를 참조하세요.

disable-insight-rules

다음 코드 예시는 disable-insight-rules의 사용 방법을 보여 줍니다.

AWS CLI

지정된 Contributor Insight 규칙을 비활성화하려면

다음 disable-insight-rules 예제에서는 지정된 계정에서 Rule-A 및 Rule-B라는 두 개의 Contributor Insight 규칙을 비활성화합니다.

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

출력:

{
    "Failures": []
}

자세한 내용을 알아보려면 Amazon CloudWatch 사용 설명서의 Contributor Insights를 사용하여 카디널리티가 높은 데이터 분석하기를 참조하세요.

• API 세부 정보는 AWS CLI 명령 참조의 DisableInsightRules를 참조하세요.

enable-alarm-actions

다음 코드 예시는 enable-alarm-actions의 사용 방법을 보여 줍니다.

AWS CLI

경보에 대한 모든 작업을 활성화하는 방법

다음 예제에서는 enable-alarm-actions 명령을 사용하여 myalarm이라는 경보에 대한 모든 작업을 활성화합니다.

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

이 명령은 성공하면 프롬프트로 돌아갑니다.

• API 세부 정보는 AWS CLI Command Reference의 EnableAlarmActions를 참조하세요.

enable-insight-rules

다음 코드 예시는 enable-insight-rules의 사용 방법을 보여 줍니다.

AWS CLI

지정된 Contributor Insight 규칙을 활성화하려면

다음 enable-insight-rules 예제에서는 지정된 계정에서 Rule-A 및 Rule-B라는 Contributor Insight 2개를 활성화합니다.

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

출력:

{
    "Failures": []
}

자세한 내용을 알아보려면 Amazon CloudWatch 사용 설명서의 Contributor Insights를 사용하여 카디널리티가 높은 데이터 분석하기를 참조하세요.

• API 세부 정보는 AWS CLI 명령 참조의 EnableInsightRules를 참조하세요.

get-dashboard

다음 코드 예시는 get-dashboard의 사용 방법을 보여 줍니다.

AWS CLI

대시보드에 대한 정보 검색

다음 get-dashboard 예제는 특정 계정에서 Dashboard-A라는 대시보드에 대한 정보를 표시합니다.

aws cloudwatch get-dashboard \
    --dashboard-name Dashboard-A

출력:

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

자세한 내용은 Amazon CloudWatch 사용 설명서의 Amazon CloudWatch 대시보드 사용 섹션을 참조하세요.

• API 세부 정보는 AWS CLI 명령 참조의 GetDashboard를 참조하세요.

get-insight-rule-report

다음 코드 예시는 get-insight-rule-report의 사용 방법을 보여 줍니다.

AWS CLI

Contributor Insights 규칙에서 수집한 시계열 데이터를 검색하려면

다음 get-insight-rule-report 예제에서는 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

출력:

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

자세한 내용을 알아보려면 Amazon CloudWatch 사용 설명서의 Contributor Insights를 사용하여 카디널리티가 높은 데이터 분석하기를 참조하세요.

• API 세부 정보는 AWS CLI 명령 참조의 GetInsightRuleReport를 참조하세요.

get-metric-data

다음 코드 예시는 get-metric-data의 사용 방법을 보여 줍니다.

AWS CLI

예제 1: 수학 표현식을 사용하여 지정된 EC2의 평균 총 IOPS를 가져오려면

다음 get-metric-data 예제에서는 EBSReadOps 및 지표를 결합하는 지표 수학 확장을 i-abcdef 사용하여 InstanceID가 있는 EC2 인스턴스에 대한 CloudWatch 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

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

출력:

{
    "MetricDataResults": [
        {
            "Id": "m3",
            "Label": "Avg Total IOPS",
            "Timestamps": [
                "2024-09-29T22:10:00+00:00"
            ],
            "Values": [
                96.85
            ],
            "StatusCode": "Complete"
        }
    ],
    "Messages": []
}

예제 2: CloudWatch 결제 지표를 사용하여 예상 AWS 요금을 모니터링하려면 다음을 수행합니다.

다음 get-metric-data 예제에서는 AWS/Billing 네임스페이스에서 EstimatedCharges CloudWatch 지표를 검색합니다.

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

출력:

{
    "MetricDataResults": [
        {
            "Id": "m1",
            "Label": "EstimatedCharges",
            "Timestamps": [
                "2024-09-26T12:00:00+00:00"
            ],
            "Values": [
                542.38
            ],
            "StatusCode": "Complete"
        }
    ],
    "Messages": []
}

자세한 내용은 Amazon CloudWatch 사용 설명서에서 CloudWatch 지표에 수학 표현식 사용을 참조하세요.

• API 세부 정보는 AWS CLI 명령 참조의 GetMetricData를 참조하세요.

get-metric-statistics

다음 코드 예시는 get-metric-statistics의 사용 방법을 보여 줍니다.

AWS CLI

EC2 인스턴스별 CPU 사용률을 가져오는 방법

다음 예제에서는 get-metric-statistics 명령을 사용하여 ID i-abcdef의 EC2 인스턴스에 대한 CPU 사용률을 가져옵니다.

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

출력:

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

여러 측정기준을 지정하는 방법

다음 예제는 여러 측정기준을 지정하는 방법을 보여줍니다. 각 측정기준은 이름과 값 사이에 쉼표가 있는 이름/값 페어로 지정됩니다. 여러 측정기준은 공백으로 구분됩니다. 단일 지표에 여러 개의 측정기준이 포함된 경우에는 정의된 모든 측정기준에 대해 값을 지정해야 합니다.

get-metric-statistics 명령을 사용하는 더 많은 예시는 Amazon CloudWatch 개발자 안내서의 지표에 대한 통계 얻기를 참조하세요.

aws cloudwatch get-metric-statistics --metric-name Buffers --namespace MyNameSpace --dimensions Name=InstanceID,Value=i-abcdef Name=InstanceType,Value=m1.small --start-time 2016-10-15T04:00:00Z --end-time 2016-10-19T07:00:00Z --statistics Average --period 60

• API 세부 정보는 AWS CLI Command Reference의 GetMetricStatistics를 참조하세요.

get-metric-stream

다음 코드 예시는 get-metric-stream의 사용 방법을 보여 줍니다.

AWS CLI

지표 스트림에 대한 정보를 검색하려면

다음 get-metric-stream 예제는 지정된 계정에서 QuickFull-GuaFbs라는 지표 스트림에 대한 정보를 표시합니다.

aws cloudwatch get-metric-stream \
    --name QuickFull-GuaFbs

출력:

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

자세한 내용은 Amazon CloudWatch 사용 설명서의 지표 스트림 사용 섹션을 참조하세요.

• API 세부 정보는 AWS CLI 명령 참조의 GetMetricStream을 참조하세요.

get-metric-widget-image

다음 코드 예시는 get-metric-widget-image의 사용 방법을 보여 줍니다.

AWS CLI

CPUUtilization의 스냅샷 그래프를 검색하려면 다음을 수행합니다.

다음 get-metric-widget-image 예제에서는 ID가 i-abcde인 EC2 인스턴스의 지표 CPUUtilization에 대한 스냅샷 그래프를 검색하고, 검색된 이미지를 로컬 시스템에 ‘image.png’라는 파일로 저장합니다.

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

이 명령은 출력을 생성하지 않습니다.

• API 세부 정보는 AWS CLI 명령 참조의 GetMetricWidgetImage를 참조하세요.

list-dashboards

다음 코드 예시는 list-dashboards의 사용 방법을 보여 줍니다.

AWS CLI

대시보드 목록을 검색하려면 다음을 수행합니다.

다음 list-dashboards 예제에서는 지정된 계정의 모든 대시보드를 나열합니다.

aws cloudwatch list-dashboards

출력:

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

자세한 내용은 Amazon CloudWatch 사용 설명서의 Amazon CloudWatch 대시보드 사용 섹션을 참조하세요.

• API 세부 정보는 AWS CLI 명령 참조의 ListDashboards 섹션을 참조하세요.

list-metric-streams

다음 코드 예시는 list-metric-streams의 사용 방법을 보여 줍니다.

AWS CLI

지표 스트림 목록을 검색하려면

다음 list-metric-streams 예제에서는 지정된 계정의 모든 지표 스트림을 나열합니다.

aws cloudwatch list-metric-streams

출력:

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

자세한 내용은 Amazon CloudWatch 사용 설명서의 지표 스트림 사용 섹션을 참조하세요.

• API 세부 정보는 AWS CLI 명령 참조의 ListMetricStreams를 참조하세요.

list-metrics

다음 코드 예시는 list-metrics의 사용 방법을 보여 줍니다.

AWS CLI

Amazon SNS에 대한 지표를 나열하는 방법

다음 list-metrics 예제는 Amazon SNS에 대한 지표를 표시합니다.

aws cloudwatch list-metrics \
    --namespace "AWS/SNS"

출력:

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

• API 세부 정보는 AWS CLI Command Reference의 ListMetrics를 참조하세요.

list-tags-for-resource

다음 코드 예시는 list-tags-for-resource의 사용 방법을 보여 줍니다.

AWS CLI

기존 경보와 연결된 태그를 나열하려면*

다음 list-tags-for-resource 예제에서는 지정된 계정에서 demo라는 경보와 연결된 모든 태그를 나열합니다.

aws cloudwatch list-tags-for-resource \
    --resource-arn arn:aws:cloudwatch:us-east-1:123456789012:alarm:demo

출력:

{
    "Tags": [
        {
            "Key": "stack",
            "Value": "Production"
        },
        {
            "Key": "team",
            "Value": "Devops"
        }
    ]
}

자세한 내용은 Amazon CloudWatch 사용 설명서의 경보 및 태그 지정을 참조하세요.

• API 세부 정보는 AWS CLI 명령 참조의 ListTagsForResource를 참조하세요.

put-anomaly-detector

다음 코드 예시는 put-anomaly-detector의 사용 방법을 보여 줍니다.

AWS CLI

이상 탐지 모델을 생성하려면 다음을 수행합니다.

다음 put-anomaly-detector 예제에서는 CloudWatch 지표에 대한 이상 탐지 모델을 생성합니다.

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

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 Amazon CloudWatch 사용 설명서의 CloudWatch 이상 탐지 사용 섹션을 참조하세요.

• API 세부 정보는 AWS CLI 명령 참조의 PutAnomalyDetector를 참조하세요.

put-composite-alarm

다음 코드 예시는 put-composite-alarm의 사용 방법을 보여 줍니다.

AWS CLI

복합 CloudWatch 경보를 생성하려면

다음 put-composite-alarm 예제에서는 지정된 계정에 ProdAlarm이라는 복합 경보를 생성합니다.

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

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 Amazon CloudWatch 사용 설명서의 복합 경보 생성 섹션을 참조하세요.

• API 세부 정보는 AWS CLI 명령 참조의 PutCompositeAlarm을 참조하세요.

put-dashboard

다음 코드 예시는 put-dashboard의 사용 방법을 보여 줍니다.

AWS CLI

대시보드 생성

다음 put-dashboard 예제에서는 지정된 계정에 Dashboard-A라는 대시보드를 생성합니다.

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

출력:

{
    "DashboardValidationMessages": []
}

자세한 내용은 Amazon CloudWatch 사용 설명서의 Amazon CloudWatch 경보 생성 섹션을 참조하세요.

• API 세부 정보는 AWS CLI 명령 참조의 PutDashboard를 참조하세요.

put-insight-rule

다음 코드 예시는 put-insight-rule의 사용 방법을 보여 줍니다.

AWS CLI

Contributor Insights 규칙을 생성하려면

다음 put-insight-rule 예제에서는 지정된 계정에서 VPCFlowLogsContributorInsights라는 Contributor Insight 규칙을 생성합니다.

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

insight-rule.json의 콘텐츠:

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

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 Amazon CloudWatch 사용 설명서의 CloudWatch에서 Contributor Insights 규칙 생성을 참조하세요.

• API 세부 정보는 AWS CLI 명령 참조의 PutInsightRule을 참조하세요.

put-metric-alarm

다음 코드 예시는 put-metric-alarm의 사용 방법을 보여 줍니다.

AWS CLI

CPU 사용률이 70%를 초과할 때 Amazon Simple Notification Service 이메일 메시지 보내기

다음 예제에서는 put-metric-alarm 명령을 사용하여 CPU 사용률이 70%를 초과할 때 Amazon Simple Notification Service 이메일 메시지를 보냅니다.

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

이 명령은 성공하면 프롬프트로 돌아갑니다. 같은 이름의 경보가 이미 있는 경우 새 경보가 해당 경보를 덮어씁니다.

여러 측정기준을 지정하는 방법

다음 예제는 여러 측정기준을 지정하는 방법을 보여줍니다. 각 측정기준은 이름과 값 사이에 쉼표가 있는 이름/값 페어로 지정됩니다. 여러 측정기준은 공백으로 구분됩니다.

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

• API 세부 정보는 AWS CLI 명령 참조의 PutMetricAlarm을 참조하세요.

put-metric-data

다음 코드 예시는 put-metric-data의 사용 방법을 보여 줍니다.

AWS CLI

Amazon CloudWatch에 사용자 지정 지표를 게시하는 방법

다음 예제에서는 put-metric-data 명령을 사용하여 Amazon CloudWatch에 사용자 지정 지표를 게시합니다.

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

지표 자체의 값은 JSON 파일인 metric.json에 저장됩니다.

해당 파일의 내용은 다음과 같습니다.

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

자세한 내용은 Amazon CloudWatch 개발자 안내서의 사용자 지정 지표 게시를 참조하세요.

여러 측정기준을 지정하는 방법

다음 예제는 여러 측정기준을 지정하는 방법을 보여줍니다. 각 측정기준은 이름=값 페어로 지정됩니다. 여러 측정기준은 쉼표로 구분됩니다.

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

• API 세부 정보는 AWS CLI Command Reference의 PutMetricData를 참조하세요.

put-metric-stream

다음 코드 예시는 put-metric-stream의 사용 방법을 보여 줍니다.

AWS CLI

지표 스트림을 생성하려면

다음 put-metric-stream 예제에서는 지정된 계정에 QuickFull-GuaFb라는 지표 스트림을 생성합니다.

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

출력:

{
    "Arn": "arn:aws:cloudwatch:us-east-1:123456789012:metric-stream/QuickFull-GuaFbs"
}

자세한 내용은 Amazon CloudWatch 사용 설명서의 지표 스트림 설정 섹션을 참조하세요.

• API 세부 정보는 AWS CLI 명령 참조의 PutMetricStream을 참조하세요.

set-alarm-state

다음 코드 예시는 set-alarm-state의 사용 방법을 보여 줍니다.

AWS CLI

경보 상태를 일시적으로 변경하는 방법

다음 예제에서는 set-alarm-state 명령을 사용하여 'myalarm'이라는 Amazon CloudWatch 경보의 상태를 일시적으로 변경하고 테스트 목적으로 ALARM 상태로 설정합니다.

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

이 명령은 성공하면 프롬프트로 돌아갑니다.

• API 세부 정보는 AWS CLI 명령 참조의 SetAlarmState를 참조하세요.

start-metric-streams

다음 코드 예시는 start-metric-streams의 사용 방법을 보여 줍니다.

AWS CLI

지정된 지표 스트림을 시작하려면

다음 start-metric-streams 예제에서는 지정된 계정에서 QuickFull-GuaFbs라는 지표 스트림을 시작합니다.

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

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 Amazon CloudWatch 사용 설명서의 지표 스트림 사용 섹션을 참조하세요.

• API 세부 정보는 AWS CLI 명령 참조의 StartMetricStreams를 참조하세요.

stop-metric-streams

다음 코드 예시는 stop-metric-streams의 사용 방법을 보여 줍니다.

AWS CLI

지정된 지표 스트림을 중지하려면

다음 stop-metric-streams 예제에서는 지정된 계정에서 QuickFull-GuaFbs라는 지표 스트림을 중지합니다.

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

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 Amazon CloudWatch 사용 설명서의 지표 스트림 사용 섹션을 참조하세요.

• API 세부 정보는 AWS CLI 명령 참조의 StopMetricStreams를 참조하세요.

tag-resource

다음 코드 예시는 tag-resource의 사용 방법을 보여 줍니다.

AWS CLI

지정된 리소스에 하나 이상의 태그를 추가하려면

다음 tag-resource 예제에서는 지정된 계정에서 이름이 demo인 Cloudwatch 경보에 태그 2개를 추가합니다.

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

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 Amazon CloudWatch 사용 설명서에서 Amazon CloudWatch 리소스 태깅을 참조하세요.

• API 세부 정보는 AWS CLI 명령 참조의 TagResource를 참조하세요.

untag-resource

다음 코드 예시는 untag-resource의 사용 방법을 보여 줍니다.

AWS CLI

지정된 리소스에서 하나 이상의 태그를 제거하려면

다음 untag-resource 예제에서는 지정된 계정에서 이름이 demo인 Cloudwatch 경보에서 태그 2개를 제거합니다.

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

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 Amazon CloudWatch 사용 설명서에서 Amazon CloudWatch 리소스 태깅을 참조하세요.

• API 세부 정보는 AWS CLI 명령 참조의 UntagResource를 참조하세요.