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

측정항목 탐색기를 사용하면 대시보드를 설정하지 않고도 가상 머신 (VM)의 CPU 사용률과 같이 Google Cloud 프로젝트에서 수집한 측정항목 데이터를 빠르게 시각화하고 분석하는 임시 차트를 만들 수 있습니다. 단일 측정항목 유형을 차트로 표시하거나, 여러 측정항목을 비교하거나, 측정항목 탐색기에서 기존 대시보드 차트를 열어 다양한 쿼리 및 표시 설정을 테스트할 수 있습니다. 보관할 차트를 빌드할 때 이를 공유하거나 맞춤 대시보드에 저장할 수 있습니다.

시작하기 전에

측정항목 탐색기로 차트를 만드는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 Monitoring 뷰어 (roles/monitoring.viewer) IAM 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.

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

기본적으로 차트를 만들면 표시 스타일이 선 차트로 설정됩니다. 이 스타일의 차트는 대부분의 측정항목 데이터에 적합합니다. 위젯 유형 메뉴를 사용하여 차트 스타일을 변경할 수 있습니다. 다음은 단일 측정항목 유형의 차트 예시입니다.

이미지에는 여러 줄이 표시되어 있습니다. 각 선은 특정 영역에 있는 모든 VM의 평균 CPU 사용률을 표시합니다.

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

1. Google Cloud 콘솔에서 leaderboard 측정항목 탐색기 페이지로 이동합니다.

   측정항목 탐색기로 이동

   검색창을 사용하여 이 페이지를 찾은 경우 부제목이 Monitoring인 결과를 선택합니다.

2. Google Cloud 콘솔의 툴바에서 Google Cloud 프로젝트를 선택합니다. App Hub 구성의 경우 App Hub 호스트 프로젝트 또는 관리 프로젝트를 선택합니다.

3. 차트에 표시될 데이터를 지정합니다. 메뉴 기반 인터페이스 또는 PromQL을 사용하거나 모니터링 필터를 입력할 수 있습니다.

   메뉴 기반 인터페이스

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

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

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

         • 특정 측정항목 유형을 찾으려면 filter_list 필터 표시줄을 사용합니다. 예를 들어 util을 입력하면 util이 포함된 항목이 표시되도록 메뉴를 제한합니다. 항목이 대소문자를 구분하지 않는 'contains' 테스트를 통과하면 표시됩니다.
         • 데이터가 없는 측정항목 유형을 포함하여 모든 측정항목 유형을 표시하려면 done 활성을 클릭합니다. 기본적으로 메뉴에는 데이터가 있는 측정항목 유형만 표시됩니다.

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

         1. 활성 리소스 메뉴에서 VM 인스턴스를 선택합니다.
         2. 활성 측정항목 카테고리 메뉴에서 uptime_check를 선택합니다.
         3. 활성 측정항목 메뉴에서 요청 지연 시간을 선택합니다.
         4. 적용을 클릭합니다.
      2. 선택사항: 표시할 데이터의 하위 집합을 지정하려면 필터 요소에서 필터 추가를 선택한 후 대화상자를 완료합니다. 예를 들어 필터를 적용하면 한 영역의 데이터를 볼 수 있습니다. 여러 필터를 추가할 수 있습니다. 자세한 내용은 차트 데이터 필터링을 참조하세요.

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

   2. 시계열 조합 및 정렬:

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

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

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

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

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

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

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

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

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

   PromQL

   1. 쿼리 빌더 창의 툴바에서 이름이 code PromQL인 버튼을 선택합니다.

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

      avg(compute_googleapis_com:instance_cpu_utilization)
      

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

   Monitoring 필터

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

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

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

   2. 필터 요소의 필드에 모니터링 필터를 입력합니다.

   3. 시계열 조합 및 정렬:

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

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

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

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

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

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

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

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

고급 구성 옵션

이 섹션에서는 위젯을 맞춤설정하는 데 사용할 수 있는 옵션에 대해 설명합니다.

• 라벨별로 차트 분류하기
• 시각화 변경하기
• 차트 모양 변경하기
• 여러 측정항목 유형을 차트로 작성
• 측정항목 비율 차트 작성

라벨별로 차트 분류

기본적으로 측정항목 탐색기에는 선택한 측정항목 데이터를 보여주는 차트가 하나 표시됩니다. 문제를 조사할 때 세분화 기능을 사용하면 특정 리소스 유형이나 위치가 원인인지 확인할 수 있습니다.

선택한 측정항목 유형을 라벨별로 분류하여 보려면 세부정보 표시를 선택합니다.

이 기능에 대해 자세히 알아보려면 라벨별로 차트 분류를 참고하세요.

시각화 변경

기본적으로 측정항목 탐색기에는 선택한 측정항목 데이터가 선 차트로 표시됩니다. 이 스타일의 차트는 대부분의 측정항목 유형에 적합하지만 일부에는 적합하지 않습니다.

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

• 할당량 측정항목 유형의 경우 다음 설정을 사용합니다.
  • 툴바에서 시간 제어를 최소 1주일로 설정합니다. 할당량 측정항목은 일반적으로 하루에 샘플 하나를 보고합니다.
  • 표시 창에서 위젯 유형 메뉴를 펼친 후 누적 막대 그래프를 선택합니다.
• 분포 값 유형의 측정항목 유형인 경우 위젯 유형 메뉴가 히트맵 차트로 설정되어 있어야 합니다. 자세한 내용은 분포 값 측정항목 정보를 참고하세요.
• 다른 측정항목 유형의 경우 위젯 유형 메뉴를 사용하여 데이터가 표시되는 방법을 표시합니다. 위젯 유형 메뉴에는 사용 가능한 모든 위젯 유형이 나열됩니다. 하지만 일부 위젯은 사용 설정되지 않을 수 있습니다. 여러 시계열을 표시하는 차트를 살펴보고 측정된 각 값이 두 배라고 가정합니다.
  • 선 차트, 누적 막대 그래프, 누적 영역 차트 위젯은 호환 가능으로 나열됩니다. 이러한 유형 중 하나를 선택할 수 있습니다.
  • 히트맵 위젯은 분포 값 데이터만 표시할 수 있으므로 중지됩니다.

차트 모양 변경하기

기본적으로 측정항목 탐색기는 색상 모드를 사용하여 시계열을 표시합니다. 각 시계열에는 고유한 색상이 할당되고 배경은 흰색입니다. 하지만 이 모양은 수정할 수 있습니다.

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

• 차트 옵션:
  • 분석 모드 메뉴: 선 차트, X-Ray, 정적 중에서 선택합니다.
  • 과거와 비교 메뉴: 현재 데이터를 이전 데이터와 오버레이합니다.
  • 기준 선 메뉴: 참조 기준을 추가합니다.
  • 범례 별칭 메뉴: 범례 열의 이름을 구성합니다.
  • Y축 할당, Y축 라벨, Y축 배율 메뉴: Y축 할당, 라벨 또는 배율을 구성합니다.
• 표 옵션:
  • 값 옵션 메뉴: 최신 값과 집계된 값 중에서 선택합니다.
  • 표시되는 열 메뉴: 표시할 열을 선택합니다.
  • 열 형식 메뉴: 열 이름, 열의 데이터 정렬, 단위, 셀의 색상 지정 여부를 구성합니다.
  • 측정항목 뷰 메뉴: 값을 단독으로 표시할지 아니면 값 범위에 비례하여 표시할지 선택합니다.
  • 범례 별칭 메뉴: 범례 열의 이름을 구성합니다.

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

이 기능은 메뉴 기반 인터페이스를 사용하는 경우에만 사용할 수 있습니다. PromQL 또는 모니터링 필터를 사용하는 경우에는 사용할 수 없습니다.

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

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

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

1. Google Cloud 콘솔에서 leaderboard 측정항목 탐색기 페이지로 이동합니다.

   측정항목 탐색기로 이동

   검색창을 사용하여 이 페이지를 찾은 경우 부제목이 Monitoring인 결과를 선택합니다.

2. Google Cloud 콘솔의 툴바에서 Google Cloud 프로젝트를 선택합니다. App Hub 구성의 경우 App Hub 호스트 프로젝트 또는 관리 프로젝트를 선택합니다.

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

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

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

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

      1. 쿼리 추가를 선택합니다. 새 쿼리가 추가됩니다. 예를 들어 B 라벨이 있는 쿼리가 추가될 수 있습니다.
      2. 새 쿼리의 경우 측정항목 요소에서 리소스 유형과 측정항목 유형을 선택합니다. 또한 필터를 추가하고, 시계열을 조합하고, 표시되는 시계열을 정렬하고 개수를 제한할 수 있습니다.

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

      

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

측정항목 비율 차트 작성

이 기능은 메뉴 기반 인터페이스를 사용하거나 PromQL을 사용하는 경우에만 사용할 수 있습니다. Monitoring 필터를 사용할 때는 사용할 수 없습니다.

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

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

1. Google Cloud 콘솔에서 leaderboard 측정항목 탐색기 페이지로 이동합니다.

   측정항목 탐색기로 이동

   검색창을 사용하여 이 페이지를 찾은 경우 부제목이 Monitoring인 결과를 선택합니다.

2. Google Cloud 콘솔의 툴바에서 Google Cloud 프로젝트를 선택합니다. App Hub 구성의 경우 App Hub 호스트 프로젝트 또는 관리 프로젝트를 선택합니다.

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

   메뉴 기반 인터페이스

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

         측정항목 종류가 분자와 같은 측정항목 유형을 선택합니다. 예를 들어 분자 측정항목이 GAUGE 측정항목이면 분모에 GAUGE 측정항목을 선택합니다.

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

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

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

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

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

      비율을 만들면 세 가지 쿼리가 표시됩니다.

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

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

      

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

   PromQL

   1. 쿼리 빌더 창의 툴바에서 이름이 code PromQL인 버튼을 선택합니다.

   2. 쿼리 편집기에 쿼리를 입력합니다. 예를 들어 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을 참조하세요.

차트 저장

차트를 구성한 후 나중에 참조할 수 있도록 해당 차트를 저장하거나 차트에 표시되는 데이터를 저장할 수 있습니다. 이 섹션에서는 이러한 옵션을 설명합니다.

차트 링크 저장

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

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

커스텀 대시보드에 차트 추가

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

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

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

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

  • Cloud Monitoring API를 사용해서 커스텀 대시보드를 관리하는 경우 대시보드 및 위젯을 정의하는 JSON 파일을 업데이트합니다. 각 위젯의 JSON에는 시스템에서 표시할 데이터를 가져오는 데 사용하는 쿼리가 포함됩니다.

    JSON 표현에 액세스하려면 차트 툴바에서 code JSON 편집기를 클릭합니다.

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

차트에 표시된 데이터 저장

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

차트에서 알림 정책 만들기

차트로 표시한 데이터를 모니터링하는 알림 정책을 만들 수 있습니다. 알림 정책을 만들려면 다음 안내를 따르세요.

1. 툴바에서 다른 이름으로 저장을 클릭하고 알림 정책을 선택합니다.

   측정항목 선택 필드가 채워진 상태로 알림 정책 대화상자가 열립니다. 알림 정책은 모니터링 데이터 값이 기준점보다 커지면 알림을 보내도록 구성됩니다.

2. 다음을 완료한 후 정책을 저장합니다.

   • 트리거 구성 섹션에서 기준점을 업데이트합니다.
   • 알림 채널을 추가합니다.
   • 알림 정책 이름을 입력합니다.

다음 단계

• 라벨별로 차트 분류: 문제를 조사할 때 측정항목 탐색기 분류 기능을 사용하여 특정 리소스 유형이나 위치가 원인인지 확인합니다. 측정항목 탐색기는 차트를 일련의 타일로 나눌 수 있으며 각 타일에는 특정 라벨 키의 시계열 데이터가 표시됩니다. 이 뷰를 사용하면 집계로는 파악하기 어려울 수 있는 급증, 급락 또는 추세를 확인할 수 있습니다.

• 차트 데이터 탐색: 차트 컨트롤을 사용하여 시계열을 강조 표시하고, 차트 해상도를 변경하고, 이상점을 표시하고, 현재 데이터를 이전 데이터와 비교하는 방법을 설명합니다.

• 측정항목 탐색기로 측정항목 선택

• 측정항목 사용량 보기 및 관리

• 차트 표시 옵션 설정