mon-put-data - Amazon CloudWatch
설명구문옵션일반 옵션출력예시관련 주제

mon-put-data

설명

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

참고

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

구문

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]

옵션

명칭 설명

-d, --dimensions "key1=value1,key2=value2..."

지표 데이터를 고유하게 식별하는 차원입니다. 다음과 같이 차원을 두 가지 방식으로 지정할 수 있으며 형식을 결합하거나 서로 바꿔서 사용할 수 있습니다.

  • 차원당 한 가지 옵션: --dimensions "key1=value1" --dimensions "key2=value2"

  • 한 가지 옵션으로 모두 적용: --dimensions "key1=value1,key2=value2"

유형: 맵

유효한 값: name=value 형식의 문자열. 여기서 키는 차원의 이름이고 값은 차원의 값입니다. 차원 이름 및 값은 길이가 1~250자인 ANSI 문자열이어야 합니다. 허용되는 최대 차원 수는 10개입니다.

기본값: 해당 사항 없음

필수 항목 여부: 아니요

-m, --metric-name VALUE1,VALUE2,VALUE3...

지표의 이름.

유형: 문자열

유효한 값: 1~ 250자인 모든 유효한 메트릭 이름

기본값: 해당 사항 없음

필수 여부: 예

n, --namespace VALUE

지표의 네임스페이스입니다. 네임스페이스에 대한 자세한 내용은 AWS 네임스페이스 단원을 참조하세요.

유형: 문자열

유효한 값: 길이가 1~ 250자인 ANSI 문자열

기본값: 해당 사항 없음

필수 여부: 예

-s, --statistic Values "key1=value1,key2=value2..."

지정된 타임스탬프 및 지표에 대해 저장할 통계입니다. 이 옵션에서 --value는 제외됩니다. --statisticValue 또는 --value 중 하나는 지정해야 합니다.

유형: 맵

유효한 값: 모든 통계 이름(SampleCount, Sum, Maximum 및 Minimum)에 대한 double 값을 모두 포함하고 있는 문자열. 이러한 모든 값은 1E-130과 1E130 사이의 값이어야 합니다.

기본값: 해당 사항 없음

필수 여부: 예

-t, --timestamp VALUE

기록할 지표에 대한 데이터 포인트 또는 관측치의 타임스탬프입니다. 타임스탬프는 ISO8601 결합 형식을 사용하여 지정됩니다. 예를 들어 2013년 7월 30일 12:30:00 PST의 날짜 및 시간은 2013-07-30T12:30:00-07:00 또는 UTC: 2013-07-30T19:30:00Z로 표시할 수 있습니다.

유형: Simple

유효한 값: 유효한 타임스탬프는 시간대 오프셋 또는 UTC 지시자를 사용하여 ISO8601 형식으로 표시됩니다.

기본값: 현재 UTC 시간

필수 항목 여부: 아니요

-u, --unit VALUE

지표의 단위입니다.

유형: 열거

유효한 값: 다음 중 하나입니다.

  • 초

  • 마이크로초

  • 밀리초

  • 바이트

  • KB

  • MB

  • GB

  • TB

  • 비트

  • Kbit

  • Mbit

  • Gbit

  • Tbit

  • %

  • 개수

  • 바이트/초

  • KB/s

  • MB/s

  • GB/s

  • TB/s

  • 비트/초

  • Kbit/s

  • Mbit/s

  • Gbit/s

  • Tbit/s

  • 개수/초

  • None

기본값: 해당 사항 없음

필수 항목 여부: 아니요

-v, --value VALUE

기록할 단일 값입니다. 이 값은 SampleCount=1, Sum=VALUE, Minimum=VALUE, Maximum=VALUE 형식의 통계 세트로 변환됩니다. 이 옵션에서 --statisticValues는 제외됩니다.

유형: Simple

유효한 값: 모든 값은 1E-130과 1E130 사이의 숫자여야 합니다.

기본값: 해당 사항 없음

필수 여부: 예

일반 옵션

이름 설명

--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에 지정된 값을 사용합니다(설정된 경우).

출력

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

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

예시

요청 예제

이 예에서는 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"

요청 예제

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

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

관련 주제

다운로드

관련 작업

관련 명령