측정항목 탐색기로 차트 만들기

이 문서에서는 측정항목 탐색기로 임시 차트를 빌드하여 측정항목 데이터를 탐색하는 방법을 설명합니다. 예를 들어 가상 머신(VM)의 CPU 사용률을 보려면 측정항목 탐색기를 사용해서 최신 데이터를 표시하는 차트를 만들 수 있습니다. 영구 차트를 원하는 경우 측정항목 탐색기를 사용하여 차트를 만들어 커스텀 대시보드에 저장할 수 있습니다. 다른 방법은 차트, 로그, 이슈, 기타 콘텐츠를 표시할 수 있는 커스텀 대시보드를 만든 후 대시보드 인터페이스를 사용하여 대시보드에 차트를 추가하는 것입니다. 커스텀 대시보드에 대한 자세한 내용은 커스텀 대시보드 만들기 및 관리를 참조하세요.

단일 측정항목 유형이 표시된 차트 또는 여러 측정항목 유형이 표시된 복합 차트를 만들 수 있습니다. 측정항목 탐색기로 차트를 만든 후에는 이를 삭제하거나, 커스텀 대시보드에 저장하거나, 해당 구성을 저장하거나, 차트를 공유할 수도 있습니다.

다음 스크린샷은 측정항목 탐색기 페이지에서 단일 측정항목 유형(VM 인스턴스의 CPU 사용률)이 표시된 차트를 보여줍니다.

이전 스크린샷에는 여러 줄이 표시되며 각 줄은 특정 영역에 있는 모든 VM의 평균 CPU 사용률을 보여줍니다.

참고: 대시보드에 있는 차트를 보고 차트 구성을 보거나 차트를 다른 대시보드에 복사하려면 차트 옵션을 사용하여 차트 측정항목 탐색기를 볼 수 있는지 확인합니다. 이 옵션을 선택하면 측정항목 탐색기가 열리고 보고 있는 데이터가 표시됩니다. 그런 다음 구성을 보거나 수정하거나 커스텀 대시보드에 차트를 저장할 수 있습니다.

단일 측정항목 유형 차트 작성

단일 측정항목을 표시하도록 차트를 구성하려면 다음을 수행합니다.

1. Google Cloud 콘솔의 탐색 패널에서 Monitoring을 선택한 후 측정항목 탐색기를 선택합니다.

   측정항목 탐색기로 이동

2. 차트에 표시될 데이터를 지정합니다. 메뉴 기반 인터페이스, 모니터링 쿼리 언어(MQL), PromQL을 사용하거나 Monitoring 필터를 입력할 수 있습니다.

   메뉴 기반 인터페이스

   1. 확인하려는 시계열 데이터를 선택합니다.

      1. 측정항목 요소에서 측정항목 선택 메뉴를 확장합니다.

         측정항목 선택 메뉴에는 사용 가능한 측정항목 유형을 찾는 데 도움이 되는 기능이 포함되어 있습니다.

         • 특정 측정항목 유형을 찾으려면 필터 막대를 사용합니다. 예를 들어 util을 입력하면 util이 포함된 항목이 표시되도록 메뉴를 제한합니다. 항목이 대소문자를 구분하지 않는 'contains' 테스트를 통과하면 표시됩니다.

         • 데이터가 없는 측정항목 유형을 포함하여 모든 측정항목 유형을 표시하려면 활성을 클릭합니다. 기본적으로 메뉴에는 데이터가 있는 측정항목 유형만 표시됩니다.

         예를 들어 다음 항목을 선택할 수 있습니다.

         1. 활성 리소스 메뉴에서 VM 인스턴스를 선택합니다.
         2. 활성 측정항목 카테고리 메뉴에서 uptime_check를 선택합니다.
         3. 활성 측정항목 메뉴에서 요청 지연 시간을 선택합니다.
         4. 적용을 클릭합니다.

      2. 선택사항: 표시할 데이터의 하위 집합을 지정하려면 필터 요소에서 필터 추가를 선택한 후 대화상자를 완료합니다. 예를 들어 필터를 적용하면 한 영역의 데이터를 볼 수 있습니다. 여러 필터를 추가할 수 있습니다. 자세한 내용은 차트 데이터 필터링을 참조하세요.

      자세한 내용은 차트에 표시할 데이터 선택을 참조하세요.

   2. 시계열 조합 및 정렬:

      • 모든 시계열을 표시하려면 집계 요소에서 첫 번째 메뉴를 집계되지 않음으로, 두 번째 메뉴를 없음으로 설정합니다.

      • 시계열을 조합하려면 집계 요소에서 다음을 수행합니다.

        1. 첫 번째 메뉴를 확장하고 함수를 선택합니다.

           차트가 새로고침되고 단일 시계열이 표시됩니다. 예를 들어 평균을 선택하면 모든 시계열의 평균이 시계열로 표시됩니다.

        2. 라벨 값이 동일한 시계열을 조합하려면 두 번째 메뉴를 확장한 후 하나 이상의 라벨을 선택합니다.

           차트가 새로고침되고 각각의 고유한 라벨 값 조합에 대해 하나의 시계열이 표시됩니다. 예를 들어 영역당 하나의 시계열을 표시하려면 두 번째 메뉴를 영역으로 설정합니다.

           두 번째 메뉴가 없음으로 설정되면 차트에 하나의 시계열이 표시됩니다.

      • 선택사항: 데이터 포인트 사이의 간격을 구성하려면 쿼리 요소 추가를 클릭하고 최소 간격을 선택한 후 값을 입력합니다.

      그룹화 및 정렬에 대한 자세한 내용은 차트 데이터 표시 방법 선택을 참조하세요.

   3. 선택사항: 최댓값 또는 최솟값이 있는 시계열만 표시하려면 정렬 및 제한 요소를 사용합니다.

   MQL

   1. 쿼리 빌더 창의 툴바에서 이름이  MQL 또는  PromQL인 버튼을 선택합니다.
   2. 언어 전환 버튼에 MQL이 선택되어 있는지 확인합니다. 언어 전환 버튼은 쿼리 형식을 지정할 수 있는 동일한 툴바에 있습니다.

   3. 쿼리 편집기에 쿼리를 입력합니다. 예를 들어 Google Cloud 프로젝트에서 VM 인스턴스의 CPU 사용률을 차트로 작성하려면 다음 쿼리를 사용합니다.

      fetch gce_instance
      | metric 'compute.googleapis.com/instance/cpu/utilization'
      | group_by 1m, [value_utilization_mean: mean(value.utilization)]
      | every 1m
      

      MQL에 대한 자세한 내용은 다음 문서를 참조하세요.

      • MQL 소개
      • MQL용 코드 편집기 사용

   PromQL

   1. 쿼리 빌더 창의 툴바에서 이름이  MQL 또는  PromQL인 버튼을 선택합니다.
   2. 언어 전환 버튼에 PromQL이 선택되어 있는지 확인합니다. 언어 전환 버튼은 쿼리 형식을 지정할 수 있는 동일한 툴바에 있습니다.

   3. 쿼리 편집기에 쿼리를 입력합니다. 예를 들어 Google Cloud 프로젝트에서 VM 인스턴스의 평균 CPU 사용률을 차트로 작성하려면 다음 쿼리를 사용합니다.

      avg(compute_googleapis_com:instance_cpu_utilization)
      

      PromQL 사용에 대한 자세한 내용은 Cloud Monitoring의 PromQL을 참조하세요.

   Monitoring 필터

   1. 측정항목 요소에서 도움말을 클릭한 후 직접 필터 모드를 선택합니다.

      측정항목과 필터 요소가 삭제되고 텍스트를 입력할 수 있는 필터 요소가 생성됩니다.

      직접 필터 모드로 전환하기 전 리소스 유형, 측정항목 또는 필터를 선택한 경우 해당 설정이 필터 요소의 필드에 표시됩니다.

   2. 필터 요소 필드에 Monitoring 필터를 입력합니다.

   3. 시계열 조합 및 정렬:

      • 모든 시계열을 표시하려면 집계 요소에서 첫 번째 메뉴를 집계되지 않음으로, 두 번째 메뉴를 없음으로 설정합니다.

      • 시계열을 조합하려면 집계 요소에서 다음을 수행합니다.

        1. 첫 번째 메뉴를 확장하고 함수를 선택합니다.

           차트가 새로고침되고 단일 시계열이 표시됩니다. 예를 들어 평균을 선택하면 모든 시계열의 평균이 시계열로 표시됩니다.

        2. 라벨 값이 동일한 시계열을 조합하려면 두 번째 메뉴를 확장한 후 하나 이상의 라벨을 선택합니다.

           차트가 새로고침되고 각각의 고유한 라벨 값 조합에 대해 하나의 시계열이 표시됩니다. 예를 들어 영역당 하나의 시계열을 표시하려면 두 번째 메뉴를 영역으로 설정합니다.

           두 번째 메뉴가 없음으로 설정되면 차트에 하나의 시계열이 표시됩니다.

      • 선택사항: 데이터 포인트 사이의 간격을 구성하려면 쿼리 요소 추가를 클릭하고 최소 간격을 선택한 후 값을 입력합니다.

      그룹화 및 정렬에 대한 자세한 내용은 차트 데이터 표시 방법 선택을 참조하세요.

3. 선택한 측정항목 유형에 따라 차트 설정을 업데이트합니다.

   • 할당량 측정항목 유형의 경우 다음 설정을 사용합니다.

     • 툴바에서 시간 제어를 최소 1주일로 설정합니다. 할당량 측정항목은 일반적으로 하루 하나의 샘플을 보고합니다.
     • 표시 창에서 위젯 유형 메뉴를 펼친 후 누적 막대 그래프를 선택합니다.

   • Distribution 값 유형의 측정항목 유형인 경우 위젯 유형 메뉴가 히트맵 차트로 설정되어 있어야 합니다. 자세한 내용은 분포 값 측정항목 정보를 참조하세요.

   • 다른 측정항목 유형의 경우 위젯 유형 메뉴를 사용하여 데이터가 표시되는 방법을 표시합니다. 위젯 유형 메뉴에는 사용 가능한 모든 위젯 유형이 나열됩니다. 하지만 일부 위젯은 사용 설정되지 않을 수 있습니다. 여러 시계열을 표시하는 차트를 살펴보고 측정된 각 값이 두 배라고 가정합니다.

     • 선 차트, 누적 막대 차트, 누적 영역 차트 위젯은 호환 가능으로 나열됩니다. 이러한 유형 중 하나를 선택할 수 있습니다.
     • 히트맵 위젯은 분포 값 데이터만 표시할 수 있으므로 중지됩니다.

4. 선택사항: 차트에 선택한 데이터가 표시되는 방식을 변경하려면 표시 창의 옵션을 사용합니다.

   • X-Ray 모드로 표시하거나 통계를 표시하도록 차트를 구성하려면 분석 모드를 클릭합니다.
   • 현재 데이터와 이전 데이터를 비교하려면 과거와 비교를 클릭합니다.
   • 참조 기준을 추가하려면 기준 선을 클릭합니다.
   • 범례 열 이름을 구성하려면 범례 별칭을 클릭합니다.
   • Y축 할당, 라벨, 배율을 구성하려면 Y축 할당, Y축 라벨, Y축 배율 메뉴를 사용합니다.

여러 측정항목 유형 차트 작성

일부 경우에는 동일 차트에서 여러 측정항목 유형의 시계열을 표시해야 할 수 있습니다. 예를 들어 VM에서 읽기 및 쓰기 로드를 비교하려면 읽기 바이트 수와 쓰기 바이트 수를 표시하도록 차트를 구성합니다.

여러 측정항목을 차트로 표시하려면 메뉴 기반 인터페이스를 사용해야 합니다. 다른 인터페이스에서는 여러 측정항목의 차트 작성을 지원하지 않습니다.

차트에 여러 측정항목을 표시하려면 다음 안내를 따르세요.

1. Google Cloud 콘솔의 탐색 패널에서 Monitoring을 선택한 후 측정항목 탐색기를 선택합니다.

   측정항목 탐색기로 이동

2. 차트에 표시될 데이터를 지정합니다.

   메뉴 기반 인터페이스

   1. 측정항목 요소에서 데이터를 보려는 첫 번째 측정항목 유형을 선택합니다. 이 단계에 대한 자세한 내용은 단일 측정항목 유형 차트 작성을 참조하세요.

      이 선택 항목에 대한 쿼리에는 A 식별자가 있습니다.

   2. 각 추가 측정항목 유형에 대해 다음을 수행합니다.

      1. 쿼리 추가를 선택합니다. 새 쿼리가 추가됩니다. 예를 들어 B 라벨이 있는 쿼리를 추가할 수 있습니다.

      2. 새 쿼리의 경우 측정항목 요소에서 리소스 유형과 측정항목 유형을 선택합니다. 또한 필터를 추가하고, 시계열을 결합하고, 표시된 시계열 수를 정렬하고 제한할 수 있습니다.

      다음 스크린샷은 두 가지 측정항목 유형이 차트로 표시되는 측정항목 탐색기를 보여줍니다.

      

   3. 선택사항: 표시 창에서 Y축 메뉴를 펼치고 각 측정항목 유형에 사용되는 Y축을 구성합니다.

   MQL

   지원되지 않음.

   PromQL

   지원되지 않음.

   Monitoring 필터

   지원되지 않음.

측정항목 비율 차트 작성

보고된 오류 수를 모니터링하는 것이 유용할 수 있지만 오류율을 모니터링해야 할 가능성이 높습니다. 즉, 총 응답 수와 비교하여 측정된 오류 수를 알아야 합니다. 이 요구사항을 충족하려면 두 측정항목의 비율을 표시하도록 차트를 구성하면 됩니다. 측정항목 참조 차트에서 발생할 수 있는 이상과 예시에 대한 정보는 측정항목 비율을 참조하세요.

차트에 측정항목 비율을 표시하려면 다음 안내를 따르세요.

1. Google Cloud 콘솔의 탐색 패널에서 Monitoring을 선택한 후 측정항목 탐색기를 선택합니다.

   측정항목 탐색기로 이동

2. 차트에 표시될 데이터를 지정합니다.

   메뉴 기반 인터페이스

   1. 분자를 구성합니다.

      1. 측정항목 요소에서 메뉴를 사용하여 리소스 유형과 측정항목 유형을 선택합니다. 이 단계에 대한 자세한 내용은 단일 측정항목 유형 차트 작성을 참조하세요.
      2. 집계 필드를 업데이트합니다. 기본적으로 모든 시계열의 평균을 계산합니다.
      3. 선택사항: 시계열 내에서 지점의 정해진 시간을 조합하여 업데이트합니다. 이 필드를 수정하려면 쿼리 요소 추가를 클릭하고 최소 간격을 선택한 다음 대화상자를 완료합니다.

   2. 쿼리 추가를 선택한 후 분모를 구성합니다.

      1. 새 쿼리의 경우 측정항목 요소에서 리소스 유형과 측정항목 유형을 선택합니다.

         측정항목 종류가 분자와 동일한 측정항목 유형을 선택합니다. 예를 들어 분자 측정항목이 GAUGE 측정항목이면 분모의 GAUGE 측정항목을 선택합니다.

      2. 집계 필드를 업데이트합니다.

         분모 측정항목 유형의 라벨은 분자 측정항목 유형에 설정된 값과 일치하는 것이 좋습니다. 예를 들어 분자와 분모에 zone 라벨을 선택할 수 있습니다.

         두 측정항목 유형에 동일한 라벨 집합을 사용할 필요는 없지만 두 측정항목 유형에 공통된 라벨만 선택할 수 있습니다.

      3. 쿼리 요소 추가를 클릭하고 최소 간격을 선택한 후 이 필드가 분자에서 사용하는 값으로 설정되었는지 확인합니다.

   3. 쿼리 창의 툴바에서 비율 만들기를 선택한 후 대화상자를 완료합니다.

      비율을 만들면 쿼리 3개가 표시됩니다.

      • A/B 비율은 비율 쿼리를 식별합니다.
      • A는 분자의 쿼리를 식별합니다.
      • B는 분모의 쿼리를 식별합니다.

      다음 예시에서는 영역당 디스크에 작성된 바이트의 합계와 디스크에 작성된 총 바이트 수를 비교한 비율을 보여줍니다.

      

   4. 선택사항: 분자와 분모 측정항목을 전환하려면 비율 요소에서 메뉴를 펼친 후 선택합니다.

   MQL

   1. 쿼리 빌더 창의 툴바에서 이름이  MQL 또는  PromQL인 버튼을 선택합니다.
   2. 언어 전환 버튼에 MQL이 선택되어 있는지 확인합니다. 언어 전환 버튼은 쿼리 형식을 지정할 수 있는 동일한 툴바에 있습니다.

   3. 쿼리 편집기에 쿼리를 입력합니다. MQL을 사용하면 두 가지 측정항목의 비율을 계산할 수 있으며 라벨별로 단일 측정항목을 필터링한 다음 비율을 계산할 수 있습니다. 다음 쿼리는 총 응답 수 중 500 값을 가진 응답의 비율을 계산합니다.

      fetch https_lb_rule::loadbalancing.googleapis.com/https/request_count
      | {
          filter response_code_class = 500
        ;
          ident
        }
      | group_by [matched_url_path_rule]
      | outer_join 0
      | div
      

      MQL에 대한 자세한 내용은 다음 문서를 참조하세요.

      • MQL 소개
      • 코드 편집기 사용
      • 비율 계산

   PromQL

   1. 쿼리 빌더 창의 툴바에서 이름이  MQL 또는  PromQL인 버튼을 선택합니다.
   2. 언어 전환 버튼에 PromQL이 선택되어 있는지 확인합니다. 언어 전환 버튼은 쿼리 형식을 지정할 수 있는 동일한 툴바에 있습니다.

   3. 쿼리 편집기에 쿼리를 입력합니다. 예를 들어 my_summary_latency_seconds 측정항목의 평균 지연 시간 비율을 차트로 표시하려면 다음 쿼리를 사용합니다.

      sum without (instance)(rate(my_summary_latency_seconds_sum[5m])) /
      sum without (instance)(rate(my_summary_latency_seconds_count[5m]))
      

      PromQL 사용에 대한 자세한 내용은 Cloud Monitoring의 PromQL을 참조하세요.

   Monitoring 필터

   지원되지 않음.

나중에 참조할 수 있도록 차트 저장

측정항목 탐색기를 사용해서 측정항목 탐색에 사용할 수 있는 차트를 만들 수 있습니다. 하지만 이 도구로 생성된 차트는 영구적이지 않습니다. 측정항목 탐색기 페이지에서 벗어나면 차트가 삭제됩니다.

나중에 참조할 수 있도록 측정항목 탐색기로 구성한 차트를 저장하려면 차트를 커스텀 대시보드에 추가하거나 차트 URL을 저장합니다.

• 커스텀 대시보드에 차트를 추가하려면 다음 중 하나를 수행합니다.

  • Google Cloud 콘솔을 사용해서 커스텀 대시보드를 관리하는 경우에는 측정항목 탐색기 툴바에서 차트 저장을 선택하고 대화상자를 완료합니다. 차트를 기존 커스텀 대시보드에 저장하거나 대시보드를 만들 수 있습니다.

  • Cloud Monitoring API를 사용해서 커스텀 대시보드를 관리하는 경우 대시보드 및 콘텐츠를 정의하는 JSON 파일을 업데이트합니다. JSON 표현에 액세스하려면 차트 툴바에서 JSON 편집기를 클릭합니다.

    API를 사용하여 커스텀 대시보드를 관리하는 방법에 대한 자세한 내용은 API로 대시보드 만들기 및 관리를 참조하세요.

• 차트 구성에 대한 참조를 유지하려면 차트 URL을 저장합니다. 차트 URL은 차트 구성을 인코딩하기 때문에 이 URL을 브라우저에 붙여넣으면 구성된 차트가 표시됩니다.

  차트 URL을 가져오려면 차트 툴바에서 링크를 클릭합니다.

차트 구성 저장

Cloud Monitoring API를 사용하여 커스텀 대시보드를 관리하는 경우 측정항목 탐색기를 사용해서 API에 제공한 데이터를 생성할 수 있습니다.

• 대시보드에 추가할 차트를 JSON 형식으로 표현하려면 측정항목 탐색기로 차트를 구성하세요. 그런 후 측정항목 탐색기 내의 옵션을 사용해서 차트의 JSON 표현을 보고 복사할 수 있습니다.

• Cloud Monitoring API에서 사용되는 Monitoring 필터의 구문을 식별하려면 측정항목 탐색기의 메뉴 기반 인터페이스를 사용하여 차트를 구성하세요. 측정항목과 필터를 선택한 후 직접 필터링 모드로 전환하면 동등한 Monitoring 필터를 볼 수 있습니다.

차트에 표시된 데이터 저장

차트에 표시된 데이터를 로컬 시스템에 저장하려면 CSV 다운로드를 클릭합니다.

다음 단계

• 차트 데이터 탐색
• 측정항목 탐색기로 측정항목 선택
• 측정항목 사용 및 진단 보기
• 차트 표시 옵션 설정