필터를 사용하여 로그 이벤트에서 지표 생성 - 아마존 CloudWatch 로그

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

필터를 사용하여 로그 이벤트에서 지표 생성

지표 필터를 하나 이상 생성하여 로그로 들어오는 CloudWatch 로그 데이터를 검색하고 필터링할 수 있습니다. 지표 필터는 CloudWatch Logs로 전송되는 로그 데이터에서 찾을 용어와 패턴을 정의합니다. CloudWatch 로그는 이러한 지표 필터를 사용하여 로그 데이터를 그래프로 표시하거나 경보를 설정할 수 있는 수치 CloudWatch 지표로 변환합니다.

로그 필터에서 지표를 생성할 때 차원과 단위를 메트릭에 할당하도록 선택할 수도 있습니다. 단위를 지정하는 경우 필터를 생성할 때 올바른 단위를 지정해야 합니다. 필터 단위를 나중에 변경하는 것은 효과가 없습니다.

참고

지표 필터는 표준 로그 클래스의 로그 그룹에만 지원됩니다. 로그 클래스에 대한 자세한 내용은 을 참조하십시오로그 클래스.

이러한 지표를 보거나 경보를 설정할 때는 백분위수 CloudWatch 통계를 비롯한 모든 유형의 통계를 사용할 수 있습니다.

참고

지표 값이 음수가 아닌 경우에만 지표의 백분위수 통계가 지원됩니다. 지표 필터를 음수를 보고할 수 있도록 설정하면 값이 음수인 경우에는 해당 지표의 백분위수 통계를 사용할 수 없습니다. 자세한 내용은 백분위수를 참조하세요.

필터는 데이터를 소급해서 필터링하지 않습니다. 필터는 필터가 생성된 이후에 발생한 이벤트에 대한 지표 데이터 요소만 게시합니다. 필터링된 결과는 처음 50개 줄을 반환하는데, 필터링된 결과에 대한 타임스탬프가 지표 생성 시간보다 이른 경우에는 결과가 표시되지 않습니다.

개념

각 지표 필터는 다음과 같은 키 요소들로 이루어져 있습니다.

기본값

로그를 수집했지만 일치하는 로그를 찾을 수 없는 기간 동안 지표 필터에 보고되는 값입니다. 이 값을 0으로 설정하면 이러한 모든 기간에서 데이터가 보고되어 일치하는 데이터가 없는 기간 때문에 지표가 '불규칙'해지는 것을 방지할 수 있습니다. 1분 동안 로그가 수집되지 않은 경우에는 아무 값도 보고되지 않습니다.

지표 필터로 생성한 지표에 차원을 할당하는 경우 해당 지표에 기본값을 할당할 수 없습니다.

차원

차원은 지표를 추가로 정의하는 키-값 쌍입니다. 지표 필터에서 생성된 지표에 차원을 할당할 수 있습니다. 차원은 지표에 대한 고유한 식별자의 일부이므로 로그에서 고유한 이름/값 쌍을 추출할 때마다 해당 지표의 새로운 변형이 생성되는 것입니다.

필터 패턴

Logs가 각 CloudWatch 로그 이벤트의 데이터를 해석하는 방법을 상징적으로 설명하는 것입니다. 예를 들어 로그 항목에는 타임스탬프, IP 주소, 문자열 등이 포함될 수 있습니다. 이러한 패턴을 사용하여 로그 파일에서 검색할 내용을 지정합니다.

척도 이름

모니터링된 로그 정보를 게시해야 하는 CloudWatch 지표의 이름. 예를 들어, 라는 지표에 게시할 수 ErrorCount 있습니다.

지표 네임스페이스

새 CloudWatch 지표의 대상 네임스페이스.

지표 값

일치하는 로그가 발견될 때마다 지표에 게시하는 숫자 값입니다. 예를 들어, 특정 단어(예: "Error")의 출현 횟수를 계산할 경우 각 출현마다 이 값이 "1"이 됩니다. 전송된 바이트를 계산하는 경우 로그 이벤트에서 발견된 실제 바이트 수만큼 증가시킬 수 있습니다.