AWS CLI를 사용하는 CloudWatch Logs 예제 - AWS Command Line Interface

이 문서는 AWS CLI의 버전 1에만 해당합니다. AWS CLI의 버전 2와 관련된 문서는 버전 2 사용 설명서를 참조하세요.

AWS CLI를 사용하는 CloudWatch Logs 예제

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

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

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

주제

작업

다음 코드 예제에서는 create-log-group을 사용하는 방법을 보여 줍니다.

AWS CLI

다음 명령은 이름이 my-logs인 로그 그룹을 생성합니다.

aws logs create-log-group --log-group-name my-logs
  • API 세부 정보는 AWS CLI 명령 참조의 CreateLogGroup를 참조하세요.

다음 코드 예제에서는 create-log-stream을 사용하는 방법을 보여 줍니다.

AWS CLI

다음 명령은 my-logs 로그 그룹에서 이름이 20150601인 로그 스트림을 생성합니다.

aws logs create-log-stream --log-group-name my-logs --log-stream-name 20150601
  • API 세부 정보는 AWS CLI 명령 참조의 CreateLogStream을 참조하세요.

다음 코드 예제에서는 delete-log-group을 사용하는 방법을 보여 줍니다.

AWS CLI

다음 명령은 이름이 my-logs인 로그 그룹을 삭제합니다.

aws logs delete-log-group --log-group-name my-logs
  • API 세부 정보는 AWS CLI 명령 참조의 DeleteLogGroup을 참조하세요.

다음 코드 예제에서는 delete-log-stream을 사용하는 방법을 보여 줍니다.

AWS CLI

다음 명령은 20150531 로그 스트림이 이름이 my-logs인 로그 그룹을 삭제합니다.

aws logs delete-log-stream --log-group-name my-logs --log-stream-name 20150531
  • API 세부 정보는 AWS CLI 명령 참조의 DeleteLogStream 섹션을 참조하세요.

다음 코드 예제에서는 delete-retention-policy을 사용하는 방법을 보여 줍니다.

AWS CLI

다음 명령은 이전에 이름이 my-logs인 로그 그룹에 적용되었던 보존 정책을 제거합니다.

aws logs delete-retention-policy --log-group-name my-logs

다음 코드 예제에서는 describe-log-groups을 사용하는 방법을 보여 줍니다.

AWS CLI

다음 명령은 이름이 my-logs인 로그 그룹을 설명합니다.

aws logs describe-log-groups --log-group-name-prefix my-logs

출력:

{ "logGroups": [ { "storedBytes": 0, "metricFilterCount": 0, "creationTime": 1433189500783, "logGroupName": "my-logs", "retentionInDays": 5, "arn": "arn:aws:logs:us-west-2:0123456789012:log-group:my-logs:*" } ] }
  • API 세부 정보는 AWS CLI 명령 참조의 DescribeLogGroups를 참조하세요.

다음 코드 예제에서는 describe-log-streams을 사용하는 방법을 보여 줍니다.

AWS CLI

다음 명령은 로그 그룹 my-logs2015 접두사 로 시작하는 모든 로그 스트림을 보여 줍니다.

aws logs describe-log-streams --log-group-name my-logs --log-stream-name-prefix 2015

출력:

{ "logStreams": [ { "creationTime": 1433189871774, "arn": "arn:aws:logs:us-west-2:0123456789012:log-group:my-logs:log-stream:20150531", "logStreamName": "20150531", "storedBytes": 0 }, { "creationTime": 1433189873898, "arn": "arn:aws:logs:us-west-2:0123456789012:log-group:my-logs:log-stream:20150601", "logStreamName": "20150601", "storedBytes": 0 } ] }
  • API 세부 정보는 AWS CLI 명령 참조의 DescribeLogStreams 섹션을 참조하세요.

다음 코드 예제에서는 get-log-events을 사용하는 방법을 보여 줍니다.

AWS CLI

다음 명령은 my-logs 로그 그룹에서 이름이 20150601인 로그 스트림의 로그 이벤트를 검색합니다.

aws logs get-log-events --log-group-name my-logs --log-stream-name 20150601

출력:

{ "nextForwardToken": "f/31961209122447488583055879464742346735121166569214640130", "events": [ { "ingestionTime": 1433190494190, "timestamp": 1433190184356, "message": "Example Event 1" }, { "ingestionTime": 1433190516679, "timestamp": 1433190184356, "message": "Example Event 1" }, { "ingestionTime": 1433190494190, "timestamp": 1433190184358, "message": "Example Event 2" } ], "nextBackwardToken": "b/31961209122358285602261756944988674324553373268216709120" }
  • API 세부 정보는 AWS CLI 명령 참조의 GetLogEvents 섹션을 참조하세요.

다음 코드 예제에서는 put-log-events을 사용하는 방법을 보여 줍니다.

AWS CLI

다음 명령은 my-logs 로그 그룹에서 이름이 20150601인 로그 스트림에 로그 이벤트를 설정합니다.

aws logs put-log-events --log-group-name my-logs --log-stream-name 20150601 --log-events file://events

출력:

{ "nextSequenceToken": "49542672486831074009579604567656788214806863282469607346" }

위의 예제에서는 현재 디렉터리에 있는 events 파일에서 이벤트의 JSON 배열을 읽습니다

[ { "timestamp": 1433190184356, "message": "Example Event 1" }, { "timestamp": 1433190184358, "message": "Example Event 2" }, { "timestamp": 1433190184360, "message": "Example Event 3" } ]

이후 호출할 때마다 이전 호출에서 제공한 다음 시퀀스 토큰을 시퀀스 토큰 옵션으로 지정해야 합니다.

aws logs put-log-events --log-group-name my-logs --log-stream-name 20150601 --log-events file://events2 --sequence-token "49542672486831074009579604567656788214806863282469607346"

출력:

{ "nextSequenceToken": "49542672486831074009579604567900991230369019956308219826" }
  • API 세부 정보는 AWS CLI 명령 참조의 PutLogEvents 섹션을 참조하세요.

다음 코드 예제에서는 put-retention-policy을 사용하는 방법을 보여 줍니다.

AWS CLI

다음 명령은 my-logs 로그 그룹에 5일 보존 정책을 추가합니다.

aws logs put-retention-policy --log-group-name my-logs --retention-in-days 5
  • API 세부 정보는 AWS CLI 명령 참조의 PutRetentionPolicy 섹션을 참조하세요.