MQL을 사용하여 쿼리 기반 알림 설정

MQL을 사용하여 쿼리 기반 알림 설정

이 문서에서는 Google Cloud 콘솔에서 모니터링 쿼리 언어(MQL)를 사용하여 측정항목을 탐색하고, 차트를 만들고, 쿼리 기반 알림을 설정하는 방법을 보여줍니다. Cloud Monitoring API를 사용하고 싶으면 알림 정책 조건 만들기를 참조하세요.

이 문서에서는 다음 작업을 수행합니다.

1. Compute Engine 인스턴스를 생성합니다.

2. 코드 편집기로 이동합니다.

3. 쿼리 수행 및 차트 만들기

4. 쿼리 기반 알림 설정하기

시작하기 전에

MQL을 사용하려면 Google Cloud 프로젝트를 만들고 결제를 사용 설정해야 합니다.

1. Google Cloud 계정에 로그인합니다. Google Cloud를 처음 사용하는 경우 계정을 만들고 Google 제품의 실제 성능을 평가해 보세요. 신규 고객에게는 워크로드를 실행, 테스트, 배포하는 데 사용할 수 있는 $300의 무료 크레딧이 제공됩니다.

2. Google Cloud Console의 프로젝트 선택기 페이지에서 Google Cloud 프로젝트를 선택하거나 만듭니다.

   참고: 이 절차에서 생성한 리소스를 유지하지 않으려면 기존 프로젝트를 선택하지 말고 프로젝트를 새로 만드세요. 작업이 끝나면 프로젝트를 삭제하여 프로젝트와 관련된 모든 리소스를 삭제할 수 있습니다.

   프로젝트 선택기로 이동

3. Google Cloud 프로젝트에 결제가 사용 설정되어 있는지 확인합니다.

4. Google Cloud Console의 프로젝트 선택기 페이지에서 Google Cloud 프로젝트를 선택하거나 만듭니다.

   참고: 이 절차에서 생성한 리소스를 유지하지 않으려면 기존 프로젝트를 선택하지 말고 프로젝트를 새로 만드세요. 작업이 끝나면 프로젝트를 삭제하여 프로젝트와 관련된 모든 리소스를 삭제할 수 있습니다.

   프로젝트 선택기로 이동

5. Google Cloud 프로젝트에 결제가 사용 설정되어 있는지 확인합니다.

그런 후 권한 및 알림 채널을 구성합니다.

1. MQL 기반 조건으로 알림 정책을 만드는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대해 모니터링 편집자(roles/monitoring.editor) IAM 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 자세한 내용은 액세스 관리를 참조하세요.

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

   Cloud Monitoring 역할에 대한 자세한 내용은 Identity and Access Management로 액세스 제어를 참조하세요.

2. 알림 정책, MQL, 코드 편집기의 일반 개념을 숙지해야 합니다. 자세한 내용은 다음 항목을 참조하세요.

   • 알림 개요
   • MQL을 사용한 알림 정책
   • MQL용 코드 편집기 사용

Compute Engine 인스턴스 만들기

Google Cloud 리소스가 측정항목을 수집하게 만들려면 다음 절차를 완료하여 Compute Engine 인스턴스를 만듭니다.

1. Google Cloud 콘솔 메뉴에서 Compute Engine을 선택합니다.

   

2. 인스턴스 만들기를 선택한 후 만들기를 클릭합니다.

참고: 인스턴스를 만드는 데 문제가 있는 경우 빠른 시작: Linux VM 사용을 참조하세요.

코드 편집기로 이동

MQL을 시작하려면 다음을 수행하세요.

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

   측정항목 탐색기로 이동

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

코드 편집기를 사용하여 MQL 쿼리를 작성하고 테스트하고 실행합니다.

쿼리 수행 및 차트 만들기

인스턴스의 CPU 사용률을 차트로 작성하는 쿼리를 만듭니다.

1. 다음 쿼리를 코드 편집기에 붙여넣습니다.

   fetch gce_instance::compute.googleapis.com/instance/cpu/utilization
   | {
       top 1, max(val())
     ;
       bottom 1, min(val())
     }
   | union
   

   이 쿼리는 차트 작성을 위해 최대 및 최소 CPU 사용률이 포함된 시계열을 선택합니다. 이 쿼리에 대한 자세한 내용은 union과 선택 항목 결합을 참조하세요.

2. 쿼리 실행을 클릭합니다. 차트에는 인스턴스의 최대 및 최소 CPU 사용률을 보여주는 두 개의 줄이 표시됩니다.

   

3. 차트를 저장하려면 차트 저장을 클릭합니다. 차트에 이름을 지정하고 이를 기존 대시보드 또는 새 대시보드에 추가합니다. 그런 다음 저장을 클릭하고

차트는 모니터링 개요 페이지로 가거나 대시보드에 저장한 경우 대시보드의 페이지로 이동하여 액세스할 수 있습니다.

쿼리 기반 알림 설정

쿼리 결과를 모니터링하는 알림 정책을 만들 수 있습니다. 이러한 알림 정책을 만들려면 다음 단계를 완료합니다.

1. Google Cloud 콘솔의 탐색 패널에서 Monitoring을 선택한 후  알림을 선택합니다.

   알림으로 이동

2. 알림 페이지에서 알림 채널 수정을 클릭합니다. 이 단계에서 알림을 받을 이메일 주소를 구성합니다.

   1. 알림 채널 페이지에서 이메일로 이동하고 새로 추가를 클릭합니다.

   2. 이메일 주소 필드에 알림을 전송할 이메일 주소를 입력합니다.

   3. 표시 이름 필드에 'Alert on-call'과 같이 채널의 간략한 설명을 입력합니다.

   4. 저장을 클릭합니다.

   5. 페이지 헤더에서 뒤로를 클릭하여 알림 페이지로 돌아갑니다.

3. 알림 페이지에서 정책 만들기를 클릭합니다.

   이 페이지에서는 알림 정책을 만드는 다음 절차를 안내합니다.

   1. 알림을 실행할 항목 설명
   2. 문제 해결 방법에 대한 정보 제공
   3. 알림에 대한 알림 채널 지정

4. 알림을 실행하려는 항목을 설명하려면 새 조건을 클릭합니다. 이 작업을 수행하면 양식 기반 조건 편집기가 표시됩니다.

   1. 정책 구성 모드에서 코드 편집기(MQL 또는 PromQL)를 선택합니다.

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

   3. 코드 편집기에서 모니터링할 데이터를 선택하는 쿼리를 입력합니다. 다음 쿼리는 인스턴스의 CPU 사용 시간이 20초 넘게 유지될 경우 알림을 트리거합니다.

      fetch gce_instance::compute.googleapis.com/instance/cpu/usage_time
      | window 1m
      | condition val() > 20 's'
      

      condition 작업은 알림을 전송할 성능 기준점을 설정합니다. condition 및 기타 알림 작업에 대한 자세한 내용은 MQL 참조에서 알림을 참조하세요.

      자동 실행 사용 설정되었으면 MQL 차트에 선택한 데이터와 기준점 선이 표시됩니다.

      

   4. 알림 트리거를 구성하려면 다음을 클릭합니다.

      1. 알림 트리거 메뉴에서 알림 정책을 트리거하기 전 알림 작업을 충족해야 하는 시계열 수를 선택합니다. 다음 기준에서 선택할 수 있습니다.

         • 단일 시계열
         • 특정한 수의 시계열
         • 시계열의 백분율
         • 모든 시계열

      2. 선택사항: 고급 옵션 메뉴를 확장하고 다음 시간 동안 조건이 충족되면 트리거됩니다 필드에서 값을 입력하거나 선택합니다.

         이 필드는 알림 정책이 트리거되기 전에 조건이 충족되어야 하는 기간을 정의합니다. 재테스트 기간은 MQL 쿼리에 사용된 정렬 기간과 다릅니다. 이러한 값의 관계에 대한 자세한 내용은 정렬 기간 및 시간을 참조하세요.

      3. "기본 MQL 조건"과 같은 조건 이름을 입력합니다.

5. 알림, 문서, 알림 정책 이름을 설정하려면 다음을 클릭합니다.

   1. 이전에 만든 알림 채널을 선택합니다.

   2. 심각도 수준을 선택합니다.

   3. 문서 필드에 알림과 함께 전송할 텍스트를 입력합니다. 이 텍스트는 일반적으로 응답자가 문제를 해결하는 데 도움이 되는 정보를 제공합니다. 이 연습에서는 "CPU 사용량이 20초를 초과했습니다."를 입력합니다.

   4. 알림 정책 이름 필드에 알림 정책 이름을 입력합니다. 이 값을 통해 알림과 다른 알림 정책을 구분할 수 있습니다.

6. 정책 만들기를 클릭하여 정책을 저장합니다.

삭제

이 페이지에서 사용한 리소스 비용이 Google Cloud 계정에 청구되지 않도록 하려면 다음 단계를 수행합니다.

1. Google Cloud Console의 Identity and Access Management 페이지로 이동합니다.

   프로젝트 설정으로 이동

2. 종료 를 클릭하고 안내에 따릅니다.

다음 단계

• 코드 편집기 사용 자세히 알아보기
• MQL 예시 살펴보기
• MQL 기반 알림 정책에 대해 자세히 알아보기
• Cloud Monitoring API에서 MQL 쿼리를 호출하는 방법 알아보기
• MQL 참조에서 MQL의 세부정보 살펴보기
• DevOps 관련 리소스를 읽고 DORA의 연구 프로그램 살펴보기