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

이 문서에서는 Google Cloud 콘솔을 사용하여 차트, 테이블, 게이지, 스코어카드를 커스텀 대시보드에 추가하는 방법을 설명합니다. 선 차트, 누적 영역 차트, 막대 그래프, 히트맵 차트를 추가하여 시간 간격에 따른 측정항목 데이터를 표시할 수 있습니다. 최근 측정값에만 관심이 있다면 테이블, 원형 차트, 게이지 또는 스코어카드를 추가합니다. 게이지 및 점수 카드는 최신 값과 경고 및 위험 임계값과의 비교 결과에 따라 색상이 변경됩니다.

대시보드에 추가할 수 있는 시각화를 통칭하여 위젯이라고 합니다. 여러 위젯 유형에 대한 일반 정보는 대시보드 개요를 참조하세요.

커스텀 대시보드의 차트, 테이블, 게이지, 스코어카드에서 사용자 정의 측정항목 및 로그 기반 측정항목을 포함한 숫자 또는 분포 값을 가진 모든 측정항목 유형을 표시할 수 있습니다. 차트는 문자열 유형 데이터를 그래프로 표시할 수 없습니다.

이 문서에서는 시계열 데이터를 표시하는 커스텀 대시보드에 차트, 테이블, 게이지, 스코어카드를 추가하는 방법을 설명합니다. 대시보드에 다른 유형의 위젯을 추가하는 방법에 대한 자세한 내용은 다음 문서를 참조하세요.

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

시작하기 전에

Google Cloud 콘솔을 사용하여 커스텀 대시보드를 만들고 수정하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 Monitoring 편집자(roles/monitoring.editor) IAM 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

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

역할에 대한 자세한 내용은 Identity and Access Management로 액세스 제어를 참조하세요.
대시보드에 위젯을 최대 40개까지 넣을 수 있습니다.
대시보드에 위젯을 추가하려면 시각화를 선택한 후 위젯을 구성하거나 데이터 유형을 먼저 선택한 후 시각화를 구성할 수 있습니다.

예를 들어 VM 인스턴스의 CPU 사용률을 표시하는 테이블을 대시보드에 추가하려면 다음 중 하나를 수행하면 됩니다.
- 테이블 위젯을 선택한 다음 VM 인스턴스의 CPU 사용률을 표시하도록 위젯을 구성합니다.
- 측정항목 데이터 유형을 선택하고, VM 인스턴스의 CPU 사용률을 표시하도록 위젯을 구성한 후 위젯 유형을 테이블로 변경합니다.
이 페이지 안내에서는 데이터 유형을 먼저 선택한 후 데이터 표시 방법을 구성한다고 가정합니다.

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

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

차트에서는 시간 경과에 따른 데이터를 보여주며 선, 누적 영역, 누적 막대, 히트맵 등 4가지 스타일이 있습니다. 단일 차트에 여러 측정항목 유형을 표시할 수 있습니다. 예를 들어 인스턴스에서 읽은 디스크 바이트와 인스턴스에 쓴 디스크 바이트를 표시하도록 차트를 구성할 수 있습니다.

차트가 구성되면 위젯 유형을 변경할 수 있습니다. 특정 스타일을 선택할 수 있는 이유는 시간 경과에 따른 데이터를 보여주는 차트를 참조하세요.

Cloud Monitoring API를 사용하여 차트를 구성하는 방법은 XyChart 위젯이 있는 대시보드를 참조하세요.
테이블에는 라벨 값 조합마다 행이 하나씩 포함됩니다. 테이블에 여러 측정항목 유형의 데이터가 표시되는 경우, 이러한 병합이 가능하면 각 행에는 모든 쿼리의 결과가 포함됩니다.

테이블에는 두 가지 스타일이 있습니다. 테이블 위젯은 '25%'와 같은 숫자 값을 표시합니다. 상위 목록 위젯은 가능한 값의 범위와 비교하여 값과 값의 시각적 표시를 모두 표시합니다.

테이블과 차트 간에 스타일을 변경하고, 테이블 열 이름을 구성하고, 테이블셀의 색상을 변경하는 기준점을 추가할 수 있습니다. 자세한 내용과 예시는 대시보드에 테이블 형식으로 데이터 표시를 참조하세요.

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

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

Google Cloud 콘솔에서 대시보드 페이지로 이동합니다.
대시보드로 이동

검색창을 사용하여 이 페이지를 찾은 경우 부제목이 Monitoring인 결과를 선택합니다.
다음 중 하나를 수행합니다.
- 새 대시보드를 만들려면 대시보드 만들기를 선택합니다.
- 기존 대시보드를 업데이트하려면 모든 대시보드 목록에서 대시보드를 찾아 해당 이름을 선택합니다.
툴바에서 위젯 추가를 클릭합니다.
위젯 추가 대화상자에서 측정항목을 선택합니다.
차트에 표시될 데이터를 지정합니다. 메뉴 기반 인터페이스, 모니터링 쿼리 언어(MQL), PromQL을 사용하거나 Monitoring 필터를 입력할 수 있습니다.
메뉴 기반 인터페이스
1. 확인하려는 시계열 데이터를 선택합니다.
  1. 측정항목 요소에서 측정항목 선택 메뉴를 확장합니다.
    
    측정항목 선택 메뉴에는 사용 가능한 측정항목 유형을 찾는 데 도움이 되는 기능이 포함되어 있습니다.
    
    특정 측정항목 유형을 찾으려면 필터 막대를 사용합니다. 예를 들어 util을 입력하면 util이 포함된 항목이 표시되도록 메뉴를 제한합니다. 항목이 대소문자를 구분하지 않는 'contains' 테스트를 통과하면 표시됩니다.
    
    데이터가 없는 측정항목 유형을 포함하여 모든 측정항목 유형을 표시하려면 활성을 클릭합니다. 기본적으로 메뉴에는 데이터가 있는 측정항목 유형만 표시됩니다.
    
    예를 들어 다음 항목을 선택할 수 있습니다.
    
    활성 리소스 메뉴에서 VM 인스턴스를 선택합니다.
    
    활성 측정항목 카테고리 메뉴에서 uptime_check를 선택합니다.
    
    활성 측정항목 메뉴에서 요청 지연 시간을 선택합니다.
    
    적용을 클릭합니다.
  2. 선택사항: 표시할 데이터의 하위 집합을 지정하려면 필터 요소에서 필터 추가를 선택한 후 대화상자를 완료합니다. 예를 들어 필터를 적용하면 한 영역의 데이터를 볼 수 있습니다. 여러 필터를 추가할 수 있습니다. 자세한 내용은 차트 데이터 필터링을 참조하세요.
  자세한 내용은 차트에 표시할 데이터 선택을 참조하세요.
2. 시계열 조합 및 정렬:
  - 모든 시계열을 표시하려면 집계 요소에서 첫 번째 메뉴를 집계되지 않음으로, 두 번째 메뉴를 없음으로 설정합니다.
  - 시계열을 조합하려면 집계 요소에서 다음을 수행합니다.
    
    첫 번째 메뉴를 확장하고 함수를 선택합니다.
    
    차트가 새로고침되고 단일 시계열이 표시됩니다. 예를 들어 평균을 선택하면 모든 시계열의 평균이 시계열로 표시됩니다.
    
    라벨 값이 동일한 시계열을 조합하려면 두 번째 메뉴를 확장한 후 하나 이상의 라벨을 선택합니다.
    
    차트가 새로고침되고 각각의 고유한 라벨 값 조합에 대해 하나의 시계열이 표시됩니다. 예를 들어 영역당 하나의 시계열을 표시하려면 두 번째 메뉴를 영역으로 설정합니다.
    
    두 번째 메뉴가 없음으로 설정되었으면 차트에 시계열이 하나 표시됩니다.
  - 선택사항: 데이터 포인트 사이의 간격을 구성하려면 쿼리 요소 추가를 클릭하고 최소 간격을 선택한 후 값을 입력합니다.
  그룹화 및 정렬에 대한 자세한 내용은 차트 데이터 표시 방법 선택을 참조하세요.
3. 선택사항: 최댓값 또는 최솟값이 있는 시계열만 표시하려면 정렬 및 한도 요소를 사용합니다.
MQL
1. 쿼리 빌더 창의 툴바에서 이름이 MQL 또는 PromQL인 버튼을 선택합니다.
2. MQL 전환 버튼에 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 전환 버튼에 PromQL이 선택되어 있는지 확인합니다. 언어 전환 버튼은 쿼리 형식을 지정할 수 있는 동일한 툴바에 있습니다.
3. 쿼리 편집기에 쿼리를 입력합니다. 예를 들어 Google Cloud 프로젝트에서 VM 인스턴스의 평균 CPU 사용률을 차트로 작성하려면 다음 쿼리를 사용합니다.
  avg(compute_googleapis_com:instance_cpu_utilization)
  PromQL 사용에 대한 자세한 내용은 Cloud Monitoring의 PromQL을 참조하세요.
Monitoring 필터
1. 측정항목 요소에서 도움말을 클릭한 후 직접 필터 모드를 선택합니다.
  
  측정항목 및 필터 요소가 삭제되고 텍스를 입력할 수 있는 필터 요소가 생성됩니다.
  
  직접 필터 모드로 전환하기 전 리소스 유형, 측정항목 또는 필터를 선택한 경우 해당 설정이 필터 요소의 필드에 표시됩니다.
2. 필터 요소의 필드에 Monitoring 필터를 입력합니다.
3. 시계열 조합 및 정렬:
  - 모든 시계열을 표시하려면 집계 요소에서 첫 번째 메뉴를 집계되지 않음으로, 두 번째 메뉴를 없음으로 설정합니다.
  - 시계열을 조합하려면 집계 요소에서 다음을 수행합니다.
    
    첫 번째 메뉴를 확장하고 함수를 선택합니다.
    
    차트가 새로고침되고 단일 시계열이 표시됩니다. 예를 들어 평균을 선택하면 모든 시계열의 평균이 시계열로 표시됩니다.
    
    라벨 값이 동일한 시계열을 조합하려면 두 번째 메뉴를 확장한 후 하나 이상의 라벨을 선택합니다.
    
    차트가 새로고침되고 각각의 고유한 라벨 값 조합에 대해 하나의 시계열이 표시됩니다. 예를 들어 영역당 하나의 시계열을 표시하려면 두 번째 메뉴를 영역으로 설정합니다.
    
    두 번째 메뉴가 없음으로 설정되었으면 차트에 시계열이 하나 표시됩니다.
  - 선택사항: 데이터 포인트 사이의 간격을 구성하려면 쿼리 요소 추가를 클릭하고 최소 간격을 선택한 후 값을 입력합니다.
  그룹화 및 정렬에 대한 자세한 내용은 차트 데이터 표시 방법 선택을 참조하세요.
선택사항: 여러 측정항목 유형을 표시하도록 차트 또는 테이블을 구성합니다.

참고: 여러 측정항목 유형을 추가하고 테이블 위젯을 선택하면 가능한 경우 Google Cloud 콘솔에 두 측정항목 유형의 값이 동일한 행에 표시됩니다. 자세한 내용은 테이블에서 여러 측정항목 유형의 데이터를 병합하는 방법을 참조하세요.
메뉴 기반 인터페이스
1. 쿼리 추가를 선택합니다. 새 쿼리가 추가됩니다. 예를 들어 B 라벨이 있는 쿼리가 추가될 수 있습니다.
2. 새 쿼리의 경우 측정항목 요소에서 리소스 유형과 측정항목 유형을 선택합니다. 또한 필터를 추가하고, 시계열을 조합하고, 표시되는 시계열을 정렬하고 개수를 제한할 수 있습니다.
다음 스크린샷은 두 가지 측정항목 유형이 차트로 표시되는 측정항목 탐색기를 보여줍니다.
MQL
지원되지 않음

PromQL
지원되지 않음

Monitoring 필터
지원되지 않음
선택사항: 측정항목 유형의 비율을 표시하도록 차트를 구성합니다.
메뉴 기반 인터페이스
1. 측정항목 종류가 동일한 두 가지 측정항목 유형을 표시하도록 차트를 구성합니다. 예를 들어 둘 다 GAUGE 측정항목입니다.
2. 두 측정항목 유형 모두 최소 간격 필드의 값이 동일한지 확인합니다. 이 필드에 액세스하려면 쿼리 요소 추가를 클릭하고 최소 간격을 선택합니다.
3. 집계 필드를 업데이트합니다.
  
  분모 측정항목 유형의 라벨이 분자 측정항목 유형에 설정된 값과 일치하는지 확인하는 것이 좋습니다. 예를 들어 분자와 분모에 zone 라벨을 선택할 수 있습니다.
  
  두 측정항목 유형 모두 동일한 라벨 집합을 사용할 필요는 없지만, 두 측정항목 유형 모두 공통적인 라벨만 선택할 수 있습니다.
4. 쿼리 창의 툴바에서 비율 만들기를 선택한 후 대화상자를 완료합니다.
  
  비율을 만들면 세 가지 쿼리가 표시됩니다.
  - A/B 비율은 비율 쿼리를 식별합니다.
  - A는 분자의 쿼리를 식별합니다.
  - B는 분모의 쿼리를 식별합니다.
  다음 예시에서는 영역당 디스크에 작성된 바이트의 합계와 디스크에 작성된 총 바이트 수를 비교한 비율을 보여줍니다.
5. 선택사항: 분자 및 분모 측정항목을 전환하려면 비율 요소에서 메뉴를 확장한 후 항목을 선택합니다.
MQL
1. 쿼리 빌더 창의 툴바에서 이름이 MQL 또는 PromQL인 버튼을 선택합니다.
2. MQL 전환 버튼에 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에 대한 자세한 내용은 다음 문서를 참조하세요.
PromQL
1. 쿼리 빌더 창의 툴바에서 이름이 MQL 또는 PromQL인 버튼을 선택합니다.
2. PromQL 전환 버튼에 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 필터
지원되지 않음
선택사항: 시각화를 변경하려면 표시 창에서 위젯 유형을 클릭한 후 항목을 선택합니다.

위젯 유형 메뉴에는 동일한 유형의 데이터를 표시할 수 있는 모든 위젯 유형이 나열되지만 일부 위젯은 활성화되지 않을 수 있습니다. 하나의 측정항목 유형을 표시하도록 구성된 대시보드에 있는 차트를 예로 들어 보겠습니다. 선 차트에는 여러 시계열이 표시되고 측정된 각 값은 double입니다.
- 테이블, 원형 차트, 선 차트, 누적 막대 그래프 및 누적 영역 차트 위젯은호환 가능으로 나열됩니다. 이러한 유형 중 하나를 선택할 수 있습니다.
  
  참고: 데이터를 테이블 형식으로 표시하려면 위젯 유형을 테이블로 설정합니다. 차트 테이블 모두 라벨이 지정된 전환 버튼에서 테이블을 선택하면 디스플레이가 변경되지만 설정이 저장되지 않습니다.
- 스코어카드 및 게이지 위젯은 단일 시계열만 표시할 수 있기 때문에 조정과 호환 가능으로 표시됩니다. 이러한 위젯 유형을 사용 설정하려면 그룹화 구성을 수정합니다.
- 히트맵 위젯은 분포 값 데이터만 표시할 수 있으므로 중지됩니다.
- 로그 패널에 시계열 데이터가 표시될 수 없으므로 로그 패널이 표시되지 않습니다.
선택사항: 차트 또는 표에 선택한 데이터가 표시되는 방식을 변경하려면 표시 창의 옵션을 사용합니다.
- 차트 옵션:
  - 분석 모드 메뉴: 선 차트, X-Ray, 정적 중에서 선택합니다.
  - 과거와 비교 메뉴: 현재 데이터를 이전 데이터와 오버레이합니다.
  - 기준 선 메뉴: 참조 기준을 추가합니다.
  - 범례 별칭 메뉴: 범례 열의 이름을 구성합니다.
  - Y축 할당, Y축 라벨, Y축 배율 메뉴: Y축 할당, 라벨 또는 배율을 구성합니다.
- 테이블 옵션:
  - 값 옵션 메뉴: 최신 값과 집계된 값 중에서 선택합니다.
  - 표시되는 열 메뉴: 표시할 열을 선택합니다.
  - 열 형식 메뉴: 열 이름, 열의 데이터 정렬, 단위, 셀의 색상 지정 여부를 구성합니다.
  - 측정항목 뷰 메뉴: 값을 단독으로 표시할지 아니면 값 범위에 비례하여 표시할지 선택합니다.
  - 범례 별칭 메뉴: 범례 열의 이름을 구성합니다.
대시보드에 변경사항을 적용하려면 툴바에서 적용을 클릭합니다. 변경사항을 삭제하려면 취소를 클릭합니다.
수정된 대시보드를 저장하려면 툴바에서 저장을 클릭합니다.

최신 데이터만 표시

Monitoring은 측정 기록을 표시하는 대신 최근 측정만 시각화하는 여러 방법을 제공합니다.

각 값이 모든 값의 합계의 비율로 표시되는 각 시계열의 가장 최근 값을 그래픽으로 표시하려면 원형 차트를 추가합니다. 이러한 차트를 구성하여 값을 표시할 수 있습니다.
각 시계열의 최근 값을 테이블 형식으로 표시하려면 테이블을 추가합니다. 테이블 행 수를 제한할 수 있고, 값 범위와 달리 값을 표시하도록 테이블 행을 구성할 수 있습니다.
임곗값 집합과 비교하여 가장 최근 값을 초록색, 황색 또는 빨간색으로 표시하려면 대시보드에 게이지 또는 스코어카드를 추가합니다.

원형 차트로 최근 데이터 그래프 표시

최근 데이터를 전체 데이터의 일부로 표시하려면 원형 차트를 추가합니다. 테이블과 비슷하게, 원형 차트는 숫자 값이 있는 모든 측정항목 유형을 표시할 수 있고 분포 값 측정항목의 비율을 표시할 수 있습니다. 각 시계열은 원형 차트의 한 조각에 해당합니다.

다음 스크린샷은 원형 차트 위젯의 두 가지 서로 다른 구성을 사용하여 가상 머신 인스턴스의 CPU 사용률을 표시하는 대시보드를 보여줍니다.

**PieChart** 위젯 예시

대시보드에 원형 차트를 추가하는 방법에 대해서는 다음 문서를 참조하세요.

Google Cloud 콘솔: 이 문서에서 차트 및 테이블 추가 섹션을 참조하세요.
- 차트로 표시할 데이터를 선택한 후 표시 창에서 위젯 유형 필드를 원형 차트로 설정합니다.
- 총 값을 표시하려면 차트 유형 필드를 도넛으로 설정합니다.
Cloud Monitoring API: PieChart 위젯이 있는 대시보드를 참조하세요.

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

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

Google Cloud 콘솔에서 대시보드 페이지로 이동합니다.
대시보드로 이동

검색창을 사용하여 이 페이지를 찾은 경우 부제목이 Monitoring인 결과를 선택합니다.
다음 중 하나를 수행합니다.
- 새 대시보드를 만들려면 대시보드 만들기를 선택합니다.
- 기존 대시보드를 업데이트하려면 모든 대시보드 목록에서 대시보드를 찾아 해당 이름을 선택합니다.
툴바에서 위젯 추가를 클릭합니다.
위젯 추가 대화상자에서 측정항목을 선택합니다.
차트에 표시될 데이터를 지정합니다. 메뉴 기반 인터페이스, 모니터링 쿼리 언어(MQL), PromQL을 사용하거나 Monitoring 필터를 입력할 수 있습니다.
메뉴 기반 인터페이스
1. 확인하려는 시계열 데이터를 선택합니다.
  1. 측정항목 요소에서 측정항목 선택 메뉴를 확장합니다.
    
    측정항목 선택 메뉴에는 사용 가능한 측정항목 유형을 찾는 데 도움이 되는 기능이 포함되어 있습니다.
    
    특정 측정항목 유형을 찾으려면 필터 막대를 사용합니다. 예를 들어 util을 입력하면 util이 포함된 항목이 표시되도록 메뉴를 제한합니다. 항목이 대소문자를 구분하지 않는 'contains' 테스트를 통과하면 표시됩니다.
    
    데이터가 없는 측정항목 유형을 포함하여 모든 측정항목 유형을 표시하려면 활성을 클릭합니다. 기본적으로 메뉴에는 데이터가 있는 측정항목 유형만 표시됩니다.
    
    예를 들어 다음 항목을 선택할 수 있습니다.
    
    활성 리소스 메뉴에서 VM 인스턴스를 선택합니다.
    
    활성 측정항목 카테고리 메뉴에서 uptime_check를 선택합니다.
    
    활성 측정항목 메뉴에서 요청 지연 시간을 선택합니다.
    
    적용을 클릭합니다.
  2. 선택사항: 표시할 데이터의 하위 집합을 지정하려면 필터 요소에서 필터 추가를 선택한 후 대화상자를 완료합니다. 예를 들어 필터를 적용하면 한 영역의 데이터를 볼 수 있습니다. 여러 필터를 추가할 수 있습니다. 자세한 내용은 차트 데이터 필터링을 참조하세요.
  자세한 내용은 차트에 표시할 데이터 선택을 참조하세요.
2. 집계 필드를 사용하여 시계열을 조합합니다.
  - 첫 번째 메뉴를 펼치고 시계열을 결합하는 함수를 선택합니다.
  - 두 번째 메뉴를 펼치고 선택한 라벨이 없는지 확인합니다.
MQL
1. 쿼리 빌더 창의 툴바에서 이름이 MQL 또는 PromQL인 버튼을 선택합니다.
2. MQL 전환 버튼에 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 | group_by [], [value_utilization_mean_mean: mean(value_utilization_mean)]
  MQL에 대한 자세한 내용은 다음 문서를 참조하세요.
  - MQL 소개
  - 코드 편집기 사용
PromQL
1. 쿼리 빌더 창의 툴바에서 이름이 MQL 또는 PromQL인 버튼을 선택합니다.
2. PromQL 전환 버튼에 PromQL이 선택되어 있는지 확인합니다. 언어 전환 버튼은 쿼리 형식을 지정할 수 있는 동일한 툴바에 있습니다.
3. 쿼리 편집기에 쿼리를 입력합니다. 예를 들어 Google Cloud 프로젝트에서 VM 인스턴스의 평균 CPU 사용률을 차트로 작성하려면 다음 쿼리를 사용합니다.
  avg(compute_googleapis_com:instance_cpu_utilization)
  PromQL 사용에 대한 자세한 내용은 Cloud Monitoring의 PromQL을 참조하세요.
Monitoring 필터
1. 측정항목 요소에서 도움말을 클릭한 후 직접 필터 모드를 선택합니다.
  
  측정항목 및 필터 요소가 삭제되고 텍스를 입력할 수 있는 필터 요소가 생성됩니다.
  
  직접 필터 모드로 전환하기 전 리소스 유형, 측정항목 또는 필터를 선택한 경우 해당 설정이 필터 요소의 필드에 표시됩니다.
2. 모니터링 필터를 입력합니다.
3. 집계 필드를 사용하여 시계열을 조합합니다.
  - 첫 번째 메뉴를 펼치고 시계열을 결합하는 함수를 선택합니다.
  - 두 번째 메뉴를 펼치고 선택한 라벨이 없는지 확인합니다.
표시 창에서 게이지 또는 스코어카드를 구성합니다.
1. 위젯 유형을 클릭하고 게이지 또는 스코어카드를 선택합니다.
2. 게이지 위젯의 경우 게이지 범위를 클릭한 후 최솟값과 최댓값을 설정합니다. 게이지에 백분율이 표시되면 이 값을 각각 0과 1로 설정합니다.
3. 게이지 기준점을 클릭한 후 경고 및 위험 기준점을 설정합니다. 비어 있는 기준점 필드는 사용되지 않습니다.
  
  이전에 표시된 게이지에는 2개의 기준점이 설정되어 있습니다. 값이 0.9보다 크면 위험 범위입니다. 0.7보다 크지만 위험 범위가 아닌 값은 경고 범위에 있습니다.
4. 스코어카드의 경우 Spark 차트 보기를 클릭한 다음 옵션 메뉴를 펼치고 표시 스타일을 선택합니다.
대시보드에 변경사항을 적용하려면 툴바에서 적용을 클릭합니다. 변경사항을 삭제하려면 취소를 클릭합니다.
수정된 대시보드를 저장하려면 툴바에서 저장을 클릭합니다.

테이블에서 여러 측정항목 유형의 데이터를 병합하는 방법

테이블에서 여러 측정항목 유형을 쿼리하는 경우 Google Cloud 콘솔은 두 측정항목 유형에 대해 집계된 데이터에 연결된 라벨을 검사하여 병합 작업을 수행합니다. 두 쿼리에 공통적인 라벨을 통해 Monitoring에서 고유한 행 식별자를 결정할 수 있는 경우 테이블의 단일 행에 각 쿼리에 대한 최신 값이 표시됩니다. 그렇지 않으면 시계열마다 행이 하나씩 있습니다.

예를 들어 테이블이 두 가지 서로 다른 측정항목 유형을 쿼리한다고 가정해 보겠습니다. 이러한 쿼리를 A 및 B라고 하겠습니다. 다음은 쿼리 결과가 병합되는 방법을 설명합니다.

두 쿼리의 결과에 동일한 라벨 세트가 있으면 병합은 항상 성공합니다. 각 행에는 각 쿼리의 최신 값이 포함됩니다. 쿼리가 특정 라벨 조합에 대한 값을 반환하지 않으면 테이블 셀이 비어 있습니다.

예를 들어 두 쿼리에 모두 zone 라벨이 포함되어 있다고 가정해 보겠습니다. 이 테이블에는 쿼리 A와 쿼리 B에서 보고된 각 영역에 대해 행이 하나씩 포함됩니다. 하지만 쿼리 A가 영역이 us-central1-a인 시계열을 반환하지만 쿼리 B가 이 값의 시계열을 반환하지 않으면 쿼리 B의 최신 값은 빈 셀로 표시됩니다.
한 쿼리의 결과 라벨이 다른 쿼리의 결과 라벨의 하위 집합인 경우 결과가 병합됩니다.

예를 들어 두 쿼리의 결과에 모두 location 및 cluster_name 라벨이 포함되어 있지만 쿼리 A의 결과에는 memory_type 라벨도 포함되어 있다고 가정해 보겠습니다. 이 경우 각 행은 세 라벨의 고유한 값이 있는 시계열에 해당합니다.

어떤 행이든 쿼리 B에 표시되는 값은 두 개의 공통 라벨인 location 및 cluster_name와 일치하는 시계열의 값이며 세 번째 라벨은 무시됩니다.
두 쿼리의 결과가 공유하는 라벨이 없거나 일부 라벨을 공유하지만 고유한 행 식별자를 형성하기에 충분하지 않으면 결과를 병합할 수 없습니다. 테이블에는 쿼리 A 또는 쿼리 B에서 반환된 시계열마다 행이 하나씩 표시되며 일부 테이블 셀은 비어 있습니다.

예를 들어 쿼리 A의 라벨이 location 및 memory_type이고 쿼리 B의 라벨이 location 및 cluster_name라고 가정해 보겠습니다. location 라벨은 공통이지만 이 라벨만으로는 고유한 행 식별자를 만들 수 없습니다.

다음 섹션에 설명된 대로 병합 실패를 해결할 수 있습니다.

병합 실패 해결

여러 측정항목을 차트로 표시할 때 측정항목에서 동일한 필드에 서로 다른 라벨 이름을 사용하기 때문에 병합 실패가 발생할 수 있습니다. 이 오류를 해결하는 한 가지 방법은 하나의 쿼리를 PromQL로 변환한 다음 label_replace() 함수를 사용하여 한 측정항목 유형에서 사용하는 라벨 이름을 다른 측정항목 유형의 라벨 이름과 일치하도록 변환하는 것입니다.

다음과 같은 두 쿼리로 구성된 테이블을 예로 들어 보겠습니다.

A: Prometheus/kube_pod_container_status_ready/gauge 측정항목 유형을 쿼리합니다. 집계 옵션은 cluster 라벨로 데이터를 그룹화한 후 시계열을 합산하도록 설정됩니다.
B: kubernetes.io/container/memory/request_bytes 측정항목 유형을 쿼리합니다. 집계 옵션은 cluster_name 라벨로 데이터를 그룹화한 후 시계열을 합산하도록 설정됩니다.

쿼리 A와 쿼리 B의 결과 라벨이 다르므로 테이블에서 결과를 병합할 수 없습니다.

오류를 해결하려면 쿼리 A를 PromQL로 변환하고 cluster를 cluster_name으로 바꿉니다. 다음 예시는 수정된 쿼리를 보여줍니다.

sum by (cluster_name)(
    label_replace(
        avg_over_time(kube_pod_container_status_ready[${__interval}]),
        "cluster_name", "$1", "cluster", "(.*)"
    )
)

변경사항을 적용하면 두 쿼리 모두 동일한 라벨 집합을 생성합니다. 따라서 테이블의 각 행에는 클러스터 이름, 쿼리 A의 값, 쿼리 B의 값이 나열됩니다.

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

다음 단계

커스텀 대시보드에 다음 위젯을 추가할 수도 있습니다.

차트 데이터 탐색 및 대시보드 필터링에 대한 자세한 설명은 다음 문서를 참조하세요.

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

시작하기 전에

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

메뉴 기반 인터페이스

MQL

PromQL

Monitoring 필터

메뉴 기반 인터페이스

MQL

PromQL

Monitoring 필터

메뉴 기반 인터페이스

MQL

PromQL

Monitoring 필터

최신 데이터만 표시

원형 차트로 최근 데이터 그래프 표시

최신 데이터를 테이블 형식으로 표시

최신 값 또는 집계된 값 표시

표시할 열 선택

열 형식 구성

참조 값 표시

테이블 정렬 및 필터링

경고 또는 오류 표시와 함께 최신 데이터 표시

메뉴 기반 인터페이스

MQL

PromQL

Monitoring 필터

테이블에서 여러 측정항목 유형의 데이터를 병합하는 방법

병합 실패 해결

다음 단계