대시보드 위젯 추가

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

이 문서에서는 Google Cloud 콘솔을 사용해서 커스텀 대시보드에 위젯을 추가하는 방법을 설명합니다. 커스텀 대시보드는 측정항목 데이터, 알림 정책, 설명 텍스트, 로그 항목을 표시할 수 있습니다. 또한 이러한 대시보드는 서비스 집합의 서비스 수준 목표 (SLO)를 표시할 수 있습니다.

일반적으로 대시보드 위젯은 사용자 정의 측정항목 및 로그 기반 측정항목을 포함하는 숫자 또는 배포 값을 가진 모든 측정항목 유형을 표시할 수 있습니다. 대시보드 위젯은 문자열 유형 데이터를 그래프로 표시할 수 없습니다.

측정항목 데이터를 표시하는 위젯을 추가하면 일정 기간 동안의 데이터를 표시하거나 최신 데이터만 표시할 수 있습니다. 예를 들어 일정 기간 동안의 측정항목을 표시하려면 선 차트, 누적 영역 차트, 막대 차트, 히트맵 차트를 추가합니다. 최신 데이터만 표시하려면 테이블 또는 표시기를 추가합니다. 표시기는 경고 및 위험 임곗값에 대한 데이터 수준에 따라 색상이 변경됩니다. 여러 위젯 유형에 대한 일반적인 정보는 대시보드 및 차트를 참조하세요.

대시보드에 위젯을 최대 40개까지 넣을 수 있으며 위젯을 이름이 지정된 그룹으로 구성할 수 있습니다.

Cloud Monitoring API에 대한 자세한 내용은 API로 대시보드 관리를 참조하세요.

시작하기 전에

대시보드를 만들거나 수정하기 전에 다음 Identity and Access Management 역할 중 하나가 있는지 확인하세요.

  • roles/monitoring.dashboardEditor
  • roles/monitoring.editor
  • roles/monitoring.admin
  • roles/owner

이러한 역할에 대한 자세한 내용은 액세스 제어를 참조하세요.

대시보드에 차트 및 테이블 추가

이 섹션에서는 Google Cloud 콘솔을 사용하여 차트와 테이블을 구성하는 방법을 설명합니다.

  • 차트에서는 시간 경과에 따른 데이터를 보여주며 선, 누적 영역, 누적 막대, 히트맵 등 4가지 스타일이 있습니다. 차트가 구성되면 위젯 유형을 변경할 수 있습니다. 특정 스타일을 선택할 수 있는 이유는 시간 경과에 따른 데이터를 보여주는 차트를 참조하세요.

    Cloud Monitoring API를 사용하여 차트를 구성하는 방법은 XyChart 위젯이 있는 대시보드를 참조하세요.

  • 테이블에는 모니터링되는 시계열마다 행이 하나씩 있으며 최신 값만 표시됩니다. 테이블에는 두 가지 스타일이 있습니다. 테이블 위젯은 '25%'와 같은 숫자 값을 표시합니다. 상위 목록 위젯은 가능한 값의 범위와 비교하여 값과 값의 시각적 표시를 모두 표시합니다. 이러한 위젯 유형 간에 변경할 수 있습니다. 자세한 내용과 예시는 대시보드에 테이블 형식으로 데이터 표시를 참조하세요.

    Cloud Monitoring API를 사용하여 테이블을 구성하는 방법은 TimeSeriesTable 위젯이 있는 대시보드를 참조하세요.

대시보드에 차트 또는 테이블을 추가하려면 다음을 수행합니다.

  1. Google Cloud 콘솔에서 Monitoring을 선택하거나 다음 버튼을 클릭합니다.
    Monitoring으로 이동
  2. 탐색창에서 대시보드를 선택한 후 보거나 수정할 대시보드를 선택합니다.
  3. 대시보드 수정 버튼이 표시되었으면 이를 클릭합니다.

  4. 차트 라이브러리에서 차트 또는 테이블 위젯을 선택하거나 이러한 위젯 중 하나를 라이브러리에서 그래프 영역으로 드래그합니다.

  5. 위젯에 표시되는 데이터를 지정합니다.

    • 위젯을 빠르게 구성하려면 기본 모드를 사용하세요. 이 모드는 최소한의 구성 옵션을 제공합니다. 언제든지 기본 구성에서 다른 구성 모드로 전환할 수 있습니다.
    • 구성 가능한 모든 필드에 액세스하거나 모니터링 필터를 입력하려면 고급 모드를 입력합니다. 다른 구성 모드로 전환하지 못할 수도 있습니다.
    • Monitoring Query Language(MQL)를 사용하려면 MQL 탭을 선택합니다. MQL을 사용할 때는 다른 구성 모드로 전환해서 쿼리를 보존할 수 없습니다.

    다음 표에서는 각 모드의 옵션에 대해 설명합니다.

기본

위젯을 구성하려면 다음 단계를 완료합니다.

  1. 확인하려는 시계열 데이터 선택
  2. (선택사항) 그룹 시계열
  3. (선택사항) 차트 보기 옵션 구성
  4. (선택사항) 여러 측정항목 유형을 차트로 작성

확인하려는 시계열 데이터 선택

차트로 작성할 시계열을 선택하려면 다음 중 하나를 수행합니다.

  • VM의 CPU 사용률과 같은 측정항목 유형을 표시하려면 메뉴를 사용하여 선택합니다.

    1. 측정항목 선택을 클릭한 다음 메뉴를 사용하여 리소스 유형과 측정항목 유형을 선택합니다.

      메뉴 옵션의 수를 줄이려면 필터 막대에서 리소스 이름 또는 측정항목 유형을 입력합니다. 예를 들어 VM 인스턴스의 CPU 사용률을 차트로 표시하려면 필터 막대에 utilization을 입력하면 됩니다.

      모든 리소스 및 측정항목 유형을 나열하려면 활성 리소스 및 측정항목만 표시를 사용 중지로 전환합니다. 기본적으로 이 전환 버튼은 사용 설정되어 있으므로 데이터가 있는 측정항목과 리소스만 메뉴에 표시됩니다.

    2. (선택사항) 표시할 데이터의 하위 집합을 지정하려면 필터를 추가하거나 템플릿 변수를 적용합니다. 예를 들어 필터를 적용하면 한 영역의 데이터를 볼 수 있습니다. 여러 필터를 추가할 수 있습니다. 필터에 대한 자세한 내용은 차트 데이터 필터링을 참조하세요. 템플릿 변수에 대한 자세한 내용은 대시보드 필터링을 참조하세요.

      필터를 추가하려면 필터 추가를 클릭한 다음 라벨 및 라벨 값을 선택합니다. 예를 들어 us-east1-b 영역의 시계열만 표시하려면 zone = us-east1-b 필터를 입력합니다.

      템플릿 변수를 적용하려면 메뉴를 사용합니다.

  • 서비스 수준 목표 또는 VM에서 실행 중인 프로세스 수를 표시하려면 모니터링 필터를 입력합니다.

    1. 측정항목 선택 메뉴에서 도움말을 클릭합니다.
    2. 직접 필터 모드를 선택합니다.
    3. 텍스트 상자에 모니터링 필터를 입력합니다.

이러한 옵션에 대한 자세한 내용은 대시보드의 차트 측정항목 선택을 참조하세요.

시계열 그룹화

  1. 모든 시계열을 확인할지 또는 시계열을 라벨 값에 따라 그룹화할 것인지 결정합니다.

    • 모든 시계열을 표시하려면 그룹화를 그대로 둡니다.
    • 라벨 값으로 시계열을 그룹화하려면 그룹화를 선택한 후 그룹화 기준 메뉴를 사용하여 그룹화 라벨을 선택합니다. 선택한 후 확인을 클릭합니다.

    이 옵션은 히트맵 차트에 사용할 수 없습니다. 이러한 차트는 단일 시계열만 표시할 수 있습니다.

  2. 시계열 내에서 데이터 포인트를 결합하는 방법을 지정하려면 라디오 버튼을 사용합니다.

    예를 들어, 차트에 60개의 데이터 포인트가 표시되고 데이터가 분당 1포인트로 기록되면 차트에 1시간 분량의 데이터가 표시될 수 있습니다. 3시간 동안의 데이터를 표시하려면 데이터 포인트를 180에서 60으로 줄여야 합니다. 이 선택기가 mean이면 차트의 각 점은 원래 시계열에서 세 포인트의 평균입니다.

차트 보기 옵션 구성

이러한 필드는 테이블에 사용할 수 없습니다.

(선택사항) 여러 측정항목 유형을 차트로 작성

이 옵션은 테이블에 사용할 수 없습니다.

차트에 다른 측정항목 유형을 표시하려면 다른 측정항목 추가를 클릭한 다음 이전 단계를 반복합니다. 차트는 최대 10개의 측정항목 유형을 표시할 수 있습니다.

다른 측정항목 추가를 처음 클릭하면 이전에 선택한 항목이 시계열 A 창에 표시됩니다. 시계열 B 창도 열립니다. 이 창에는 두 번째 측정항목 유형을 차트로 표시하려면 작성해야 하는 구성 필드가 포함됩니다.

다음 스크린샷은 이 동작을 보여줍니다.

2개의 측정항목이 있는 측정항목 탐색기 구성의 예시

고급

위젯을 구성하려면 다음 단계를 완료합니다.

  1. 확인하려는 시계열 데이터 선택
  2. 시계열을 사전 처리하는 방법 선택
  3. (선택사항) 그룹 시계열
  4. (선택사항) 차트 보기 옵션 구성
  5. (선택사항) 여러 측정항목 유형을 차트로 작성
  6. (선택사항) 측정항목 유형의 비율을 차트로 표시

확인하려는 시계열 데이터 선택

차트로 작성할 시계열을 선택하려면 다음 중 하나를 수행합니다.

  • VM의 CPU 사용률과 같은 측정항목 유형을 표시하려면 메뉴를 사용하여 선택합니다.

    1. 측정항목 선택을 클릭한 다음 메뉴를 사용하여 리소스 유형과 측정항목 유형을 선택합니다.

      메뉴 옵션의 수를 줄이려면 필터 막대에서 리소스 이름 또는 측정항목 유형을 입력합니다. 예를 들어 VM 인스턴스의 CPU 사용률을 차트로 표시하려면 필터 막대에 utilization을 입력하면 됩니다.

      모든 리소스 및 측정항목 유형을 나열하려면 활성 리소스 및 측정항목만 표시를 사용 중지로 전환합니다. 기본적으로 이 전환 버튼은 사용 설정되어 있으므로 데이터가 있는 측정항목과 리소스만 메뉴에 표시됩니다.

    2. (선택사항) 표시할 데이터의 하위 집합을 지정하려면 필터를 추가하거나 템플릿 변수를 적용합니다. 예를 들어 필터를 적용하면 한 영역의 데이터를 볼 수 있습니다. 여러 필터를 추가할 수 있습니다. 필터에 대한 자세한 내용은 차트 데이터 필터링을 참조하세요. 템플릿 변수에 대한 자세한 내용은 대시보드 필터링을 참조하세요.

      필터를 추가하려면 필터 추가를 클릭한 다음 라벨 및 라벨 값을 선택합니다. 예를 들어 us-east1-b 영역의 시계열만 표시하려면 zone = us-east1-b 필터를 입력합니다.

      템플릿 변수를 적용하려면 메뉴를 사용합니다.

  • 서비스 수준 목표 또는 VM에서 실행 중인 프로세스 수를 표시하려면 모니터링 필터를 입력합니다.

    1. 측정항목 선택 메뉴에서 도움말을 클릭합니다.
    2. 직접 필터 모드를 선택합니다.
    3. 텍스트 상자에 모니터링 필터를 입력합니다.

이러한 옵션에 대한 자세한 내용은 대시보드의 차트 측정항목 선택을 참조하세요.

시계열을 사전 처리하는 방법 선택

일반적으로 이 설정은 기본값으로 둡니다.

전처리 옵션은 선택한 측정항목이 델타 또는 누적 측정항목 종류일 때 표시됩니다. 측정항목의 값 유형에 따라 사용 가능한 특정 옵션이 결정됩니다.

전처리 옵션을 사용할 수 있는 경우 라디오 버튼을 사용하여 데이터를 정렬하기 전에 원시 데이터를 어떻게 처리할지 지정할 수 있습니다. 다음 예시에서는 DELTA 측정항목의 시계열을 선택할 때의 옵션을 보여줍니다.

누적 측정항목의 전처리 옵션을 표시합니다.

DELTA 측정항목의 경우 Rate를 선택하면 데이터 값이 샘플링 레이트로 구분됩니다. No preprocessing step을 선택하면 샘플링 레이트가 데이터 값을 확장하지 않습니다. 예를 들어 측정항목 단위가 MiB인 경우 rate를 선택하면 단위가 초당 MiB로 변경됩니다. 자세한 내용 및 예시는 종류, 유형, 변환을 참조하세요.

시계열 그룹화

  1. 정렬 매개변수를 선택합니다. 일반적으로 이러한 필드는 기본값으로 남겨둘 수 있습니다. 자세한 내용은 정렬: 시리즈 내 정규화를 참조하세요.

  2. 모든 시계열을 확인할지 또는 시계열을 라벨 값에 따라 그룹화할 것인지 결정합니다.

    • 모든 시계열을 단일 시계열로 결합하려면 그룹화 기준 필드를 비워두고 그룹화 기준 함수 메뉴를 사용하여 시계열의 결합 방식을 선택합니다.

      히트맵에 시계열을 표시할 때는 이 접근 방법을 사용해서 시계열을 조합해야 합니다. 히트맵은 단일 시계열만 표시할 수 있습니다. 자세한 내용은 분산 측정항목을 참조하세요.

    • 모든 시계열 데이터를 표시하려면 다음 중 하나를 수행하세요.

      • 그룹화 기준 필드가 비어 있는지 확인하고 그룹화 기준 함수에 대해 none을 선택합니다.
      • 그룹화 기준 메뉴를 확장하고 모두 추가를 선택한 후 그룹화 기준 함수 메뉴에서 선택합니다.

    • 특정 라벨 값으로 시계열을 그룹화하려면 그룹화 기준을 클릭하고 그룹화 라벨을 선택합니다. 시계열의 결합 방식을 지정하려면 함수별 그룹 메뉴를 사용하여 함수를 선택합니다.

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

차트 보기 옵션 구성

이러한 필드는 테이블에 사용할 수 없습니다.

(선택사항) 여러 측정항목 유형을 차트로 작성

이 옵션은 테이블에 사용할 수 없습니다.

차트에 다른 측정항목 유형을 표시하려면 다른 측정항목 추가를 클릭한 다음 이전 단계를 반복합니다. 차트는 최대 10개의 측정항목 유형을 표시할 수 있습니다.

다른 측정항목 추가를 처음 클릭하면 이전에 선택한 항목이 시계열 A 창에 표시됩니다. 시계열 B 창도 열립니다. 이 창에는 두 번째 측정항목 유형을 차트로 표시하려면 작성해야 하는 구성 필드가 포함됩니다.

다음 스크린샷은 이 동작을 보여줍니다.

2개의 측정항목이 있는 측정항목 탐색기 구성의 예시

(선택사항) 측정항목 유형의 비율을 차트로 표시

이 옵션은 테이블에 사용할 수 없습니다.

예를 들어 절대적인 오류 수 대신 오류율에 관심이 있으면 측정항목 유형의 비율을 차트로 표시해야 합니다. 측정항목 유형 비율을 표시하는 차트에는 샘플링 및 정렬 차이로 인한 이상치가 표시될 수 있습니다. 예시 및 자세한 내용은 측정항목 비율을 참조하세요.

다음 단계에서는 측정항목 유형을 차트로 표시하는 단계를 완료했다고 가정합니다. 다음 단계에서는 두 번째 측정항목 유형을 선택한 후 차트를 변환하여 비율을 표시합니다.

  1. 다른 측정항목 추가를 선택합니다.

    다른 측정항목 추가를 클릭하면 이전에 선택한 항목이 시계열 A 창에 표시됩니다. 시계열 B 창도 열립니다.

  2. 시계열 B의 측정항목 유형을 선택합니다.

    두 측정항목 유형 모두 동일한 측정항목 종류를 가져야 합니다. 예를 들어 시계열-A가 게이지 측정항목이면 GAUGE 측정항목 종류가 있는 측정항목 유형을 선택합니다.

  3. 최소 정렬 기간 필드 값이 두 측정항목 유형에서 동일한지 확인합니다.

  4. 두 번째 측정항목 유형의 그룹화 매개변수를 설정합니다.

    두 번째 측정항목 유형의 그룹화 필드는 시계열-A의 값과 일치하는 것이 좋습니다. 예를 들어 zone 라벨별로 두 측정항목 유형을 그룹화할 수 있습니다.

    분자와 분모에 같은 그룹화를 사용할 필요는 없지만 두 필드에 공통된 라벨로만 그룹화할 수 있습니다.

  5. 측정항목을 비율로 표시를 사용 설정합니다.

    이렇게 설정하면 시계열 A 라벨이 분자로, 시계열 B 라벨이 분모로 이름이 변경됩니다.

  6. (선택사항) 분자의 측정항목 유형을 변경하려면 분자 바꾸기를 클릭합니다.

  7. (선택사항) 비율 옵션 표시를 펼쳐 보조 집계 옵션을 구성합니다.

MQL

MQL 모드를 사용하여 대시보드에 차트 또는 표를 추가하려면 MQL 쿼리를 입력합니다.

예를 들어 다음 쿼리는 모든 Compute Engine 가상 머신(VM) 인스턴스의 평균 CPU 사용률을 표시합니다.

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

히트맵 위젯을 선택할 때는 집계 옵션이 시계열을 단일 시계열로 결합하는지 확인합니다. 히트맵 차트에 Your MQL Query has too many time series가 표시되면 집계 설정을 수정하여 시계열을 결합합니다.

MQL을 사용한 비율 계산에 대한 자세한 내용은 비율 계산을 참조하세요.

MQL 사용에 관한 자세한 내용은 MQL 소개를 참조하세요.

MQL을 사용할 때 템플릿 필터 추가 방법은 대시보드 필터를 참조하세요.

PromQL

PromQL 모드를 사용하여 대시보드에 차트 또는 테이블을 추가하려면 PromQL 쿼리를 입력합니다.

예를 들어 다음 쿼리는 사용자의 Compute Engine 가상 머신(VM) 인스턴스의 평균 CPU 사용률을 표시합니다.

avg(compute_googleapis_com:instance_cpu_utilization)

히트맵 위젯을 선택할 때는 집계 옵션이 시계열을 단일 시계열로 결합하는지 확인합니다. 히트맵 차트에 Your Query has too many time series가 표시되면 쿼리를 수정하여 시계열을 결합합니다.

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

커스텀 대시보드의 페이지 수준 필터는 이러한 대시보드의 모든 PromQL 차트에서 지원되지 않습니다.

대시보드에 표시기 추가

색상으로 구분된 기준점 집합과 비교하여 가장 최근의 측정값을 보려면 게이지 또는 스코어카드를 추가합니다. 게이지는 최근 측정값만 표시하고 스코어카드는 최근 측정값 기록도 표시합니다. 이러한 위젯의 배경 색상도 색상으로 구분됩니다. 최근 값이 예상 범위 내에 있으면 위젯 색상이 흰색으로 표시됩니다. 값이 경고 범위 내에 있으면 위젯이 호박색으로 표시됩니다. 마찬가지로 값이 위험 범위에 있으면 위젯이 빨간색으로 표시됩니다.

두 위젯 모두 단일 시계열을 표시합니다. 다음 스크린샷은 최근 측정값이 경고 및 위험 임곗값보다 작을 때의 게이지 예시를 보여줍니다.

게이지의 예시

이 섹션의 나머지 정보는 Google Cloud 콘솔에 대한 설명입니다. Cloud Monitoring API 사용에 대한 자세한 내용은 기본 Scorecard가 있는 대시보드를 참조하세요.

대시보드에 게이지 또는 스코어카드를 추가하려면 다음을 수행합니다.

  1. Google Cloud 콘솔에서 Monitoring을 선택하거나 다음 버튼을 클릭합니다.
    Monitoring으로 이동
  2. 탐색창에서 대시보드를 선택한 후 보거나 수정할 대시보드를 선택합니다.
  3. 대시보드 수정 버튼이 표시되었으면 이를 클릭합니다.
  4. 차트 라이브러리에서 게이지 또는 스코어카드 위젯을 선택하거나 위젯 중 하나를 라이브러리에서 그래프 영역으로 드래그합니다.
  5. 위젯에 표시되는 데이터를 지정합니다.
    • 위젯을 빠르게 구성하려면 기본 모드를 사용하세요. 이 모드는 최소한의 구성 옵션을 제공합니다. 언제든지 기본 구성에서 다른 구성 모드로 전환할 수 있습니다.
    • 구성 가능한 모든 필드에 액세스하거나 모니터링 필터를 입력하려면 고급 모드를 입력합니다. 다른 구성 모드로 전환하지 못할 수도 있습니다.
    • Monitoring Query Language(MQL)를 사용하려면 MQL 탭을 선택합니다. MQL을 사용할 때는 다른 구성 모드로 전환해서 쿼리를 보존할 수 없습니다.

    다음 표에서는 각 모드의 옵션에 대해 설명합니다.

기본

위젯을 구성하려면 다음 단계를 완료합니다.

  1. 확인하려는 시계열 데이터 선택
  2. 시계열을 단일 시계열로 결합
  3. 경고 및 임곗값 수준 구성

확인하려는 시계열 데이터 선택

차트로 작성할 시계열을 선택하려면 다음 중 하나를 수행합니다.

  • VM의 CPU 사용률과 같은 측정항목 유형을 표시하려면 메뉴를 사용하여 선택합니다.

    1. 측정항목 선택을 클릭한 다음 메뉴를 사용하여 리소스 유형과 측정항목 유형을 선택합니다.

      메뉴 옵션의 수를 줄이려면 필터 막대에서 리소스 이름 또는 측정항목 유형을 입력합니다. 예를 들어 VM 인스턴스의 CPU 사용률을 차트로 표시하려면 필터 막대에 utilization을 입력하면 됩니다.

      모든 리소스 및 측정항목 유형을 나열하려면 활성 리소스 및 측정항목만 표시를 사용 중지로 전환합니다. 기본적으로 이 전환 버튼은 사용 설정되어 있으므로 데이터가 있는 측정항목과 리소스만 메뉴에 표시됩니다.

    2. (선택사항) 표시할 데이터의 하위 집합을 지정하려면 필터를 추가하거나 템플릿 변수를 적용합니다. 예를 들어 필터를 적용하면 한 영역의 데이터를 볼 수 있습니다. 여러 필터를 추가할 수 있습니다. 필터에 대한 자세한 내용은 차트 데이터 필터링을 참조하세요. 템플릿 변수에 대한 자세한 내용은 대시보드 필터링을 참조하세요.

      필터를 추가하려면 필터 추가를 클릭한 다음 라벨 및 라벨 값을 선택합니다. 예를 들어 us-east1-b 영역의 시계열만 표시하려면 zone = us-east1-b 필터를 입력합니다.

      템플릿 변수를 적용하려면 메뉴를 사용합니다.

  • 서비스 수준 목표 또는 VM에서 실행 중인 프로세스 수를 표시하려면 모니터링 필터를 입력합니다.

    1. 측정항목 선택 메뉴에서 도움말을 클릭합니다.
    2. 직접 필터 모드를 선택합니다.
    3. 텍스트 상자에 모니터링 필터를 입력합니다.

이러한 옵션에 대한 자세한 내용은 대시보드의 차트 측정항목 선택을 참조하세요.

시계열을 단일 시계열로 결합

라디오 버튼을 사용하여 서로 다른 시계열의 데이터가 결합되는 방식을 지정합니다. 예를 들어 시계열의 평균을 계산하려면 mean을 선택합니다.

경고 및 임곗값 수준 구성

다음 중 하나를 수행합니다.

  • 게이지의 경우 다음을 수행합니다.

    1. 측정항목의 최소값 및 최대값을 입력합니다. 게이지에 백분율이 표시되면 이 값을 각각 0과 1로 설정합니다.

    2. 경고 및 위험 임곗값을 구성합니다.

      예를 들어 다음 스크린샷은 경고 초과와 위험 초과 임곗값이 설정된 게이지 구성을 보여줍니다.

      게이지 구성을 표시하는 차트

  • 스코어카드의 경우 다음을 수행합니다.

    1. Spark 차트 보기를 설정합니다. 보기에 따라 이전 데이터의 표시 방법이 결정됩니다. 예를 들어 선을 선택하면 선이 표시됩니다.
    2. 경고 및 위험 임곗값을 구성합니다.

고급

위젯을 구성하려면 다음 단계를 완료합니다.

  1. 확인하려는 시계열 데이터 선택
  2. 시계열을 단일 시계열로 결합
  3. 경고 및 임곗값 수준 구성

확인하려는 시계열 데이터 선택

차트로 작성할 시계열을 선택하려면 다음 중 하나를 수행합니다.

  • VM의 CPU 사용률과 같은 측정항목 유형을 표시하려면 메뉴를 사용하여 선택합니다.

    1. 측정항목 선택을 클릭한 다음 메뉴를 사용하여 리소스 유형과 측정항목 유형을 선택합니다.

      메뉴 옵션의 수를 줄이려면 필터 막대에서 리소스 이름 또는 측정항목 유형을 입력합니다. 예를 들어 VM 인스턴스의 CPU 사용률을 차트로 표시하려면 필터 막대에 utilization을 입력하면 됩니다.

      모든 리소스 및 측정항목 유형을 나열하려면 활성 리소스 및 측정항목만 표시를 사용 중지로 전환합니다. 기본적으로 이 전환 버튼은 사용 설정되어 있으므로 데이터가 있는 측정항목과 리소스만 메뉴에 표시됩니다.

    2. (선택사항) 표시할 데이터의 하위 집합을 지정하려면 필터를 추가하거나 템플릿 변수를 적용합니다. 예를 들어 필터를 적용하면 한 영역의 데이터를 볼 수 있습니다. 여러 필터를 추가할 수 있습니다. 필터에 대한 자세한 내용은 차트 데이터 필터링을 참조하세요. 템플릿 변수에 대한 자세한 내용은 대시보드 필터링을 참조하세요.

      필터를 추가하려면 필터 추가를 클릭한 다음 라벨 및 라벨 값을 선택합니다. 예를 들어 us-east1-b 영역의 시계열만 표시하려면 zone = us-east1-b 필터를 입력합니다.

      템플릿 변수를 적용하려면 메뉴를 사용합니다.

  • 서비스 수준 목표 또는 VM에서 실행 중인 프로세스 수를 표시하려면 모니터링 필터를 입력합니다.

    1. 측정항목 선택 메뉴에서 도움말을 클릭합니다.
    2. 직접 필터 모드를 선택합니다.
    3. 텍스트 상자에 모니터링 필터를 입력합니다.

이러한 옵션에 대한 자세한 내용은 대시보드의 차트 측정항목 선택을 참조하세요.

시계열을 단일 시계열로 결합

  1. 정렬 매개변수를 선택합니다. 일반적으로 정렬 매개변수는 기본값으로 둡니다. 자세한 내용은 정렬: 시리즈 내 정규화를 참조하세요.

  2. 그룹화 기준 함수를 선택합니다. 이 함수는 시계열을 하나로 조합합니다.

경고 및 임곗값 수준 구성

다음 중 하나를 수행합니다.

  • 게이지의 경우 다음을 수행합니다.

    1. 측정항목의 최소값 및 최대값을 입력합니다. 게이지에 백분율이 표시되면 이 값을 각각 0과 1로 설정합니다.

    2. 경고 및 위험 임곗값을 구성합니다.

      예를 들어 다음 스크린샷은 경고 초과와 위험 초과 임곗값이 설정된 게이지 구성을 보여줍니다.

      게이지 구성을 표시하는 차트

  • 스코어카드의 경우 다음을 수행합니다.

    1. Spark 차트 보기를 설정합니다. 보기에 따라 이전 데이터의 표시 방법이 결정됩니다. 예를 들어 선을 선택하면 선이 표시됩니다.
    2. 경고 및 위험 임곗값을 구성합니다.

MQL

위젯을 구성하려면 시계열을 단일 시계열로 결합하는 MQL 쿼리를 입력합니다.

예를 들어 VM 인스턴스의 CPU 사용률 쿼리를 살펴보겠습니다. 이 쿼리는 데이터를 영역별로 그룹화한 후 각 영역의 데이터 평균을 계산합니다.

fetch gce_instance
 | metric 'compute.googleapis.com/instance/cpu/utilization'
 | group_by [zone], mean(val())

모든 VM 인스턴스가 동일한 영역에 있는 경우 게이지 또는 스코어카드에 요청된 데이터가 표시될 수 있습니다. 하지만 VM 인스턴스가 여러 영역에 있으면 해당 위젯에 오류 메시지 Your MQL Query has too many time series가 표시됩니다.

이 오류 조건을 해결하려면 마지막 group_by 절이 시계열을 조합해야 합니다.

fetch gce_instance
 | metric 'compute.googleapis.com/instance/cpu/utilization'
 | group_by [zone], mean(val())
 | every 1m
 | group_by [], max(val())

마지막 group_by 절에서 첫 번째 인수인 []는 시계열이 조합되도록 지정하고 두 번째 인수 max(val())는 시계열이 조합되는 방법을 정의합니다. 그룹화 작업이 완료되면 단일 시계열만 남습니다.

MQL 사용에 관한 자세한 내용은 MQL 소개를 참조하세요.

PromQL

위젯을 구성하려면 시계열을 단일 시계열로 결합하는 PromQL 쿼리를 입력합니다.

예를 들어 VM 인스턴스의 CPU 사용률 쿼리를 살펴보겠습니다. VM이 여러 개인 경우 이 쿼리는 여러 시계열을 검색하며 게이지나 스코어카드로 표시할 수 없습니다.

compute_googleapis_com:instance_cpu_utilization

쿼리에서 여러 시계열을 반환하면 게이지 또는 스코어카드 위젯에서 Your Query has too many time series 오류 메시지가 표시됩니다.

이 오류 조건을 해결하려면 쿼리에서 단일 시계열을 반환해야 합니다. 예를 들어 다음 쿼리는 모든 시계열의 평균을 계산합니다.

avg(compute_googleapis_com:instance_cpu_utilization)

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

대시보드에 테이블 형식으로 데이터 표시

최근 데이터를 테이블 형식으로 보려면 테이블을 추가합니다. 테이블에는 숫자 값이 있는 모든 측정항목 유형과 분포 값 측정항목의 백분위수가 표시될 수 있습니다. 테이블에는 게이지 및 스코어카드의 동작과 비슷한 최근 값만 표시됩니다. 그러나 게이지 및 스코어카드와 달리 테이블에는 모니터링되는 시계열마다 행이 하나씩 포함됩니다.

테이블에는 두 가지 스타일이 있습니다. 상위 목록 위젯은 2개의 열이 있고 행 수를 제한하도록 사전 구성되어 있습니다. 상위 목록 위젯의 한 열에 instance_id와 같은 라벨이 표시되고, 다른 열에는 가능한 값의 범위와 비교되는 값의 시각적 표시기와 값이 표시됩니다. 테이블 위젯은 고유한 값이 두 개 이상, 각 시계열당 하나의 행, '25%'와 같은 숫자 값이 있는 각 라벨에 하나의 열을 표시하도록 사전 구성됩니다.

두 위젯 모두 동일한 데이터 구조로 표시됩니다. 따라서 이러한 위젯 중 하나를 대시보드에 추가한 후 표시되는 행 수를 제한하고, 테이블에 표시되는 열을 변경하고, 값이 표시되는 방식을 변경할 수 있습니다.

다음 스크린샷에서는 상위 목록 위젯과 테이블 위젯을 사용하여 가상 머신 인스턴스의 CPU 사용률을 표시하는 대시보드를 보여줍니다.

**상위 목록** 및 **테이블** 위젯의 예시

대시보드에 테이블을 추가하는 방법은 다음 문서를 참조하세요.

테이블 정렬 및 필터링

테이블 표시에서 행 순서를 변경할 수 있고, 특정 행만 표시되도록 테이블 콘텐츠를 필터링할 수 있습니다. 이러한 설정은 영구적이지 않습니다. 대시보드 페이지를 종료하거나 대시보드를 새로고침하면 적용한 정렬 및 필터링 옵션이 삭제됩니다.

정렬 및 필터링 옵션은 다음과 같습니다.

  • 열을 기준으로 테이블을 정렬하려면 열 헤더를 클릭합니다.

  • 테이블 열을 변경하려면 열 보기를 클릭하고 항목을 수정한 후 확인을 클릭합니다.

  • 특정 행만 나열하려면 하나 이상의 필터를 추가합니다. 여러 필터를 추가할 수 있습니다. 두 필터 사이에 OR 연산자를 지정하지 않으면 논리적 AND가 필터를 조인합니다.

    필터를 추가하려면 Enter property name or value를 클릭하고, 메뉴에서 속성을 선택한 후 값을 입력하거나 값 메뉴에서 선택합니다. 예를 들어 Name 속성을 필터링하고 demo 값을 입력하면 Name 필드에 demo 값이 포함된 행만 테이블에 나열됩니다.

대시보드에 텍스트 추가

대시보드에 유용한 정보를 추가하려면 텍스트 상자를 추가합니다. 텍스트 상자의 콘텐츠는 대시보드, 관련 리소스 링크, 다양한 상황에서 수행할 작업에 대한 정보일 수 있습니다. 텍스트 위젯의 콘텐츠는 영구적입니다. 다음 스크린샷은 텍스트 상자를 보여줍니다.

텍스트 위젯이 있는 대시보드 예시.

이 섹션의 정보는 Google Cloud 콘솔에 대한 설명입니다. Cloud Monitoring API 사용에 대한 자세한 내용은 Text 위젯이 있는 대시보드를 참조하세요.

텍스트 상자를 추가하려면 다음을 수행합니다.

  1. Google Cloud 콘솔에서 Monitoring을 선택하거나 다음 버튼을 클릭합니다.
    Monitoring으로 이동
  2. 탐색창에서 대시보드를 선택한 후 보거나 수정할 대시보드를 선택합니다.
  3. 대시보드 수정 버튼이 표시되었으면 이를 클릭합니다.
  4. 차트 라이브러리에서 텍스트 상자 위젯을 선택하거나 라이브러리에서 그래프 영역으로 이 위젯을 드래그합니다.

  5. 표시하려는 텍스트를 입력합니다. 텍스트 상자 위젯은 제한된 마크다운 명령 집합을 지원합니다.

    • 헤더를 만들려면 #를 사용합니다. 서로 다른 수준의 헤더에 여러 개의 해시 기호를 사용할 수 있습니다.

        # Header
  ## Second heading
  ### Third heading

    • 기울임꼴 글꼴을 표시하려면 *italic* 또는 _italic_을 사용합니다.

    • 굵은 글꼴을 표시하려면 **bold** 또는 __bold__를 사용합니다.

    • 링크를 추가하려면 [link text](absolute URL)를 사용하세요. link text에 모든 값을 사용할 수 있지만 절대 URL을 사용해야 합니다.

      예를 들어 [cloud.google.com](https://cloud.google.com/)를 작성하여 cloud.google.com에 연결할 수 있습니다.

대시보드에 알림 정책 표시

측정항목 데이터와 동일한 컨텍스트에서 알림 정책과 연결된 차트를 보려면 대시보드에 알림 차트를 추가합니다. 알림 차트에는 정책이 모니터링하는 시계열, 임곗값, 정책과 연결된 이슈 수 및 정책이 사용 중지되었는지 여부가 표시됩니다. 다음 스크린샷은 알림 차트를 보여줍니다.

알림 차트의 예시

이 섹션의 나머지 정보는 Google Cloud 콘솔에 대한 설명입니다. Cloud Monitoring API 사용에 대한 자세한 내용은 AlertChart 위젯이 있는 대시보드를 참조하세요.

대시보드에 알림 차트를 추가하려면 다음을 수행합니다.

  1. Google Cloud 콘솔에서 Monitoring을 선택하거나 다음 버튼을 클릭합니다.
    Monitoring으로 이동
  2. 탐색창에서 대시보드를 선택한 후 보거나 수정할 대시보드를 선택합니다.
  3. 대시보드 수정 버튼이 표시되었으면 이를 클릭합니다.
  4. 차트 라이브러리에서 알림 차트 위젯을 선택하거나 라이브러리에서 그래프 영역으로 이 위젯을 드래그합니다.
  5. 알림 정책 메뉴를 사용하여 기존 알림 정책을 선택합니다.

알림 정책 보기

알림 차트를 볼 때는 알림 차트에 표시되는 알림 정책을 자세히 확인해야 할 수 있습니다. 예를 들어 선택한 알림 채널을 검토하거나 알림에 포함된 커스텀 문서를 검토해야 할 수 있습니다. 알림 정책에 대한 자세한 내용을 보려면 다음을 시도하세요.

  • 알림 정책에 대한 세부정보를 보려면 알림 차트에서 이슈 칩을 클릭한 후 알림 정책 보기를 선택합니다.

  • 알림 정책을 수정하려면 다음을 수행합니다.

    1. 대시보드가 수정 모드인지 확인합니다.
    2. 구성 창을 활성화할 알림 차트를 선택한 후 정책 수정을 클릭합니다.

  • 알림 차트에 표시되는 시계열 구성에 대한 세부정보를 보려면 추가 옵션을 클릭하고 측정항목 탐색기에서 보기를 선택합니다.

    측정항목 탐색기에는 알림 차트와 동일한 측정항목 및 필터 구성으로 구성된 선 차트가 표시됩니다. 측정항목 탐색기에 표시되는 차트에 수행할 수 있는 변경사항은 해당 차트로 제한됩니다. 즉, 측정항목 탐색기를 사용하여 알림 정책을 변경할 수 없습니다.

알림 정책 삭제

알림 차트와 연결된 알림 정책을 삭제하면 더 이상 알림 차트에 데이터가 표시되지 않습니다. 자세한 내용은 알림 차트에 데이터가 표시되지 않음을 참조하세요.

대시보드에 이슈 표시

측정항목 데이터와 동일한 컨텍스트에서 이슈 테이블을 보려면 이슈 위젯을 추가합니다. 이슈 테이블의 각 행에는 하나의 이슈에 대한 정보가 나열됩니다. 이 정보에는 정책 이름, 조건 이름, 이슈가 개설된 시간이 포함됩니다. 위젯에는 관련 알림 정책 및 이슈 세부정보를 볼 수 있는 옵션이 포함되어 있습니다.

다음 스크린샷은 이슈 위젯을 보여줍니다.

**이슈** 위젯의 예시

이 섹션의 나머지 정보는 Google Cloud 콘솔에 대한 설명입니다. Cloud Monitoring API 사용에 대한 자세한 내용은 Incidents 위젯이 있는 대시보드를 참조하세요.

대시보드에 이슈를 표시하려면 다음을 수행합니다.

  1. Google Cloud 콘솔에서 Monitoring을 선택하거나 다음 버튼을 클릭합니다.
    Monitoring으로 이동
  2. 탐색창에서 대시보드를 선택한 후 보거나 수정할 대시보드를 선택합니다.
  3. 대시보드 수정 버튼이 표시되었으면 이를 클릭합니다.
  4. 차트 라이브러리에서 이슈 목록을 선택하거나 라이브러리에서 그래프 영역으로 이 위젯을 드래그합니다.
  5. 선택사항: 위젯의 제목을 업데이트합니다.

  6. 선택사항: 표시할 이슈를 정의하는 기준을 선택합니다. 기본적으로 Google Cloud 프로젝트의 모든 이슈가 나열됩니다. 하지만 특정 알림 정책 또는 특정 리소스 및 측정항목에 대한 이슈를 표시하도록 위젯을 제한할 수 있습니다.

    • 특정 알림 정책의 이슈를 표시하려면 알림 정책을 선택한 후 알림 정책 메뉴에서 선택합니다.

      이 메뉴에서 선택하면 리소스 유형 메뉴에서 선택한 모든 사항이 삭제됩니다.

    • 특정 리소스 유형에 대한 이슈를 표시하려면 리소스 유형을 선택한 후 리소스 유형 메뉴에서 선택합니다.

      이 메뉴에서 선택하면 알림 정책 메뉴에서 선택한 모든 사항이 삭제됩니다.

    특정 알림 정책 또는 리소스 유형을 선택하지 않으면 모든 이슈가 표시됩니다.

  7. 선택사항: 기본적으로 미해결 이슈만 표시됩니다. 시간 선택도구에서 지정한 타이머 간격 내에 종료된 이슈를 포함하여 모든 이슈를 표시하려면 종료된 이슈 표시 전환을 사용 설정합니다.

미해결 날짜 또는 종료된 날짜를 기준으로 이슈 목록을 정렬할 수 있습니다. 필터 필드를 사용하여 목록을 검색할 수도 있습니다.

이슈 및 알림 정책 세부정보 보기

이슈 위젯이 표시되면 알림 정책 또는 이슈에 대한 정보가 필요할 수 있습니다.

  • 이슈와 관련된 알림 정책의 세부정보를 보려면 이슈 위젯에서 해당 이슈를 찾고 정책 이름을 선택합니다.

  • 이슈의 세부정보를 보려면 이슈 위젯에서 해당 이슈를 찾고 보기를 클릭합니다.

대시보드에 로그 항목 표시

측정항목과 동일한 컨텍스트에서 로그 항목을 보려면 커스텀 대시보드에 로그 패널을 추가합니다. 로그 패널에서 로그 항목을 필터링할 수 있으므로 관심 있는 로그 항목만 표시하도록 구성할 수 있습니다.

다음 스크린샷은 로그 패널을 보여줍니다.

로그 패널이 있는 대시보드의 예시.

대시보드에서 로그 항목을 보는 방법에 대한 자세한 내용은 커스텀 대시보드에서 로그 보기를 참조하세요.

대시보드에 SLO 표시

서비스의 서비스 수준 목표(SLO)에 대한 상태, 규정 준수, 오류 예산을 보려면 커스텀 대시보드에 SLO 차트를 추가합니다. SLO 차트는 구성된 SLO에 따라 서비스 성능 요약을 제공합니다. SLO 차트를 사용하여 서비스 집합에 대해 모든 SLO 상태를 보여주는 커스텀 대시보드를 만들 수 있습니다.

SLO 차트를 사용하려면 먼저 서비스를 구성해야 합니다. 서비스 및 SLO에 대한 자세한 내용은 SLO 모니터링을 참조하세요.

다음 스크린샷은 SLO의 오류 예산이 표시되는 SLO 차트를 보여줍니다.

SLO의 남은 오류 예산을 표시하는 SLO 차트 예시입니다.

이 섹션의 나머지 정보는 Google Cloud 콘솔에 대한 설명입니다. Cloud Monitoring API 사용에 대한 자세한 내용은 SLO 위젯이 있는 대시보드를 참조하세요.

대시보드에 SLO 차트를 추가하려면 다음을 수행합니다.

  1. Google Cloud 콘솔에서 Monitoring을 선택하거나 다음 버튼을 클릭합니다.
    Monitoring으로 이동
  2. 탐색창에서 대시보드를 선택한 후 보거나 수정할 대시보드를 선택합니다.
  3. 대시보드 수정 버튼이 표시되었으면 이를 클릭합니다.
  4. 차트 라이브러리에서 SLO 차트 위젯을 선택하거나 라이브러리에서 그래프 영역으로 이 위젯을 드래그합니다.
  5. 서비스 메뉴에서 기존 서비스를 선택합니다.

  6. 서비스 수준 목표 메뉴에서 서비스의 기존 SLO를 선택합니다.

    선택한 서비스에 SLO가 없으면 SLO를 만들어야 한다는 메시지가 표시됩니다. SLO를 추가하려면 SLO 만들기를 클릭합니다. SLO 만들기에 대한 자세한 내용은 SLO 만들기를 참조하세요. SLO를 만든 후 이를 선택하고 다음 단계로 진행합니다.

  7. 서비스 수준 목표 차트 유형 메뉴에서 SLO 측정항목을 선택합니다. 상태, 규정 준수, 절대 또는 부분 오류 예산을 선택할 수 있습니다. SLO 측정항목에 대한 자세한 내용은 SLO 데이터 검색을 참조하세요.

대시보드 위젯 정리

위젯이 여러 개 있는 대시보드의 사용성을 개선하려면 축소형 그룹 위젯을 사용합니다. 축소형 그룹 위젯은 다른 위젯들이 포함된 컨테이너입니다. 따라서 여러 위젯을 한 컬렉션으로 보고 관리할 수 있습니다. 예를 들어 축소형 그룹 위젯에는 VM 측정항목을 표시하고 VM을 모니터링하는 알림 정책을 표시하는 차트가 포함될 수 있습니다.

축소형 그룹 위젯을 추가하려면 다음 단계를 따르세요.

  1. Google Cloud 콘솔에서 Monitoring을 선택하거나 다음 버튼을 클릭합니다.
    Monitoring으로 이동
  2. 탐색창에서 대시보드를 선택한 후 보거나 수정할 대시보드를 선택합니다.
  3. 대시보드 수정 버튼이 표시되었으면 이를 클릭합니다.
  4. 대시보드 툴바에서 Mosaic(모자이크)가 선택되어 있어야 합니다.
  5. 차트 라이브러리에서 축소형 그룹 위젯을 선택하거나 라이브러리에서 그래프 영역으로 이 위젯을 드래그합니다.
  6. (선택사항) 구성 창에 내용을 설명하는 제목을 입력합니다. 제목이 위젯에 표시됩니다.
  7. (선택사항) 그룹을 펼치거나 접도록 기본 뷰를 설정합니다. 축소형 그룹 위젯을 접으면 Monitoring에서 해당 그룹의 위젯 데이터를 가져올 때 다른 위젯보다 낮은 우선순위를 둡니다.

  8. 다음 중 하나를 수행하여 그룹에 위젯을 추가하세요.

    • 기존 위젯을 그룹으로 드래그합니다.
    • 차트 라이브러리의 위젯을 그룹으로 드래그합니다.

  9. (선택사항) 포인터를 사용해 그룹 내에서 위젯 크기를 조절하고 위치를 변경합니다.

축소형 그룹 위젯에서 위젯을 삭제하려면 위젯을 삭제하거나 대시보드에서 사용되지 않는 공간으로 드래그하면 됩니다.

그룹화를 삭제하려면 축소형 그룹 위젯을 선택하고 위젯의 툴바에서 취소를 선택합니다.

다음 단계