Doc AWS SDK 예제 GitHub 리포지토리에서 더 많은 SDK 예제를 사용할 수 있습니다. [AWS](https://github.com/awsdocs/aws-doc-sdk-examples)
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 를 사용한 CloudWatch 예제 AWS CLI
다음 코드 예제에서는 CloudWatch와 AWS Command Line Interface 함께를 사용하여 작업을 수행하고 일반적인 시나리오를 구현하는 방법을 보여줍니다.
*작업*은 대규모 프로그램에서 발췌한 코드이며 컨텍스트에 맞춰 실행해야 합니다. 작업은 개별 서비스 함수를 직접적으로 호출하는 방법을 보여주며 관련 시나리오의 컨텍스트에 맞는 작업을 볼 수 있습니다.
각 예시에는 전체 소스 코드에 대한 링크가 포함되어 있으며, 여기에서 컨텍스트에 맞춰 코드를 설정하고 실행하는 방법에 대한 지침을 찾을 수 있습니다.
**Topics**
+ [작업](#actions)
## 작업
### `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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/delete-alarms.html)를 참조하세요.
### `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 사용 설명서*의 [이상 탐지 모델 삭제](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Create_Anomaly_Detection_Alarm.html#Delete_Anomaly_Detection_Model) 섹션을 참조하세요.
+ API 세부 정보는 **AWS CLI 명령 참조의 [DeleteAnomalyDetector](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/delete-anomaly-detector.html)을 참조하세요.
### `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 대시보드 사용](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html) 섹션을 참조하세요.
+ API 세부 정보는 **AWS CLI 명령 참조의 [DeleteDashboards](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/delete-dashboards.html)를 참조하세요.
### `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를 사용하여 카디널리티가 높은 데이터 분석하기](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ContributorInsights.html)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [DeleteInsightRules](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/delete-insight-rules.html)를 참조하세요.
### `delete-metric-stream`
다음 코드 예시는 `delete-metric-stream`의 사용 방법을 보여줍니다.
**AWS CLI**
**지정된 지표 스트림을 삭제하려면**
다음 `delete-metric-stream` 예제에서는 지정된 계정에서 `QuickPartial-gSCKvO`라는 지표 스트림을 삭제합니다.
```
aws cloudwatch delete-metric-stream \
--name QuickPartial-gSCKvO
```
이 명령은 출력을 생성하지 않습니다.
자세한 내용은 *Amazon CloudWatch 사용 설명서*의 [지표 스트림 사용](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Metric-Streams.html) 섹션을 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [DeleteMetricStream](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/delete-metric-stream.html)를 참조하세요.
### `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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/describe-alarm-history.html)를 참조하세요.
### `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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/describe-alarms-for-metric.html)을 참조하세요.
### `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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/describe-alarms.html)를 참조하세요.
### `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 이상 탐지 사용](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Anomaly_Detection.html) 섹션을 참조하세요.
+ API 세부 정보는 **AWS CLI 명령 참조의 [DescribeAnomalyDetectors](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/describe-anomaly-detectors.html)를 참조하세요.
### `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를 사용하여 카디널리티가 높은 데이터 분석하기](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ContributorInsights.html)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [DescribeInsightRules](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/describe-insight-rules.html)를 참조하세요.
### `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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/disable-alarm-actions.html)를 참조하세요.
### `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를 사용하여 카디널리티가 높은 데이터 분석하기](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ContributorInsights.html)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [DisableInsightRules](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/disable-insight-rules.html)를 참조하세요.
### `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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/enable-alarm-actions.html)를 참조하세요.
### `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를 사용하여 카디널리티가 높은 데이터 분석하기](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ContributorInsights.html)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [EnableInsightRules](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/enable-insight-rules.html)를 참조하세요.
### `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 대시보드 사용](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html) 섹션을 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [GetDashboard](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/get-dashboard.html)를 참조하세요.
### `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를 사용하여 카디널리티가 높은 데이터 분석하기](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ContributorInsights.html)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [GetInsightRuleReport](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/get-insight-rule-report.html)를 참조하세요.
### `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/청구 네임스페이스에서 `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 지표에 수학 표현식 사용](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/using-metric-math.html)을 참조하세요.
+ API 세부 정보는 **AWS CLI 명령 참조의 [GetMetricData](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/get-metric-data.html)를 참조하세요.
### `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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/get-metric-statistics.html)를 참조하세요.
### `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 사용 설명서*의 [지표 스트림 사용](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Metric-Streams.html) 섹션을 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [GetMetricStream](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/get-metric-stream.html)을 참조하세요.
### `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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/get-metric-widget-image.html)를 참조하세요.
### `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 대시보드 사용](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html) 섹션을 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [ListDashboards](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/list-dashboards.html) 섹션을 참조하세요.
### `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 사용 설명서*의 [지표 스트림 사용](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Metric-Streams.html) 섹션을 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [ListMetricStreams](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/list-metric-streams.html)를 참조하세요.
### `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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/list-metrics.html)를 참조하세요.
### `list-tags-for-resource`
다음 코드 예시는 `list-tags-for-resource`의 사용 방법을 보여줍니다.
**AWS CLI**
**기존 경보와 연결된 태그를 나열하려면\$1**
다음 `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 사용 설명서*의 [경보 및 태그 지정](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_alarms_and_tagging.html)을 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/list-tags-for-resource.html)를 참조하세요.
### `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 이상 탐지 사용](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Anomaly_Detection.html) 섹션을 참조하세요.
+ API 세부 정보는 **AWS CLI 명령 참조의 [PutAnomalyDetector](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/put-anomaly-detector.html)를 참조하세요.
### `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 사용 설명서*의 [복합 경보 생성](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Create_Composite_Alarm_How_To.html) 섹션을 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [PutCompositeAlarm](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/put-composite-alarm.html)을 참조하세요.
### `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 경보 생성](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/create_dashboard.html) 섹션을 참조하세요.
+ API 세부 정보는 **AWS CLI 명령 참조의 [PutDashboard](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/put-dashboard.html)를 참조하세요.
### `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 규칙 생성](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ContributorInsights-CreateRule.html)을 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [PutInsightRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/put-insight-rule.html)을 참조하세요.
### `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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/put-metric-alarm.html)을 참조하세요.
### `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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/put-metric-data.html)를 참조하세요.
### `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 사용 설명서*의 [지표 스트림 설정](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-metric-streams-setup.html) 섹션을 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [PutMetricStream](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/put-metric-stream.html)을 참조하세요.
### `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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/set-alarm-state.html)를 참조하세요.
### `start-metric-streams`
다음 코드 예시는 `start-metric-streams`의 사용 방법을 보여줍니다.
**AWS CLI**
**지정된 지표 스트림을 시작하려면**
다음 `start-metric-streams` 예제에서는 지정된 계정에서 `QuickFull-GuaFbs`라는 지표 스트림을 시작합니다.
```
aws cloudwatch start-metric-streams \
--names QuickFull-GuaFbs
```
이 명령은 출력을 생성하지 않습니다.
자세한 내용은 *Amazon CloudWatch 사용 설명서*의 [지표 스트림 사용](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Metric-Streams.html) 섹션을 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [StartMetricStreams](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/start-metric-streams.html)를 참조하세요.
### `stop-metric-streams`
다음 코드 예시는 `stop-metric-streams`의 사용 방법을 보여줍니다.
**AWS CLI**
**지정된 지표 스트림을 중지하려면**
다음 `stop-metric-streams` 예제에서는 지정된 계정에서 `QuickFull-GuaFbs`라는 지표 스트림을 중지합니다.
```
aws cloudwatch stop-metric-streams \
--names QuickFull-GuaFbs
```
이 명령은 출력을 생성하지 않습니다.
자세한 내용은 *Amazon CloudWatch 사용 설명서*의 [지표 스트림 사용](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Metric-Streams.html) 섹션을 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [StopMetricStreams](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/stop-metric-streams.html)를 참조하세요.
### `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 리소스 태깅](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Tagging.html)을 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/tag-resource.html)를 참조하세요.
### `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 리소스 태깅](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Tagging.html)을 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/untag-resource.html)를 참조하세요.