기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
SOURCE
쿼리SOURCE에를 포함시키는 것은 AWS CLI 또는 API를 사용하여 쿼리를 생성할 때 쿼리에 포함할 로그 그룹을 지정하는 유용한 방법입니다. SOURCE 명령은 CloudWatch 콘솔이 아닌 AWS CLI 및 API에서만 지원됩니다. CloudWatch 콘솔을 사용하여 쿼리를 시작할 때 콘솔 인터페이스를 사용하여 로그 그룹을 지정합니다.
SOURCE를 사용하여 쿼리할 로그 그룹을 지정하려면 다음 키워드를 사용할 수 있습니다.
-
namePrefix는 지정한 문자열로 시작하는 이름이 있는 로그 그룹에 대해 쿼리를 실행합니다. 이를 생략하면 모든 로그 그룹이 쿼리됩니다.목록에 최대 5개의 접두사를 포함할 수 있습니다.
-
accountIdentifiers는 지정된 AWS 계정의 로그 그룹에 대해 쿼리를 실행합니다. 이는 모니터링 계정에서 쿼리를 실행하는 경우에만 작동합니다. 이를 생략하면 연결된 모든 소스 계정과 현재 모니터링 계정을 쿼리하는 것이 기본값입니다. 교차 계정 관찰성에 대한 자세한 내용은 CloudWatch 교차 계정 관찰성을 참조하세요.목록에 최대 20개의 계정 식별자를 포함할 수 있습니다.
-
logGroupClass는 지정된 로그 클래스인 Standard 또는 Infrequent Access에 있는 로그 그룹에 대해 쿼리를 실행합니다. 이를 생략하면 표준 로그 클래스의 기본값이 사용됩니다. 로그 클래스에 대한 자세한 내용은 로그 클래스를 참조하세요.
이러한 방식으로 쿼리할 많은 수의 로그 그룹을 지정할 수 있으므로 생성한 필드 인덱스를 활용하는 쿼리SOURCE에만를 사용하는 것이 좋습니다. 로그 그룹의 필드 인덱싱에 대한 자세한 내용은 섹션을 참조하세요. 필드 인덱스를 생성하여 쿼리 성능을 개선하고 스캔 볼륨을 줄입니다.
다음 예시에서는 계정의 모든 로그 그룹을 선택합니다. 모니터링 계정인 경우 모니터링 및 모든 소스 계정의 로그 그룹이 선택됩니다. 총 로그 그룹 수가 10,000개를 초과하면 다른 로그 그룹 선택 방법을 사용하여 로그 그룹 수를 줄이라는 오류가 표시됩니다.
SOURCE logGroups()
다음 예시에서는 111122223333 소스 계정의 로그 그룹을 선택합니다. CloudWatch 교차 계정 관찰성의 모니터링 계정에서 쿼리를 시작하면 기본적으로 모든 소스 계정과 모니터링 계정의 로그 그룹이 선택됩니다.
SOURCE logGroups(accountIdentifiers:['111122223333'])
다음 예제에서는 이름 접두사를 기반으로 로그 그룹을 선택합니다.
SOURCE logGroups(namePrefix: ['namePrefix1', 'namePrefix2'])
다음 예시에서는 Infrequent Access 로그 클래스의 모든 로그 그룹을 선택합니다. class 식별자를 포함하지 않으면 쿼리는 기본값인 표준 로그 클래스의 로그 그룹에만 적용됩니다.
SOURCE logGroups(class: ['INFREQUENT_ACCESS'])
다음 예제에서는 111122223333 계정에서 특정 이름 접두사로 시작하고 표준 로그 클래스에 있는 로그 그룹을 선택합니다. Standard가 기본 로그 클래스 값이므로 명령에 클래스가 언급되지 않습니다.
SOURCE logGroups(accountIdentifiers:['111122223333'], namePrefix: ['namePrefix1', 'namePrefix2']
마지막 예제에서는 SOURCE 명령과 함께 start-query AWS CLI 명령을 사용하는 방법을 보여줍니다.
aws logs start-query --region us-east-1 --start-time 1729728200 --end-time 1729728215 --query-string "SOURCE logGroups(namePrefix: ['Query']) | fields @message | limit 5"
