Amazon CloudWatch Logs Insights, 이제 파라미터가 포함된 저장된 쿼리를 지원

게시된 날짜: 2026년 4월 13일

Amazon CloudWatch Logs Insights 저장된 쿼리는 이제 파라미터를 지원하므로 자리 표시자를 사용하여 재사용 가능한 쿼리 템플릿에 값을 전달할 수 있습니다. 따라서 로그 수준, 서비스 이름, 시간 간격 등 특정 값만 다른 거의 동일한 쿼리의 복사본을 여러 개 유지할 필요가 없습니다.

쿼리에 최대 20개의 파라미터를 정의할 수 있으며, 각 파라미터는 선택적 기본값을 지원합니다. 예를 들어, 심각도 수준(예: ERROR 또는 WARN)별로 로그를 쿼리하고 실행할 때마다 다른 서비스 이름을 전달하는 단일 템플릿을 생성할 수 있습니다. 파라미터가 포함된 쿼리를 실행하려면 쿼리 이름에 접두사 $가 붙은 쿼리를 사용하여 쿼리를 간접적으로 호출하고 파라미터 값을 전달합니다(예: $ErrorsByService(logLevel="ERROR", serviceName="OrderEntry")). 또한 파라미터가 포함된 여러 개의 저장된 쿼리를 함께 사용하여 복잡한 로그 분석을 수행할 수 있으므로 쿼리 유지 관리 오버헤드를 크게 줄이고 재사용성을 향상시킬 수 있습니다.

파라미터가 포함된 저장된 쿼리는 모든 상용 AWS 리전에서 사용할 수 있습니다. Amazon CloudWatch 콘솔, AWS Command Line Interface(AWS CLI), AWS Cloud Development Kit(AWS CDK), AWS SDK를 사용하여 파라미터가 포함된 저장된 쿼리를 생성하고 사용할 수 있습니다. 자세한 내용은 Amazon CloudWatch Logs 설명서를 참조하세요.