대상 측정항목 구성

이 페이지에서는 측정항목 선택 도구를 사용하여 알림 정책의 대상 측정항목을 지정하는 방법을 설명합니다. 대상 영역 옆의 차트는 대상에서 캡처한 데이터에 대한 시각적 피드백을 제공합니다.

대상 영역에서는 차트 생성과 측정항목 탐색기에 사용되는 동일한 측정항목 선택기를 사용합니다. 측정항목 탐색기에 이미 익숙하다면 이 페이지를 건너뛸 수 있습니다.

측정항목 선택하기

측정항목을 선택하려면 리소스 유형 및 측정항목 찾기 필드를 사용하여 하나의 리소스 유형과 하나의 측정항목 유형을 선택합니다. 이 두 가지는 순서에 관계없이 지정할 수 있습니다. 시작하려면 필드를 클릭합니다. 그러면 이전 선택에 따라 1개 또는 2개의 목록이 표시됩니다. 다음 스크린샷에 표시된 것처럼 목록이 헤더, 리소스 유형, 측정항목으로 표시됩니다.

측정항목 및 리소스 선택 시 검색 목록

항목은 두 가지 방법으로 선택할 수 있습니다.

  • 목록에서 항목을 선택합니다.

  • 측정항목 필터를 입력합니다. 측정항목 필터를 입력하려면 다음을 수행합니다.

    1. 리소스 유형 및 측정항목 찾기 옆의 도움말을 클릭합니다.
    2. 도움말 창에서 직접 필터 모드를 클릭합니다.

      직접 필터 모드를 사용 설정하면 리소스 유형 및 측정항목 찾기 옵션이 리소스 유형, 측정항목, 필터 라벨이 지정된 수정 가능한 텍스트 상자로 바뀝니다.

      표시된 직접 필터 모드

      직접 필터 모드를 선택하기 전에 리소스 유형, 측정항목 또는 필터에 대해 선택했으면 해당 설정을 사용하여 리소스 유형, 측정항목, 필터 텍스트 상자가 미리 채워집니다.

    3. 리소스 유형, 측정항목, 필터 텍스트 상자에 측정항목 필터를 입력합니다. 필터에는 측정항목 유형과 리소스 유형이 포함되어야 합니다. 라벨 필터를 포함할 수도 있습니다. 필터 문법은 Monitoring 필터를 참조하세요.

      예를 들어 us-east1-b 영역에 있는 모든 Google Cloud VM 인스턴스의 로그 항목을 표시하려면 다음을 입력합니다.

      metric.type="logging.googleapis.com/log_entry_count" resource.type="gce_instance" resource.label."zone"="us-east1-b"
      

      직접 필터 모드를 사용하여 차트 또는 알림 정책을 구성했고 데이터가 없는 경우 차트에 오류 메시지가 표시됩니다. 정확한 오류 메시지는 입력한 필터에 따라 다릅니다. 예를 들어 일반적인 메시지는 Chart definition invalid입니다. No data is available for the selected time frame. 메시지가 표시될 수도 있습니다.

목록에 표시된 항목 위로 마우스를 가져가면 항목 설명이 포함된 도움말이 나타납니다. 측정항목 유형 또는 모니터링 리소스 설명에 대한 자세한 내용은 측정항목 목록 또는 모니터링 리소스 목록을 참조하세요.

하나 이상의 리소스 유형과 측정항목 쌍이 선택된 경우, 사용 가능한 모든 시계열이 차트에 표시되고, 측정항목 탭에서 지정된 측정항목 아래에 추가 항목이 표시됩니다. 다음 스크린샷은 측정항목을 지정한 이후의 측정항목 탭을 보여줍니다.

추가 선택 옵션을 표시합니다.

필터링

일부 기준 집합을 충족하는 시계열만 사용되도록 필터 기준을 지정하면 측정항목의 반환되는 데이터 양을 줄일 수 있습니다. 필터를 적용하면 차트의 선 수가 줄어들어 차트의 성능을 개선할 수 있습니다.

필터링 기준은 여러 개를 지정할 수 있습니다. 이 경우 차트에는 논리적 AND를 사용하여 모든 기준을 충족하는 시계열만 표시됩니다.

Google Cloud Console에서 필터를 추가하려면 필터 필드를 클릭합니다. 그러면 필터링할 수 있는 기준 목록이 포함된 패널이 열립니다. 예를 들어 리소스 그룹, 이름, 리소스 라벨, 영역, 측정항목 라벨을 기준으로 필터링할 수 있습니다.

다음 스크린샷은 프로젝트에 사용 가능한 알려진 필터링 기준 라벨을 보여줍니다.

미리 채워진 필터 라벨 목록

목록에서 선택하거나 이름을 입력하여 일치하는 항목을 찾을 수 있습니다. 또한 아직 표시되지 않은 데이터의 필터도 만들 수 있습니다. 이러한 필터 기준은 선택 목록에 표시되지 않지만, 나중에 유용할 것 같은 필터를 사용자가 수동으로 지정할 수 있습니다.

필터링할 라벨을 선택한 후에는 값, 값 범위, 비교 등 필터의 나머지 부분을 지정해야 합니다.

예를 들어 다음 스크린샷에서는 zone 리소스 라벨에 대한 필터를 보여줍니다. 필터 필드는 같음의 비교 연산자 쌍 ==~와 같지 않음의 비교 연산자 쌍 !=!=~을 지원합니다. 각 쌍의 두 번째 항목은 정규 표현식을 값으로 사용합니다. 기본값은 단순 같음 =입니다.

필터 비교 연산자

비교 연산자 목록 아래에는 사용 가능한 값 목록이 있습니다. 다음 스크린샷은 프로젝트의 영역 이름을 보여줍니다.

미리 채워진 일부 필터 값

필드에서는 드롭다운 목록의 항목 중 하나를 선택하거나 여러 항목과 일치하는 표현식을 입력할 수 있습니다.

  • 직접 비교 = 또는 !=를 사용하는 경우 starts_with와 같은 필터 문자열을 만들 수 있습니다. 예를 들어 필터 문자열 starts_with("us-central")은 모든 us-central 영역과 일치합니다.

    필터 문자열 사용

    필터 문자열에 대한 자세한 내용은 Monitoring 필터를 참조하세요.

  • =~ 또는 !=~을(를) 선택하면 값에 RE2 정규 표현식을 사용할 수 있습니다. 예를 들어 정규 표현식 us-central1-.*는 모든 us-central1 영역과 일치합니다.

    정규 표현식을 사용한 필터링

    정규 표현식 ^us.*.a$는 'a'로 끝나는 모든 미국 영역과 일치합니다.

    더 많은 정규 표현식으로 필터링

여러 필터 기준을 지정할 수 있으며 동일한 라벨을 여러 번 사용할 수 있습니다. 이렇게 하면 특정 값 범위에 대한 필터를 지정할 수 있습니다. 필터를 추가하려면 필터 필드 하단에 있는 필터 추가를 클릭합니다. 현재는 필터가 논리적 AND로 구성되므로 모든 필터 기준이 충족되어야 합니다. 예를 들어 starts_withends_with 필터 문자열을 둘 다 사용하여 미국의 'a' 영역만 표시할 수 있습니다.

여러 필터 사용

집계

시계열을 선택한 후에는 다음 단계로 집계 옵션을 지정합니다. 집계는 개별 시계열 정렬과 정렬된 시계열을 조합하여 구성합니다. 집계에 대한 자세한 설명은 필터링 및 집계: 시계열 조작을 참조하세요.

데이터 정렬

정렬은 Monitoring에서 수신한 시계열 데이터를 고정된 기간의 데이터 포인트가 있는 새 시계열로 변환하는 프로세스입니다. 정렬 프로세스는 고정된 시간 간격 내에 수신된 모든 데이터 포인트를 수집하고, 해당 데이터 포인트를 결합하는 함수를 적용하고, 결과에 타임 스탬프를 할당하는 과정으로 구성됩니다. 이러한 결합 함수를 사용하면 모든 샘플의 평균을 계산하거나 모든 샘플의 최댓값을 추출할 수 있습니다. 정렬에 대한 일반적인 설명은 정렬: 계열 내 정규화를 참조하세요.

알림 정책에 조건을 만들 때는 정렬 매개 변수를 지정해야 합니다. Google Cloud Console을 사용하는 경우 알림 조건에서 리소스 유형과 측정항목을 선택하면 몇 가지 추가 필드와 고급 옵션 표시 버튼이 표시됩니다.

기간 필드의 디스플레이

기간(Period): 기간은 특정 시점으로부터의 탐색 간격입니다. 예를 들어 기간이 5분이면 오후 1시에는 12:55 ~ 오후 1:00 사이에 수신된 샘플이 정렬됩니다. 오후 1:01에는 오후 12:56 ~ 1:01 사이에 수신된 샘플이 정렬됩니다. 알림 정책의 관점에서 정렬 기간은 과거를 들여다보는 미닫이 창이라고 할 수 있습니다. 이 필드에 대한 자세한 내용은 정렬 기간 및 기간을 참조하세요.

나머지 집계 옵션을 보려면 고급 옵션 표시를 클릭합니다.

고급 옵션의 디스플레이

정렬기: 정렬기 필드는 정렬 기간 내 모든 데이터 포인트를 결합하는 데 사용되는 함수를 지정합니다. 사용 가능한 정렬기에 대한 자세한 내용은 API 참조에서 Aligner를 확인하세요. 일부 정렬기는 데이터를 정렬하고 다른 측정항목 종류 또는 유형으로 변환합니다. 자세한 내용은 종류, 유형, 전환을 참조하세요.

시계열 결합

서로 다른 시계열을 결합하여 측정항목에 대해 반환되는 데이터 양을 줄일 수 있습니다. 여러 시계열을 결합하려면 일반적으로 그룹화 및 함수를 지정합니다. 그룹화는 라벨을 기준으로 수행됩니다. Google Cloud Console에서 애그리게이터라는 함수는 그룹의 시계열을 단일 시계열로 결합하는 데 사용됩니다. 일반적인 애그리게이터에는 평균, 최댓값, 최솟값, 표준 편차, 여러 가지 백분위수 값이 포함됩니다.

그룹화를 추가하려면 그룹화 기준 텍스트 상자에서 라벨 추가를 클릭한 다음 메뉴에서 선택합니다. 메뉴는 동적으로 구성되며 사용 가능한 라벨을 표시합니다. 이러한 라벨은 필터링에도 사용할 수 있는 라벨입니다. 첫 번째 그룹화 옵션을 추가하면 다음과 같은 결과가 발생합니다.

  • 애그리게이터가 선택되며, 선택한 함수는 표시되는 데이터 유형에 따라 결정됩니다. 이 함수는 변경할 수 있습니다.
  • 애그리게이터는 라벨 값이 동일한 모든 시계열을 단일 시계열로 결합합니다.
  • 차트는 그룹화 기준 라벨의 각 값에 대해 하나의 시계열을 표시합니다.

다음 스크린샷은 애그리게이터가 기본값인 sum으로 설정된 user_labels.version별 그룹화를 보여줍니다.

그룹화 설정의 예시

이렇게 하면 user_labels.version의 각 값에 대해 하나의 시계열이 생성됩니다. 각 시계열의 데이터 포인트는 특정 버전에 대한 개별 시계열의 모든 값 합계에서 계산됩니다.

user_labels.version으로 그룹화된 시계열 표시

여러 라벨을 사용하여 그룹화할 수 있습니다. 그룹화 옵션이 여러 개 있는 경우 시계열이 라벨 값의 각 조합에 따라 그룹화되고 애그리게이터가 각 그룹에 적용됩니다. 결과 차트는 라벨 값 조합마다 하나의 시계열을 표시합니다. 라벨을 지정하는 순서는 중요하지 않습니다.

예를 들어 다음 스크린샷은 user_labels.versionsystem_labels.machine_image를 기준으로 그룹화하는 방법을 보여줍니다.

시계열을 버전 및 머신 이미지별로 그룹화하여 표시

그림과 같이 두 라벨로 그룹화하면 각 값 쌍에 대해 하나의 시계열이 생성됩니다. 라벨 조합마다 시계열을 얻을 수 있으므로, 이 기법을 사용하면 단일 차트에 효율적으로 넣을 수 있는 것보다 많은 데이터가 생성됩니다.

그룹화 옵션을 지정하지 않고 애그리게이터를 지정하면 애그리게이터가 선택한 모든 시계열에 적용되고 단일 시계열이 생성됩니다. 이 동작은 다음 스크린샷에 나와 있습니다.

합계로 집계되지만 그룹화하지 않은 시계열 표시

그룹화를 지정하거나 애그리게이터를 선택하면 결과 시계열에는 프로젝트 식별자와 같은 필수 라벨과 그룹화에서 지정한 라벨만 포함됩니다.

그룹화 기준 조건을 삭제하려면 다음 단계를 따릅니다.

  1. 그룹화 기준 라벨을 삭제합니다.
  2. 애그리게이터를 none으로 설정합니다.

보조 집계

그룹화 기준 옵션에서 설명한 예와 같이 집계를 표시하는 시계열이 여러 개 있으면 보조 집계를 선택하여 집계할 수 있습니다.

보조 집계 필드

보조 집계는 차트의 모든 시계열을 단일 시계열로 축소합니다.

범례 템플릿

Cloud Console에서 고급 옵션 표시를 클릭하여 집계 옵션을 확장하면 정렬기, 정렬 기간, 보조 애그리게이터, 범례 템플릿의 필드가 표시됩니다.

범례 템플릿 필드 위치 표시

범례 템플릿 필드를 사용하면 차트의 시계열에 대한 설명을 맞춤설정할 수 있습니다. 이러한 설명은 차트의 호버 카드와 이름 열의 차트 범례에 나타납니다.

기본적으로 범례 설명은 시계열의 다른 라벨 값에서 자동으로 생성됩니다. 라벨은 시스템에서 선택하기 때문에 결과가 도움이 되지 않을 수 있습니다. 이 필드를 사용하여 설명 템플릿을 작성할 수 있습니다.

범례 템플릿 필드에 허용되는 값은 다음과 같습니다.

  • 시계열의 라벨을 참조하는 필터. 시계열에 사용 가능한 모든 필터를 보려면 필터 추가를 클릭합니다. 필터를 선택하면 텍스트 상자에 필터가 추가되고 ${resource.labels.zone}와 같은 표현식으로 표시됩니다. 표현식이 평가되면 시계열의 라벨에서 값을 가져와 범례에 삽입합니다.

  • 일반 텍스트 텍스트만 입력할 경우 차트의 시계열에 대한 설명이 동일하게 표시됩니다. 하지만 텍스트와 필터를 결합할 수 있습니다.

예를 들어 다음 스크린샷은 일반 텍스트 문자열과 필터 표현식 ${resource.labels.zone}으로 구성된 템플릿을 보여줍니다.

간단한 설명 템플릿

차트 범례에서는 템플릿에서 생성된 값이 이름 헤더가 있는 열과 호버 카드에 표시됩니다.

템플릿에서 생성된 설명

여러 문자열과 필터를 사용하는 템플릿을 만들 수 있지만 호버 카드에서 사용할 수 있는 표시 공간은 제한되어 있습니다.