이 문서는 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-name20150601
-
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-name20150531
-
API 세부 정보는 AWS CLI 명령 참조의 DeleteLogStream
섹션을 참조하세요.
-
다음 코드 예제에서는 delete-retention-policy
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
다음 명령은 이전에 이름이
my-logs
인 로그 그룹에 적용되었던 보존 정책을 제거합니다.aws logs delete-retention-policy --log-group-name
my-logs
-
API 세부 정보는 AWS CLI 명령 참조의 DeleteRetentionPolicy
섹션을 참조하세요.
-
다음 코드 예제에서는 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-logs
의2015
접두사 로 시작하는 모든 로그 스트림을 보여 줍니다.aws logs describe-log-streams --log-group-name
my-logs
--log-stream-name-prefix2015
출력:
{ "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-name20150601
출력:
{ "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-name20150601
--log-eventsfile://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-name20150601
--log-eventsfile://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-days5
-
API 세부 정보는 AWS CLI 명령 참조의 PutRetentionPolicy
섹션을 참조하세요.
-