Amazon CloudWatch Logs, 조회 쿼리 명령 도입

게시된 날짜: 2026년 3월 31일

Amazon CloudWatch Logs Insights에서는 이제 새로운 조회 명령을 지원하여 고객이 참조 테이블의 데이터로 로그 쿼리 결과를 보강할 수 있도록 합니다. 복잡한 분산 시스템을 사용하는 개발자, DevOps 엔지니어, SRE의 경우 추가 컨텍스트 없이는 해석하기 어려운 GUID, IP 주소 또는 내부 리소스 ID 같은 모호한 식별자가 포함된 로그를 자주 접하게 됩니다.

조회 명령을 사용하면 쿼리 시 조회 테이블에 로그 데이터를 결합할 수 있으므로, 결과를 유의미한 값으로 자동 보강할 수 있습니다. 예를 들어 고객 ID를 고객 이름으로 변환하거나, 내부 IP 주소를 해당 주소를 소유한 팀에 매핑할 수 있습니다. 이 새로운 명령을 사용하면 사전 처리 파이프라인 없이도 로그를 더 빠르고 직관적으로 분석할 수 있습니다. 

조회 명령은 현재 모든 상용 AWS 리전에서 사용 가능합니다. 

시작하려면 CloudWatch → 설정 → 로그로 이동하여 CSV 파일을 업로드합니다.  그다음 로그 필드, 조회 테이블 이름, 하나 이상의 열을 지정하여 Logs Insights 쿼리에서 조회 명령을 사용합니다.  CSV 데이터는 스캔한 데이터 GB당 CloudWatch Logs Insights의 쿼리 요금에 포함되지 않습니다.  자세한 내용은 CloudWatch 로그 인사이트 설명서를 참조하세요.