기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

Google 클라우드 모니터링 데이터 소스에 연결

Google 클라우드 모니터링 측정항목에 대한 대시보드를 구축할 수 있도록 Google 클라우드 모니터링 데이터 소스를 추가하세요.

데이터 소스 추가

인증

Google 클라우드 모니터링 플러그인을 인증하는 방법은 두 가지가 있습니다.

후자의 옵션은 GCE 가상 머신에서 Grafana를 실행할 때만 사용할 수 있습니다.

Google 서비스 계정 키 파일 사용

Google 클라우드 모니터링 API로 인증하려면 데이터를 표시하려는 프로젝트의 Google 클라우드 플랫폼 (GCP) 서비스 계정을 만들어야 합니다. Grafana 데이터 소스는 하나의 GCP 프로젝트와 통합됩니다. 여러 GCP 프로젝트의 데이터를 시각화하려면 GCP 프로젝트당 하나의 데이터 소스를 만들어야 합니다.

API 사용 설정하기

먼저 다음 API를 활성화해야 합니다.

나열된 링크를 선택한 다음 활성화 버튼을 선택합니다.

프로젝트용 GCP 서비스 계정 만들기

쿼리 편집기 사용하기

Google 클라우드 모니터링 쿼리 편집기를 사용하면 지표와 서비스 수준 목표 (SLO) 라는 두 가지 유형의 쿼리를 작성할 수 있습니다. 두 유형 모두 시계열 데이터를 반환합니다.

메트릭 쿼리

메트릭 쿼리 편집기를 사용하면 메트릭을 선택하고, 레이블 및 시간별로 그룹화/집계하고, 필터를 사용하여 결과에 표시할 시계열을 지정할 수 있습니다.

지표 쿼리를 만들려면 다음 단계를 따르십시오.

Google Cloud Monitoring 측정항목은 종류 (게이지, 델타, 누적) 가 다를 수 있으며 이러한 종류는 다양한 집계 옵션 (리듀서 및 얼라이너) 을 지원합니다. Grafana 쿼리 편집기는 선택한 메트릭에 대해 사용 가능한 집계 방법 목록을 표시하고 메트릭을 선택할 때 기본 리듀서 및 얼라이너를 설정합니다. Y축 단위도 쿼리 편집기에서 자동으로 선택됩니다.

필터

필터를 추가하려면 더하기 아이콘을 선택하고 필터링 기준으로 사용할 필드를 선택한 다음 필터 값을 입력합니다. 예를 들면 instance_name = grafana-1를 입력합니다. 필터 이름을 선택하고 선택하여 필터를 제거할 수 --remove filter-- 있습니다.

단순 와일드카드 문자

연산자가 또는 로 설정된 경우 = != 필터 값 필드에 와일드카드 문자를 추가할 수 있습니다. 예를 들어, us-* 는 “us-”로 시작하는 모든 값을 *central-a 캡처하고 “central-a”로 끝나는 모든 값을 캡처합니다. *-central-*하위 문자열이 인 모든 값을 캡처합니다. central- 단순 와일드카드 문자는 정규 표현식보다 비용이 저렴합니다.

정규식

연산자가 or로 설정된 경우 =~ !=~ 필터 값 필드에 정규 표현식을 추가할 수 있습니다. 예를 들어, 는 “us-central”로 시작하고 그 뒤에 1~3 범위의 숫자, 대시, “a” 또는 “f”가 차례로 오는 모든 값과 us-central[1-3]-[af] 일치합니다. 정규 표현식을 만들 때는 선행 슬래시와 후행 슬래시가 필요하지 않습니다.

집계

집계 필드를 사용하면 일반 통계를 기반으로 시계열을 결합할 수 있습니다. 집계에 대한 자세한 내용은 집계 옵션을 참조하십시오.

이 Aligner 필드를 사용하면 동일한 그룹 뒤에 있는 여러 시계열을 시간 간격별로 정렬할 수 있습니다. 얼라이너에 대한 자세한 내용은 정렬 메트릭 선택기를 참조하십시오.

정렬 기간 및 시간별 그룹화

집계를 선택한 경우 지표를 시간별로 Alignment Period 그룹화합니다. 기본값은 GCP Google 클라우드 모니터링 기본 그룹화를 사용하는 것입니다. 이를 통해 Grafana의 그래프를 Google 클라우드 모니터링 UI의 그래프와 비교할 수 있습니다. 옵션이 cloud monitoring auto 호출되며 기본값은 다음과 같습니다.

다른 자동 옵션은 다음과 같습니다. grafana auto 그러면 선택한 시간 범위와 그래프 패널의 너비에 따라 시간별로 그룹이 자동으로 설정됩니다. 자세한 정보는 간격 변수 추가을 참조하세요.

그룹화 기준으로 사용할 고정된 시간 간격 (예: 1h 또는) 을 선택할 수도 1d 있습니다.

그룹화 기준

리소스 또는 지표 레이블별로 그룹화하여 시계열 수를 줄이고 결과를 그룹별로 집계합니다. 예를 들어, instance_name별로 그룹화하여 컴퓨팅 인스턴스의 집계된 지표를 확인할 수 있습니다.

메타데이터 레이블

리소스 메타데이터 라벨에는 Google Cloud의 리소스를 고유하게 식별하는 정보가 포함되어 있습니다. 메타데이터 레이블은 시계열 요청의 Group By 세그먼트에 속하는 경우에만 시계열 응답에서 반환됩니다. 메타데이터 레이블을 검색하기 위한 API가 없으므로 선택한 서비스 및 지표에 사용할 수 있는 메타데이터 레이블로 그룹별 드롭다운 목록을 채울 수 없습니다. 그러나 Group By 필드 드롭다운 목록에는 공통 시스템 레이블의 사전 정의된 목록이 함께 제공됩니다.

사용자 레이블은 미리 정의할 수 없지만 그룹화 기준 필드에 수동으로 입력할 수는 있습니다. 메타데이터 레이블, 사용자 레이블 또는 시스템 레이블이 그룹화 기준 세그먼트에 포함된 경우 해당 세그먼트를 기반으로 필터를 만들고 별칭 필드에서 해당 값을 확장할 수 있습니다.

앨리어스 패턴

Alias By 필드를 사용하면 범례 키의 형식을 제어할 수 있습니다. 기본값은 지표 이름과 레이블을 표시하는 것입니다. 길이가 길고 읽기 어려울 수 있습니다. 별칭 필드에서 다음 패턴을 사용하여 원하는 방식으로 범례 키의 형식을 지정할 수 있습니다.

지표 유형 패턴

라벨 패턴

Group By 드롭다운 목록에서 지표에 대한 지표 및 리소스 레이블 목록을 볼 수 있습니다. 별칭 패턴을 사용하여 범례 키에 이러한 항목을 포함할 수 있습니다.

예시 별칭 기준: {{metric.type}} - {{metric.label.instance_name}}

결과 예시: compute.googleapis.com/instance/cpu/usage_time - server1-prod

모니터링되는 리소스 유형의 이름을 확인할 수도 있습니다.

예제 별칭 기준: {{resource.type}} - {{metric.type}}

결과 예시: gce_instance - compute.googleapis.com/instance/cpu/usage_time

SLO 쿼리

Google 클라우드 모니터링 데이터 소스의 SLO 쿼리 빌더를 사용하면 SLO 데이터를 시계열 형식으로 표시할 수 있습니다. 서비스 모니터링의 기본 개념을 이해하려면 Google 클라우드 모니터링 공식 문서를 참조하세요.

SLO 쿼리 만들기

SLO 쿼리를 만들려면 다음 단계를 따르십시오.

시계열 선택기의 친숙한 이름은 Grafana에 표시됩니다. 다음 표는 친숙한 이름에서 서비스 모니터링 설명서에 사용되는 시스템 이름으로의 매핑을 보여줍니다.

SLO 쿼리의 앨리어스 패턴

Alias By 필드를 사용하여 SLO 쿼리의 범례 키 형식을 제어할 수 있습니다.

정렬 기간 및 SLO 쿼리의 시간별 그룹화

SLO 쿼리는 지표 쿼리와 동일한 정렬 기간 기능을 사용합니다. 자세한 정보는 메트릭 쿼리을 참조하세요.

템플릿 작성

메트릭 쿼리에 서버, 애플리케이션, 센서 이름 등을 하드코딩하는 대신 변수를 대신 사용할 수 있습니다. 변수는 대시보드 상단의 드롭다운 선택 상자로 표시됩니다. 이 드롭다운 상자를 사용하여 대시보드에 표시되는 데이터를 변경할 수 있습니다.

템플릿 및 템플릿 변수에 대한 자세한 내용은 을 참조하십시오. 템플릿 및 변수

쿼리 변수

쿼리 유형의 변수를 사용하면 Google 클라우드 모니터링에서 다양한 유형의 데이터를 쿼리할 수 있습니다. Google 클라우드 모니터링 데이터 소스 플러그인은 다음을 제공합니다Query Types.

쿼리에 변수 사용

두 가지 구문이 있습니다.

왜 두 가지 방법일까요? 첫 번째 구문은 읽고 쓰기는 더 쉽지만 단어 중간에 변수를 사용할 수는 없습니다. 다중 값 또는 모든 값 포함 옵션이 활성화되면 Grafana는 레이블을 일반 텍스트에서 정규식 호환 문자열로 변환하므로 대신 사용해야 합니다. =~ =

주석

주석을 사용하여 그래프 위에 풍부한 이벤트 정보를 오버레이할 수 있습니다. 대시보드 메뉴/주석 보기를 통해 주석 쿼리를 추가할 수 있습니다. 주석 렌더링은 비용이 많이 들기 때문에 반환되는 행 수를 제한하는 것이 중요합니다. Google 클라우드 모니터링 주석 및 이벤트 표시는 아직 지원되지 않지만 Google 클라우드 모니터링의 맞춤 측정항목과 잘 작동합니다.

주석에 관한 자세한 내용은 을 참조하십시오. 주석

주석용 쿼리 편집기를 사용하여 지표와 필터를 선택할 수 있습니다. 제목 및 텍스트 필드는 템플릿을 지원하며 쿼리에서 반환된 데이터를 사용할 수 있습니다. 예를 들어 제목 필드에는 다음과 같은 텍스트가 포함될 수 있습니다.

{{metric.type}} has value: {{metric.value}}

예제 결과: monitoring.googleapis.com/uptime_check/http_status has this value: 502

주석 쿼리 편집기의 패턴

Grafana 패널에서 구글 클라우드 콘솔의 메트릭 탐색기로 딥링킹

패널에서 시계열을 선택하면 Google Cloud Console의 지표 탐색기에서 보기 링크가 포함된 컨텍스트 메뉴가 표시됩니다. 이 링크를 선택하면 Google Cloud 콘솔에서 지표 탐색기가 열리고 Grafana 패널에서 쿼리가 실행됩니다. 링크를 클릭하면 사용자가 먼저 Google 계정 선택 화면으로 이동합니다. 계정을 성공적으로 선택하면 사용자는 지표 탐색기로 리디렉션됩니다. 제공된 링크는 모든 계정에 유효하지만, 계정에 쿼리에 지정된 GCP 프로젝트에 대한 액세스 권한이 있는 경우에만 쿼리가 표시됩니다.