# mon-describe-alarms-for-metric
## 설명
지정된 지표와 연결된 경보에 대한 정보를 가져옵니다.
## 구문
****mon-describe-alarms-for-metric** --metric-name *value* --namespace *value* [--dimensions "key1=*value1*,key2=*value2*..."] [--period *value*] [--statistic *value*] [--extendedstatistic *value*] [--unit *value*] [Common Options] **
## 옵션
| 이름 | 설명 |
| --- | --- |
| `--dimensions` `- "key1=value1,key2=value2...` | 지표와 연결된 차원. 다음과 같이 차원을 두 가지 방식으로 지정할 수 있으며 형식을 결합하거나 서로 바꿔서 사용할 수 있습니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/AmazonCloudWatch/latest/cli/cli-mon-describe-alarms-for-metric.html) 유형: 맵 유효한 값: name=value 형식의 문자열. 여기서 키는 차원의 이름이고 값은 차원의 값입니다. 차원 이름 및 값은 길이가 1\$1250자인 ANSI 문자열이어야 합니다. 허용되는 최대 차원 수는 10개입니다. 기본값: 해당 사항 없음 필수 여부: 아니요 |
| `--metric-name` `VALUE` | 연결된 경보를 검색하려는 지표 이름. 유형: 인수 유효한 값: 길이가 1\$1255자인 유효한 메트릭 이름 기본값: 해당 사항 없음 필수 여부: 예 |
| `--namespace` `VALUE` | 경보와 연결된 지표의 네임스페이스입니다. 네임스페이스에 대한 자세한 내용은 [AWS 네임스페이스](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/aws-namespaces.html) 단원을 참조하세요. 유형: 문자열 유효한 값: 길이가 1\$1 250자인 유효한 네임스페이스 기본값: 해당 사항 없음 필수 여부: 예 |
| `--period` `VALUE` | 경보를 필터링할 기간입니다. 결과에는 이 기간에 지표를 평가하는 경보만 포함됩니다. 기간을 지정하지 않으면 모든 기간의 경보가 포함됩니다. 유형: 인수 유효한 값: 60초의 배수인 숫자(초) 기본값: 해당 사항 없음 필수 여부: 아니요 |
| `--statistic` `VALUE` | 경보를 필터링할 통계입니다. 지정된 통계에 대한 경보만 포함됩니다. 이 파라미터를 지정하지 않으면 모든 통계에 대한 경보가 포함됩니다. 유형: 열거 유효한 값: SampleCount, Average, Sum, Minimum 또는 Maximum 기본값: 해당 사항 없음 필수 여부: 아니요 |
| `--extendedstatistic` `VALUE` | 경보를 필터링할 백분위수 통계입니다. 지정된 통계에 대한 경보만 포함됩니다. 이 파라미터를 지정하지 않으면 모든 통계에 대한 경보가 포함됩니다. 유형: 문자열 유효한 값: 소수점 이하 두 자리까지의 백분위수입니다(예: p95.45). 기본값: 해당 사항 없음 필수 여부: 아니요 |
| `--unit` `VALUE` | 경보를 필터링할 기준이 될 단위. 지정한 통계에 대한 경보만 포함됩니다. 단위를 지정하지 않으면 모든 단위에 대한 경보가 포함됩니다. 경보에 지정된 단위가 없는 경우 경보를 검색할 수 있는 유일한 방법은 이 옵션을 생략하는 것입니다. 유형: 열거 유효한 값: 다음 중 하나입니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/AmazonCloudWatch/latest/cli/cli-mon-describe-alarms-for-metric.html) 기본값: 해당 사항 없음 필수 여부: 아니요 |
## 일반 옵션
| 이름 | 설명 |
| --- | --- |
| `--aws-credential-file` `VALUE` | AWS 자격 증명을 포함하는 파일의 위치입니다. 환경 변수 `AWS_CREDENTIAL_FILE`을 사용하여 이 값을 설정할 수 있습니다. 환경 변수를 정의하거나 자격 증명 파일에 대한 경로를 제공하는 경우 이 파일이 있어야 합니다. 그렇지 않으면 요청이 실패합니다. 액세스 키 ID 및 비밀 액세스 키를 사용하여 모든 CloudWatch 요청에 서명해야 합니다. 유형: 문자열 유효한 값: 액세스 키 ID 및 비밀 액세스 키를 포함하는 파일의 유효한 경로입니다. 기본값: `AWS_CREDENTIAL_FILE` 환경 변수(설정된 경우)를 사용합니다. |
| `-C, --ec2-cert-file-path` `VALUE` | 요청 서명을 위한 EC2 인증서 파일의 위치입니다. 환경 변수 `EC2_CERT`를 사용하여 이 값을 지정할 수 있습니다. 유형: 문자열 유효한 값: Amazon EC2 또는 AWS Identity and Access Management에서 제공하는 PEM 파일의 유효한 파일 경로입니다. 기본값: `EC2_CERT` 환경 변수(설정된 경우)를 사용합니다. |
| `--connection-timeout` `VALUE` | 연결 제한 시간 값(초)입니다. 유형: 정수 유효한 값: 양수입니다. 기본값: 30 |
| `--delimiter` `VALUE` | 구분된(long) 결과를 표시할 때 사용할 구분 기호입니다. 유형: 문자열 유효한 값: 문자열입니다. 기본값: 쉼표(,) |
| `--headers` `` | 표 형식 또는 구분된 결과를 표시하는 경우 열 머리글을 포함합니다. XML 결과를 표시하는 경우 서비스 요청에서 HTTP 헤더를 반환합니다(해당하는 경우). 유형: 플래그 유효한 값: 제공되면 헤더를 표시합니다. 기본값: `--headers` 옵션은 기본적으로 해제되어 있습니다. |
| `-I, --access-key-id` `VALUE` | 비밀 키와 함께 요청에 서명하는 데 사용할 액세스 키 ID입니다. 이는 --secret-key와 함께 사용해야 합니다. 그렇지 않으면 옵션이 무시됩니다. CloudWatch에 대한 모든 요청에 서명해야 합니다. 그러지 않으면 요청이 거부됩니다. 유형: 문자열 유효한 값: 유효한 액세스 키 ID입니다. 기본값: None |
| `-K, --ec2-private-key-file-path` `VALUE` | 요청에 서명하는 데 사용할 프라이빗 키입니다. 퍼블릭 또는 프라이빗 키를 사용하면 CLI에서 SOAP를 사용하게 됩니다. 퍼블릭 인증서 및 프라이빗 키를 사용하여 요청에 서명합니다. 이 파라미터는 `EC2_CERT`와 함께 사용해야 합니다. 그렇지 않으면 값이 무시됩니다. 환경 변수 `EC2_PRIVATE_KEY` 값은 설정되고 이 옵션이 지정되지 않은 경우 사용됩니다. 이 옵션은 환경 변수 `AWS_CREDENTIAL_FILE`이 설정되거나 `--aws-credentials-file`이 사용되는 경우 무시됩니다. CloudWatch에 대한 모든 요청에 서명해야 합니다. 그러지 않으면 요청이 거부됩니다. 유형: 문자열 유효한 값: 유효한 ASN.1 프라이빗 키에 대한 경로입니다. 기본값: None |
| `--region` `VALUE` | 요청이 전달되는 리전입니다. 환경 변수 `EC2_REGION`을 사용하여 값을 지정할 수 있습니다. 리전은 CloudWatch를 호출하는 데 사용되는 URL을 생성하는 데 이용되며 유효한 Amazon Web Services(AWS) 리전이어야 합니다. 유형: 문자열 유효한 값: AWS 리전(예: us-east-1)입니다. 기본값: `EC2_REGION` 환경 변수가 설정되지 않은 경우 us-east-1입니다. |
| `S, --secret-key` `VALUE` | 액세스 키 ID와 함께 요청에 서명하는 데 사용할 비밀 액세스 키입니다. 이 파라미터는 `--access-key-id`와 함께 사용해야 합니다. 그렇지 않으면 이 옵션이 무시됩니다. 유형: 문자열 유효한 값: 액세스 키 ID입니다. 기본값: None |
| `--show-empty-fields` `` | 이 데이터가 요청되지 않았음을 나타내는 자리 표시자로 (nil)을 사용하여 빈 필드를 표시합니다. 유형: 플래그 유효한 값: 없음 기본값: 빈 필드는 기본적으로 표시되지 않습니다. |
| `--show-request` `` | CLI가 AWS를 호출하는 데 사용하는 URL을 표시합니다. 유형: 플래그 유효한 값: 없음 기본값: false |
| `--show-table, --show-long, --show-xml, --quiet` `` | 결과가 표시되는 방식을 지정합니다. 예를 들어 결과를 표 형식, 구분된(long) 형식, XML 형식 또는 출력 없음(quiet) 형식으로 표시할 수 있습니다. `--show-table` 표시에서는 데이터의 하위 집합을 고정 열 너비 형식으로 표시하고, `--show-long`은 반환된 모든 값을 문자로 구분된 형식으로 표시하고, `--show-xml`은 서비스에서의 원시 반환이며, `--quiet`는 모든 표준 출력을 억제합니다. 모든 옵션은 서로 함께 사용되지 않으며 우선순위는 `--show-table`, `--show-long`, `--show-xml`, `--quiet`입니다. 유형: 플래그 유효한 값: 없음 기본값: `--show-table` |
| `-U, --url` `VALUE` | CloudWatch에 연결할 때 사용하는 URL입니다. 환경 변수 `AWS_CLOUDWATCH_URL`을 사용하여 이 값을 설정할 수 있습니다. 이 값은 `--region`과 함께 사용되어 예상 URL을 생성합니다. 이 옵션은 서비스 호출에 대한 URL을 재정의합니다. 유형: 문자열 유효한 값: 유효한 HTTP 또는 HTTPS URL입니다. 기본값: `AWS_CLOUDWATCH_URL`에 지정된 값을 사용합니다(설정된 경우). |
## 출력
이 명령은 다음이 포함된 표를 반환합니다.
+ ALARM – 경보 이름입니다.
+ DESCRIPTION - 경보 설명입니다. 이 열은 --show-long 보기에만 나타납니다.
+ STATE - 경보 상태입니다.
+ STATE\$1REASON - 사람이 읽을 수 있는 상태에 대한 원인입니다. 이 열은 --show-long 보기에만 나타납니다.
+ STATE\$1REASON\$1DATA - 시스템에서 읽을 수 있는 상태에 대한 원인(JSON 형식)입니다. 이 열은 --show-long 보기에만 나타납니다.
+ ENABLED - 작업을 사용하거나 사용 중지합니다. 이 열은 --show-long 보기에만 나타납니다.
+ OK\$1ACTIONS - OK 상태에서 실행할 작업입니다. 이 열은 --show-long 보기에만 나타납니다.
+ ALARM\$1ACTIONS - ALARM 상태에서 실행할 작업입니다.
+ INSUFFICIENT\$1DATA\$1ACTIONS - INSUFFICIENT\$1DATA 상태에서 실행할 작업입니다. 이 열은 --show-long 보기에만 나타납니다.
+ NAMESPACE - 지표의 네임스페이스입니다.
+ METRIC\$1NAME - 지표의 이름입니다.
+ DIMENSIONS - 지표 차원입니다. 이 열은 --show-long 보기에만 나타납니다.
+ PERIOD - 기간입니다.
+ STATISTIC - 통계(Average, Minimum, Maximum, Sum, SampleCount)입니다.
+ EXTENDEDSTATISTIC - 백분위수 통계입니다.
+ UNIT - 단위입니다. 이 열은 --show-long 보기에만 나타납니다.
+ EVAL\$1PERIODS - 지표를 평가할 기간입니다.
+ COMPARISON - 비교 연산자입니다.
+ THRESHOLD - 임계값입니다.
Amazon CloudWatch CLI는 stderr에 오류를 표시합니다.
## 예제
### 요청 예제
이 예는 특정 메트릭에 대한 경보에 대해 설명합니다.
```
mon-describe-alarms-for-metric--metric-name CPUUtilization --namespace AWS/EC2 --dimensions InstanceId=i-abcdef
```
다음은 이 명령의 출력 예입니다.
```
ALARM STATE ALARM_ACTIONS NAMESPACE METRIC_NAME PERIOD STATISTIC EVAL_PERIODS COMPARISON THRESHOLD
my-alarm1 OK arn:aws:sns:.. AWS/EC2 CPUUtilization 60 Average 3 GreaterThanThreshold 100.0
my-alarm2 OK arn:aws:sns:.. AWS/EC2 CPUUtilization 60 Average 5 GreaterThanThreshold 80.0
```
## 관련 주제
### 다운로드
+ [명령줄 인터페이스 설정](SetupCLI.md)
### 관련 작업
+ [DescribeAlarmForMetric](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_DescribeAlarmsForMetric.html)
### 관련 명령
+ [mon-describe-alarm-history](cli-mon-describe-alarm-history.md)
+ [mon-describe-alarms](cli-mon-describe-alarms.md)