기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 지표 필터 생성
다음 절차 및 예제에서는 지표 필터를 생성하는 방법을 보여줍니다.
**Topics**
+ [로그 그룹에 대한 지표 필터 생성](CreateMetricFilterProcedure.md)
+ [예제: 로그 이벤트 수 계산](CountingLogEventsExample.md)
+ [예제: 단어의 출현 횟수 계산](CountOccurrencesExample.md)
+ [예제: HTTP 404 코드 수 계산](Counting404Responses.md)
+ [예제: HTTP 4xx 코드 수 계산](FindCountMetric.md)
+ [예제: Apache 로그에서 필드 추출 후 차원 할당](ExtractBytesExample.md)
# 로그 그룹에 대한 지표 필터 생성
로그 그룹에 대한 지표 필터를 만들려면 다음 단계를 따릅니다. 지표는 해당 몇 개의 데이터 포인트가 있기 전에는 표시되지 않습니다.
**CloudWatch 콘솔을 사용하여 지표 필터를 생성하려면**
1. [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)에서 CloudWatch 콘솔을 엽니다.
1. 탐색 창에서 **로그**를 선택한 다음 **로그 그룹**을 선택합니다.
1. 로그 그룹의 이름을 선택합니다.
1. `Actions`을 선택한 다음 **지표 필터 생성**을 선택합니다.
1. **Filter pattern**(필터 패턴)에 필터 패턴을 입력합니다. 자세한 내용은 [지표 필터, 구독 필터, 필터 로그 이벤트 및 Live Tail에 대한 필터 패턴 구문](FilterAndPatternSyntax.md) 단원을 참조하십시오.
1. (선택 사항) 중앙 집중식 로그 그룹을 사용하는 경우 **필터 선택 기준**에서 소스 계정(`@aws.account`), 소스 리전(`@aws.region`) 또는 두 조건 모두를 기준으로 필터를 지정할 수 있습니다.
1. (선택 사항) 필터 패턴을 테스트하려면 **패턴 테스트**에 패턴을 테스트할 로그 이벤트를 하나 이상 입력합니다. 각 로그 이벤트는 한 줄에 형식이 지정되어야 합니다. 줄 바꿈은 **Log event messages**(로그 이벤트 메시지) 상자에서 로그 이벤트를 구분하는 데 사용됩니다.
1. **Next**(다음)를 선택하고 지표 필터의 이름을 입력합니다.
1. **지표 세부 정보**에서 **지표 네임스페이스**에 지표가 게시될 CloudWatch 네임스페이스의 이름을 입력합니다. 네임스페이스가 아직 없는 경우 **Create new**(새로 생성)가 선택되는지 확인하세요.
1. **지표 이름**에 새 지표의 이름을 입력합니다.
1. 지표 필터가 필터에 포함된 키워드의 출현 횟수를 계산하는 경우 **지표 값**에 1을 입력합니다. 이렇게 하면 키워드 중 하나를 포함하는 각 로그 이벤트에 대해 지표가 1씩 증가합니다.
또는 토큰(예: **\$1size**)을 입력합니다. 이렇게 하면 `size` 필드가 포함된 모든 로그 이벤트에 대해 `size` 필드의 수치 값만큼씩 지표가 증가합니다.
1. (선택 사항) **단위**에서 지표에 할당할 단위를 선택합니다. 단위를 지정하지 않을 경우 단위는 `None`으로 설정됩니다.
1. (선택 사항) 지표에 대한 세 개의 차원에 대해 각각 이름과 토큰을 입력합니다. 지표 필터가 생성하는 지표에 차원을 할당하는 경우 해당 지표에 대한 기본값을 할당할 수 없습니다.
**참고**
차원은 JSON 또는 공백으로 구분된 지표 필터에서만 지원됩니다.
1. **지표 필터 생성**을 선택합니다. 생성한 지표 필터를 탐색 창에서 찾을 수 있습니다. **Logs**(로그)를 선택한 후 **Log groups**(로그 그룹)를 선택합니다. 지표 필터를 생성한 로그 그룹의 이름을 선택한 다음 **지표 필터** 탭을 선택합니다.
# 예제: 로그 이벤트 수 계산
가장 간단한 유형의 로그 이벤트 모니터링은 발생하는 로그 이벤트의 수를 계산하는 것입니다. 모든 이벤트의 수를 유지하거나, ‘하트비트’ 스타일 모니터를 생성하거나, 단순히 지표 필터 생성을 연습하기 위해 계산할 수 있습니다.
다음 CLI 예제에서는 MyNamespace라는 CloudWatch 네임스페이스에서 EventCount라는 지표를 생성하기 위해 MyAppAccessCount라는 지표 필터가 MyApp/access.log라는 로그 그룹에 적용됩니다. 이 필터는 모든 로그 이벤트 콘텐츠와 일치하며 지표를 ‘1’씩 늘리도록 구성되어 있습니다.
**CloudWatch 콘솔을 사용하여 지표 필터를 생성하려면**
1. [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)에서 CloudWatch 콘솔을 엽니다.
1. 탐색 창에서 **로그 그룹**을 선택합니다.
1. 로그 그룹의 이름을 선택합니다.
1. 작업, **지표 필터 생성**을 선택합니다.
1. **필터 패턴** 및 **테스트할 로그 데이터 선택**을 비워 둡니다.
1. **다음**을 선택한 후 **필터 이름**에 **EventCount**를 입력합니다.
1. **지표 세부 정보**의 **지표 네임스페이스**에 **MyNameSpace**를 입력합니다.
1. **지표 이름**에 **MyAppEventCount**를 입력합니다.
1. **지표 값**이 1인지 확인합니다. 이는 모든 로그 이벤트에 대해 개수가 1씩 증가하도록 지정합니다.
1. **기본값**에 0을 입력하고 **다음**을 선택합니다. 기본값을 지정할 경우 로그 이벤트가 발생하지 않는 기간에도 데이터가 보고되므로 때때로 데이터가 존재하지 않아 지표가 불규칙해지는 것을 방지할 수 있습니다.
1. **지표 필터 생성**을 선택합니다.
**를 사용하여 지표 필터를 생성하려면 AWS CLI**
명령 프롬프트에서 다음 명령을 실행합니다.
```
aws logs put-metric-filter \
--log-group-name MyApp/access.log \
--filter-name EventCount \
--filter-pattern " " \
--metric-transformations \
metricName=MyAppEventCount,metricNamespace=MyNamespace,metricValue=1,defaultValue=0
```
모든 이벤트 데이터를 게재하여 이 새로운 정책을 테스트할 수 있습니다. 데이터 요소가 MyAppAccessEventCount 지표에 게시되어 있어야 합니다.
**를 사용하여 이벤트 데이터를 게시하려면 AWS CLI**
명령 프롬프트에서 다음 명령을 실행합니다.
```
aws logs put-log-events \
--log-group-name MyApp/access.log --log-stream-name TestStream1 \
--log-events \
timestamp=1394793518000,message="Test event 1" \
timestamp=1394793518000,message="Test event 2" \
timestamp=1394793528000,message="This message also contains an Error"
```
# 예제: 단어의 출현 횟수 계산
로그 이벤트에는 연산의 성공 또는 실패 횟수같이 계산이 필요한 중요한 메시지가 종종 포함됩니다. 예를 들어 지정된 연산이 실패하면 오류가 발생하고 로그 파일에 오류가 기록될 수 있습니다. 이들 항목을 모니터링하여 오류의 트렌드를 이해하고 싶을 수 있습니다.
아래 예제에서는 Error라는 단어를 모니터링하기 위한 지표 필터가 생성됩니다. 정책이 생성되어 로그 그룹 **MyApp/message.log**에 추가되었습니다. CloudWatch Logs는 **MyApp/message.log** 네임스페이스에서 Error가 포함된 모든 이벤트에 대해 값 ‘1’을 사용하여 데이터 포인트를 CloudWatch 사용자 지정 지표 ErrorCount에 게시합니다. Error라는 단어가 포함된 이벤트가 없으면 값 0이 게시됩니다. CloudWatch 콘솔에서 이 데이터를 그래픽 처리할 때는 반드시 Sum 통계를 사용해야 합니다.
지표 필터를 생성한 후 CloudWatch 콘솔에서 지표를 볼 수 있습니다. 보려는 지표를 선택할 때 로그 그룹 이름과 일치하는 지표 네임스페이스를 선택합니다. 자세한 내용은 [사용 가능한 지표 보기](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/viewing_metrics_with_cloudwatch.html)를 참조하세요.
**CloudWatch 콘솔을 사용하여 지표 필터를 생성하려면**
1. [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)에서 CloudWatch 콘솔을 엽니다.
1. 탐색 창에서 **로그 그룹**을 선택합니다.
1. 로그 그룹의 이름을 선택합니다.
1. **작업**, **지표 필터 생성**을 선택합니다.
1. **필터 패턴**에 **Error**를 입력합니다.
**참고**
**필터 패턴**의 모든 항목들은 대소문자를 구분합니다.
1. (선택 사항) 필터 패턴을 테스트하려면 **테스트 패턴**에 패턴을 테스트하는 데 사용할 로그 이벤트를 하나 이상 입력합니다. 줄 바꿈은 **로그 이벤트 메시지** 상자에서 로그 이벤트를 구분할 때 사용하므로 각 로그 이벤트는 한 줄을 넘지 않아야 합니다.
1. **다음**을 선택한 후 **지표 할당** 페이지에서 **필터 이름**에 **MyAppErrorCount**를 입력합니다.
1. **지표 세부 정보**의 **지표 네임스페이스**에 **MyNameSpace**를 입력합니다.
1. **지표 이름**에 **ErrorCount**를 입력합니다.
1. **지표 값**이 1인지 확인합니다. 이는 ‘Error’를 포함하는 모든 로그 이벤트에 대해 개수가 1씩 증가하도록 지정합니다.
1. **기본값**에 0을 입력하고 **다음**을 선택합니다.
1. **지표 필터 생성**을 선택합니다.
**를 사용하여 지표 필터를 생성하려면 AWS CLI**
명령 프롬프트에서 다음 명령을 실행합니다.
```
aws logs put-metric-filter \
--log-group-name MyApp/message.log \
--filter-name MyAppErrorCount \
--filter-pattern 'Error' \
--metric-transformations \
metricName=ErrorCount,metricNamespace=MyNamespace,metricValue=1,defaultValue=0
```
메시지에 ‘Error’라는 단어가 포함된 이벤트를 게재하여 이 새로운 정책을 테스트할 수 있습니다.
**를 사용하여 이벤트를 게시하려면 AWS CLI**
명령 프롬프트에서 다음 명령을 실행합니다. 패턴은 대소문자를 구분한다는 점을 유의하세요.
```
aws logs put-log-events \
--log-group-name MyApp/access.log --log-stream-name TestStream1 \
--log-events \
timestamp=1394793518000,message="This message contains an Error" \
timestamp=1394793528000,message="This message also contains an Error"
```
# 예제: HTTP 404 코드 수 계산
CloudWatch Logs를 사용하여 Apache 서버가 발견되지 않은 페이지에 대한 응답 코드인 HTTP 404 응답을 반환하는 횟수를 모니터링할 수 있습니다. 사이트 방문자들이 원하는 리소스를 찾지 못하는 빈도를 파악하기 위해 모니터링을 원할 수 있습니다. 로그 레코드는 각 로그 이벤트(사이트 방문)에 대해 다음 정보를 포함하도록 구성되었다고 가정합니다.
+ 요청자 IP 주소
+ RFC 1413 ID
+ 사용자 이름
+ 타임스탬프
+ 요청된 리소스와 프로토콜이 포함된 요청 메서드
+ 요청할 HTTP 응답 코드
+ 요청 시 전송되는 바이트
예를 들어 다음과 같은 형태일 수 있습니다.
```
127.0.0.1 - frank [10/Oct/2000:13:55:36 -0700] "GET /apache_pb.gif HTTP/1.0" 404 2326
```
다음 예제에서 알 수 있듯이, HTTP 404 오류에서 해당 구조의 이벤트와 매칭을 시도하는 규칙을 지정할 수 있습니다.
**CloudWatch 콘솔을 사용하여 지표 필터를 생성하려면**
1. [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)에서 CloudWatch 콘솔을 엽니다.
1. 탐색 창에서 **로그 그룹**을 선택합니다.
1. 작업, **지표 필터 생성**을 선택합니다.
1. **필터 패턴**에 **[IP, UserInfo, User, Timestamp, RequestInfo, StatusCode=404, Bytes]**를 입력합니다.
1. (선택 사항) 필터 패턴을 테스트하려면 **테스트 패턴**에 패턴을 테스트하는 데 사용할 로그 이벤트를 하나 이상 입력합니다. 줄 바꿈은 **로그 이벤트 메시지** 상자에서 로그 이벤트를 구분할 때 사용하므로 각 로그 이벤트는 한 줄을 넘지 않아야 합니다.
1. **다음**을 선택하고 **필터 이름**에 **HTTP404Errors**를 입력합니다.
1. **지표 세부 정보**의 **지표 네임스페이스**에 **MyNameSpace**를 입력합니다.
1. **지표 이름**에 **ApacheNotFoundErrorCount**를 입력합니다.
1. **지표 값**이 1인지 확인합니다. 이는 모든 404 오류 이벤트에 대해 개수가 1씩 증가하도록 지정합니다.
1. **기본값**에 0을 입력하고 **다음**을 선택합니다.
1. **지표 필터 생성**을 선택합니다.
**를 사용하여 지표 필터를 생성하려면 AWS CLI**
명령 프롬프트에서 다음 명령을 실행합니다.
```
aws logs put-metric-filter \
--log-group-name MyApp/access.log \
--filter-name HTTP404Errors \
--filter-pattern '[ip, id, user, timestamp, request, status_code=404, size]' \
--metric-transformations \
metricName=ApacheNotFoundErrorCount,metricNamespace=MyNamespace,metricValue=1
```
이 예제에서는 왼쪽/오른쪽 대괄호, 큰따옴표, 문자열 404 같은 리터럴 문자가 사용되었습니다. 패턴은 모니터링하려는 로그 이벤트의 전체 로그 이벤트 메시지와 일치해야 합니다.
**describe-metric-filters** 명령을 사용하여 지표 필터가 생성되었는지 확인할 수 있습니다. 다음과 유사한 출력 화면이 표시되어야 합니다.
```
aws logs describe-metric-filters --log-group-name MyApp/access.log
{
"metricFilters": [
{
"filterName": "HTTP404Errors",
"metricTransformations": [
{
"metricValue": "1",
"metricNamespace": "MyNamespace",
"metricName": "ApacheNotFoundErrorCount"
}
],
"creationTime": 1399277571078,
"filterPattern": "[ip, id, user, timestamp, request, status_code=404, size]"
}
]
}
```
수동으로 몇 가지 이벤트를 게재할 수 있습니다.
```
aws logs put-log-events \
--log-group-name MyApp/access.log --log-stream-name hostname \
--log-events \
timestamp=1394793518000,message="127.0.0.1 - bob [10/Oct/2000:13:55:36 -0700] \"GET /apache_pb.gif HTTP/1.0\" 404 2326" \
timestamp=1394793528000,message="127.0.0.1 - bob [10/Oct/2000:13:55:36 -0700] \"GET /apache_pb2.gif HTTP/1.0\" 200 2326"
```
이러한 샘플 로그 이벤트를 게재하고 나면 그 즉시 CloudWatch 콘솔에서 ApacheNotFoundErrorCount로 명명된 지표를 검색할 수 있습니다.
# 예제: HTTP 4xx 코드 수 계산
이전 예제에서와 마찬가지로 사용자는 웹 서비스 액세스 로그를 모니터링하고 HTTP 응답 코드 수준을 모니터링하려고 할 수 있습니다. 예를 들어 HTTP 400 수준 오류를 모두 모니터링하고 싶을 수 있습니다. 그러나 모든 반환 코드에 새로운 지표 필터를 지정하고 싶지 않을 수 있습니다.
다음 예제는 [예제: HTTP 404 코드 수 계산](Counting404Responses.md) 예제에서 Apache 액세스 로그 형식을 사용하여 액세스 로그로부터 400 수준의 모든 HTTP 코드 응답을 포함하는 지표를 생성하는 방법을 보여줍니다.
**CloudWatch 콘솔을 사용하여 지표 필터를 생성하려면**
1. [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)에서 CloudWatch 콘솔을 엽니다.
1. 탐색 창에서 **로그 그룹**을 선택합니다.
1. Apache 서버의 로그 그룹 이름을 선택합니다.
1. 작업, **지표 필터 생성**을 선택합니다.
1. **필터 패턴**에 **[ip, id, user, timestamp, request, status\$1code=4\$1, size]**를 입력합니다.
1. (선택 사항) 필터 패턴을 테스트하려면 **테스트 패턴**에 패턴을 테스트하는 데 사용할 로그 이벤트를 하나 이상 입력합니다. 줄 바꿈은 **로그 이벤트 메시지** 상자에서 로그 이벤트를 구분할 때 사용하므로 각 로그 이벤트는 한 줄을 넘지 않아야 합니다.
1. **다음**을 선택한 후 **필터 이름**에 **HTTP4xxErrors**를 입력합니다.
1. **지표 세부 정보**의 **지표 네임스페이스**에 **MyNameSpace**를 입력합니다.
1. **지표 이름**에 **HTTP4xxErrors**를 입력합니다.
1. **지표 값**에 1을 입력합니다. 이는 4xx 오류를 포함하는 모든 로그 이벤트에 대해 개수가 1씩 증가하도록 지정합니다.
1. **기본값**에 0을 입력하고 **다음**을 선택합니다.
1. **지표 필터 생성**을 선택합니다.
**를 사용하여 지표 필터를 생성하려면 AWS CLI**
명령 프롬프트에서 다음 명령을 실행합니다.
```
aws logs put-metric-filter \
--log-group-name MyApp/access.log \
--filter-name HTTP4xxErrors \
--filter-pattern '[ip, id, user, timestamp, request, status_code=4*, size]' \
--metric-transformations \
metricName=HTTP4xxErrors,metricNamespace=MyNamespace,metricValue=1,defaultValue=0
```
PUT 이벤트 호출에서 다음 데이터를 사용하여 이 규칙을 테스트할 수 있습니다. 이전 예제에서 모니터링 규칙을 제거하지 않았다면 서로 다른 두 개의 지표가 생성됩니다.
```
127.0.0.1 - - [24/Sep/2013:11:49:52 -0700] "GET /index.html HTTP/1.1" 404 287
127.0.0.1 - - [24/Sep/2013:11:49:52 -0700] "GET /index.html HTTP/1.1" 404 287
127.0.0.1 - - [24/Sep/2013:11:50:51 -0700] "GET /~test/ HTTP/1.1" 200 3
127.0.0.1 - - [24/Sep/2013:11:50:51 -0700] "GET /favicon.ico HTTP/1.1" 404 308
127.0.0.1 - - [24/Sep/2013:11:50:51 -0700] "GET /favicon.ico HTTP/1.1" 404 308
127.0.0.1 - - [24/Sep/2013:11:51:34 -0700] "GET /~test/index.html HTTP/1.1" 200 3
```
# 예제: Apache 로그에서 필드 추출 후 차원 할당
때로는 수를 계산하는 대신 지표 값으로 개별 로그 이벤트 내의 값을 사용하는 것이 도움이 됩니다. 이 예제는 Apache 웹 서버에서 전송된 바이트를 측정하는 지표를 생성하기 위해 추출 규칙을 만드는 방법을 보여줍니다.
이 예제에서는 생성 중인 지표에 차원을 할당하는 방법도 보여줍니다.
**CloudWatch 콘솔을 사용하여 지표 필터를 생성하려면**
1. [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)에서 CloudWatch 콘솔을 엽니다.
1. 탐색 창에서 **로그 그룹**을 선택합니다.
1. Apache 서버의 로그 그룹 이름을 선택합니다.
1. 작업, **지표 필터 생성**을 선택합니다.
1. **필터 패턴**에 **[ip, id, user, timestamp, request, status\$1code, size]**를 입력합니다.
1. (선택 사항) 필터 패턴을 테스트하려면 **테스트 패턴**에 패턴을 테스트하는 데 사용할 로그 이벤트를 하나 이상 입력합니다. 줄 바꿈은 **로그 이벤트 메시지** 상자에서 로그 이벤트를 구분할 때 사용하므로 각 로그 이벤트는 한 줄을 넘지 않아야 합니다.
1. **다음**을 선택한 후 **필터 이름**에 **size**를 입력합니다.
1. **지표 세부 정보**의 **지표 네임스페이스**에 **MyNameSpace**를 입력합니다. 새 네임스페이스이기 때문에 **새로 생성**이 선택되어 있습니다.
1. **지표 이름**에 **BytesTransferred**를 입력합니다.
1. **지표 값**에 **\$1size**를 입력합니다.
1. **단위**로 **바이트**를 선택합니다.
1. **차원 이름**에 **IP**를 입력합니다.
1. **차원 값**에 **\$1ip**를 입력하고 **다음**을 선택합니다.
1. **지표 필터 생성**을 선택합니다.
**를 사용하여이 지표 필터를 생성하려면 AWS CLI**
명령 프롬프트에서 다음 명령을 실행합니다.
```
aws logs put-metric-filter \
--log-group-name MyApp/access.log \
--filter-name BytesTransferred \
--filter-pattern '[ip, id, user, timestamp, request, status_code, size]' \
--metric-transformations \
metricName=BytesTransferred,metricNamespace=MyNamespace,metricValue='$size'
```
```
aws logs put-metric-filter \
--log-group-name MyApp/access.log \
--filter-name BytesTransferred \
--filter-pattern '[ip, id, user, timestamp, request, status_code, size]' \
--metric-transformations \
metricName=BytesTransferred,metricNamespace=MyNamespace,metricValue='$size',unit=Bytes,dimensions='{{IP=$ip}}'
```
**참고**
이 명령에서는 이 형식을 사용하여 여러 차원을 지정합니다.
```
aws logs put-metric-filter \
--log-group-name my-log-group-name \
--filter-name my-filter-name \
--filter-pattern 'my-filter-pattern' \
--metric-transformations \
metricName=my-metric-name,metricNamespace=my-metric-namespace,metricValue=my-token,unit=unit,dimensions='{dimension1=$dim,dimension2=$dim2,dim3=$dim3}'
```
PUT 로그 이벤트 호출에서 다음 데이터를 사용하여 이 규칙을 테스트할 수 있습니다. 이전 예제에서 모니터링 규칙을 제거하지 않았다면 서로 다른 두 개의 지표가 생성됩니다.
```
127.0.0.1 - - [24/Sep/2013:11:49:52 -0700] "GET /index.html HTTP/1.1" 404 287
127.0.0.1 - - [24/Sep/2013:11:49:52 -0700] "GET /index.html HTTP/1.1" 404 287
127.0.0.1 - - [24/Sep/2013:11:50:51 -0700] "GET /~test/ HTTP/1.1" 200 3
127.0.0.1 - - [24/Sep/2013:11:50:51 -0700] "GET /favicon.ico HTTP/1.1" 404 308
127.0.0.1 - - [24/Sep/2013:11:50:51 -0700] "GET /favicon.ico HTTP/1.1" 404 308
127.0.0.1 - - [24/Sep/2013:11:51:34 -0700] "GET /~test/index.html HTTP/1.1" 200 3
```