# mon-put-data
<a name="cli-mon-put-data"></a>

## 설명
<a name="w2aab9c47b3"></a>

지표 데이터 포인트를 지정된 지표에 추가합니다. 이 호출은 특정 메트릭 이름의 원시 값 또는 유효한 통계 값에 대한 시계열 데이터를 가져옵니다. 한 번에 데이터 요소를 하나만 입력할 수 있습니다.

**참고**  
`mon-put-data` 명령을 사용하여 새 지표를 생성하는 경우 `mon-get-stats` 명령을 사용하여 새 지표에 대한 통계를 검색할 수 있기까지 최대 2분 정도 걸릴 수 있습니다. 그러나 `mon-list-metrics` 명령을 사용하여 검색된 지표 목록에 새 지표가 나타나기까지는 최대 15분 정도 걸릴 수 있습니다.

## 구문
<a name="w2aab9c47b5"></a>

 ****mon-put-data** --metric-name {{value}}[--namespace {{value}} [--dimensions "key1={{value1}},key2={{value2}}..."] [--statisticValues "key1={{value1}},key2={{value2}}..."] [--timestamp {{value}}] [--unit {{value}}] [--value {{value}}] [Common Options] ** 

## 옵션
<a name="w2aab9c47b7"></a>


| 이름 | 설명 | 
| --- | --- | 
| -d, --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-put-data.html)<br />유형: 맵<br />유효한 값: name=value 형식의 문자열. 여기서 키는 차원의 이름이고 값은 차원의 값입니다. 차원 이름 및 값은 길이가 1\~250자인 ANSI 문자열이어야 합니다. 허용되는 최대 차원 수는 10개입니다.<br />기본값: 해당 사항 없음<br />필수 여부: 아니요 | 
| `-m, --metric-name` `VALUE1,VALUE2,VALUE3...`  | 지표의 이름.<br />유형: 문자열<br />유효한 값: 1\~ 250자인 모든 유효한 메트릭 이름<br />기본값: 해당 사항 없음<br />필수 여부: 예 | 
| `n, --namespace` `VALUE`  | 지표의 네임스페이스입니다. 네임스페이스에 대한 자세한 내용은 [AWS 네임스페이스](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/aws-namespaces.html) 단원을 참조하세요.<br />유형: 문자열<br />유효한 값: 길이가 1\~ 250자인 ANSI 문자열<br />기본값: 해당 사항 없음<br />필수 여부: 예 | 
| `-s, --statistic` `Values "key1=value1,key2=value2..."`  | 지정된 타임스탬프 및 지표에 대해 저장할 통계입니다. 이 옵션에서 `--value`는 제외됩니다. `--statisticValue` 또는 `--value` 중 하나는 지정해야 합니다.<br />유형: 맵<br />유효한 값: 모든 통계 이름(SampleCount, Sum, Maximum 및 Minimum)에 대한 double 값을 모두 포함하고 있는 문자열. 이러한 모든 값은 1E-130과 1E130 사이의 값이어야 합니다.<br />기본값: 해당 사항 없음<br />필수 여부: 예 | 
| `-t, --timestamp` `VALUE`  | 기록할 지표에 대한 데이터 포인트 또는 관측치의 타임스탬프입니다. 타임스탬프는 ISO8601 결합 형식을 사용하여 지정됩니다. 예를 들어 2013년 7월 30일 12:30:00 PST의 날짜 및 시간은 2013-07-30T12:30:00-07:00 또는 UTC: 2013-07-30T19:30:00Z로 표시할 수 있습니다.<br />유형: Simple<br />유효한 값: 유효한 타임스탬프는 시간대 오프셋 또는 UTC 지시자를 사용하여 ISO8601 형식으로 표시됩니다.<br />기본값: 현재 UTC 시간<br />필수 여부: 아니요 | 
| `-u, --unit` `VALUE`  | 지표의 단위입니다.<br />유형: 열거<br />유효한 값: 다음 중 하나입니다.[See the AWS documentation website for more details](http://docs.aws.amazon.com/ko_kr/AmazonCloudWatch/latest/cli/cli-mon-put-data.html)<br />기본값: 해당 사항 없음<br />필수 여부: 아니요 | 
| `-v, --value` `VALUE`  | 기록할 단일 값입니다. 이 값은 SampleCount=1, Sum=VALUE, Minimum=VALUE, Maximum=VALUE 형식의 통계 세트로 변환됩니다. 이 옵션에서 `--statisticValues`는 제외됩니다.<br />유형: Simple<br />유효한 값: 모든 값은 1E-130과 1E130 사이의 숫자여야 합니다.<br />기본값: 해당 사항 없음<br />필수 여부: 예 | 

## 일반 옵션
<a name="w2aab9c47b9"></a>


| 이름 | 설명 | 
| --- | --- | 
| `--aws-credential-file` `VALUE`  | AWS 자격 증명을 포함하는 파일의 위치입니다. 환경 변수 `AWS_CREDENTIAL_FILE`을 사용하여 이 값을 설정할 수 있습니다. 환경 변수를 정의하거나 자격 증명 파일에 대한 경로를 제공하는 경우 이 파일이 있어야 합니다. 그렇지 않으면 요청이 실패합니다. 액세스 키 ID 및 비밀 액세스 키를 사용하여 모든 CloudWatch 요청에 서명해야 합니다.<br />유형: 문자열<br />유효한 값: 액세스 키 ID 및 비밀 액세스 키를 포함하는 파일의 유효한 경로입니다.<br />기본값: `AWS_CREDENTIAL_FILE` 환경 변수(설정된 경우)를 사용합니다. | 
| `-C, --ec2-cert-file-path` `VALUE`  | 요청 서명을 위한 EC2 인증서 파일의 위치입니다. 환경 변수 `EC2_CERT`를 사용하여 이 값을 지정할 수 있습니다.<br />유형: 문자열<br />유효한 값: Amazon EC2 또는 AWS Identity and Access Management에서 제공하는 PEM 파일의 유효한 파일 경로입니다.<br />기본값: `EC2_CERT` 환경 변수(설정된 경우)를 사용합니다. | 
|  `--connection-timeout` `VALUE`  | 연결 제한 시간 값(초)입니다.<br />유형: 정수<br />유효한 값: 양수입니다.<br />기본값: 30 | 
|  `--delimiter` `VALUE`  | 구분된(long) 결과를 표시할 때 사용할 구분 기호입니다.<br />유형: 문자열<br />유효한 값: 문자열입니다.<br />기본값: 쉼표(,) | 
|  `--headers` ``  | 표 형식 또는 구분된 결과를 표시하는 경우 열 머리글을 포함합니다. XML 결과를 표시하는 경우 서비스 요청에서 HTTP 헤더를 반환합니다(해당하는 경우).<br />유형: 플래그<br />유효한 값: 제공되면 헤더를 표시합니다.<br />기본값: `--headers` 옵션은 기본적으로 해제되어 있습니다. | 
|  `-I, --access-key-id` `VALUE`  | 비밀 키와 함께 요청에 서명하는 데 사용할 액세스 키 ID입니다. 이는 --secret-key와 함께 사용해야 합니다. 그렇지 않으면 옵션이 무시됩니다. CloudWatch에 대한 모든 요청에 서명해야 합니다. 그러지 않으면 요청이 거부됩니다.<br />유형: 문자열<br />유효한 값: 유효한 액세스 키 ID입니다.<br />기본값: None | 
|  `-K, --ec2-private-key-file-path` `VALUE`  | 요청에 서명하는 데 사용할 프라이빗 키입니다. 퍼블릭 또는 프라이빗 키를 사용하면 CLI에서 SOAP를 사용하게 됩니다. 퍼블릭 인증서 및 프라이빗 키를 사용하여 요청에 서명합니다. 이 파라미터는 `EC2_CERT`와 함께 사용해야 합니다. 그렇지 않으면 값이 무시됩니다. 환경 변수 `EC2_PRIVATE_KEY` 값은 설정되고 이 옵션이 지정되지 않은 경우 사용됩니다. 이 옵션은 환경 변수 `AWS_CREDENTIAL_FILE`이 설정되거나 `--aws-credentials-file`이 사용되는 경우 무시됩니다. CloudWatch에 대한 모든 요청에 서명해야 합니다. 그러지 않으면 요청이 거부됩니다.<br />유형: 문자열<br />유효한 값: 유효한 ASN.1 프라이빗 키에 대한 경로입니다.<br />기본값: None | 
|  `--region` `VALUE`  | 요청이 전달되는 리전입니다. 환경 변수 `EC2_REGION`을 사용하여 값을 지정할 수 있습니다. 리전은 CloudWatch를 호출하는 데 사용되는 URL을 생성하는 데 이용되며 유효한 Amazon Web Services(AWS) 리전이어야 합니다.<br />유형: 문자열<br />유효한 값: AWS 리전(예: us-east-1)입니다.<br />기본값: `EC2_REGION` 환경 변수가 설정되지 않은 경우 us-east-1입니다. | 
|  `S, --secret-key` `VALUE`  | 액세스 키 ID와 함께 요청에 서명하는 데 사용할 비밀 액세스 키입니다. 이 파라미터는 `--access-key-id`와 함께 사용해야 합니다. 그렇지 않으면 이 옵션이 무시됩니다.<br />유형: 문자열<br />유효한 값: 액세스 키 ID입니다.<br />기본값: None | 
|  `--show-empty-fields` ``  | 이 데이터가 요청되지 않았음을 나타내는 자리 표시자로 (nil)을 사용하여 빈 필드를 표시합니다.<br />유형: 플래그<br />유효한 값: 없음<br />기본값: 빈 필드는 기본적으로 표시되지 않습니다. | 
|  `--show-request` ``  | CLI가 AWS를 호출하는 데 사용하는 URL을 표시합니다.<br />유형: 플래그<br />유효한 값: 없음<br />기본값: 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`입니다.<br />유형: 플래그<br />유효한 값: 없음<br />기본값: `--show-table` | 
|  `-U, --url` `VALUE`  | CloudWatch에 연결할 때 사용하는 URL입니다. 환경 변수 `AWS_CLOUDWATCH_URL`을 사용하여 이 값을 설정할 수 있습니다. 이 값은 `--region`과 함께 사용되어 예상 URL을 생성합니다. 이 옵션은 서비스 호출에 대한 URL을 재정의합니다.<br />유형: 문자열<br />유효한 값: 유효한 HTTP 또는 HTTPS URL입니다.<br />기본값: `AWS_CLOUDWATCH_URL`에 지정된 값을 사용합니다(설정된 경우). | 

## 출력
<a name="w2aab9c47c11"></a>

이 명령은 메트릭에 메트릭 데이터 요소를 추가합니다.

Amazon CloudWatch CLI는 stderr에 오류를 표시합니다.

## 예제
<a name="w2aab9c47c13"></a>

### 요청 예제
<a name="w2aab9c47c13b2"></a>

이 예에서는 `RequestCount` 네임스페이스의 `MyService`에 대한 통계 데이터를 가져옵니다. 메트릭에 차원이 없으므로 전체 서비스에 대한 전반적인 RequestCount가 표시됩니다. 측정값은 최대값이 70, 최소값이 30, 합계가 250이었던 이전 5개 측정값을 나타내는 사전에 집계된 statisticValue입니다.

```
mon-put-data --metric-name RequestCount --namespace "MyService" --timestamp 2013-11-25T00:00:00.000Z --statisticValues "Sum=250,Minimum=30,Maximum=70,SampleCount=5"
```

### 요청 예제
<a name="w2aab9c47c13b4"></a>

이 예는 `RequestCount` 네임스페이스의 사용자별 `MyService` 테스트 데이터를 가져옵니다. 이 메트릭을 위 예의 서비스 범위 메트릭과 구분하기 위해 사용자 및 스택 이름이 차원으로 저장됩니다.

```
mon-put-data --metric-name RequestCount --namespace "MyService" --dimensions "User=SomeUser,Stack=Test" --timestamp 2013-11-25T00:00:00.000Z --value 50
```

## 관련 주제
<a name="w2aab9c47c15"></a>

### 다운로드
<a name="w2aab9c47c15b2"></a>
+ [명령줄 인터페이스 설정](SetupCLI.md)

### 관련 작업
<a name="w2aab9c47c15b4"></a>
+ [PutMetricData](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricData.html)

### 관련 명령
<a name="w2aab9c47c15b6"></a>
+  [mon-put-metric-alarm](cli-mon-put-metric-alarm.md)