측정항목 기준 알림 정책 관리

이 문서에서는 Google Cloud Console을 사용하여 측정항목을 기준으로 알림 정책을 만들고 관리하는 방법을 보여줍니다. 이 콘텐츠는 로그 기준 알림 정책에 적용되지 않습니다. 특정 메시지가 로그에 표시될 때 알림을 표시하는 로그 기준 알림 정책에 대한 자세한 내용은 로그 모니터링을 참조하세요.

알림 정책에서는 모니터링할 조건 집합을 지정합니다. 이러한 조건은 애플리케이션의 상태, 시스템 측정항목의 값, 리소스 소비와 관련될 수 있습니다. 예를 들어 업타임 체크를 모니터링하는 정책을 만들거나 Cloud Monitoring API 사용량을 모니터링하는 정책을 만들 수 있습니다. 또한 알림 정책을 사용하면 정책 조건이 충족되었을 때 알림을 표시할 방법 및 해당 알림에 포함할 문서를 지정할 수 있습니다.

또한 Cloud Monitoring API를 사용하여 알림 정책을 만들고 관리할 수 있습니다. 이 방법에 대한 자세한 내용은 API를 통한 알림 정책 관리를 참조하세요. JSON으로 표현된 정책을 확인하려면 샘플 정책을 참조하세요.

시작하기 전에

알림 정책을 만들기 전에 알림 정책의 일반적인 개념과 용어를 익혀야 합니다. 정책 구성요소, 이슈 개념, 가격 책정, 제한사항에 대한 자세한 내용은 알림 소개를 참조하세요.

알림 정책 만들기

Cloud Monitoring은 알림 정책을 만들기 위해 사용하는 인터페이스를 새로고침합니다. 이 문서에서는 레거시 인터페이스 및 미리보기 인터페이스에 대한 정보를 제공합니다. 미리보기 인터페이스를 사용하도록 선택한 후 레거시 인터페이스를 사용하려면 레거시 UI로 돌아가기를 클릭합니다.

기존 인터페이스

알림 정책을 만들려면 다음 안내를 따르세요.

  1. Cloud Console에서 Monitoring을 선택합니다.

    Monitoring으로 이동

  2. 알림을 선택합니다.

  3. 정책 만들기를 클릭하여 알림 정책 만들기 페이지를 확인합니다.

    알림 정책 만들기 대화상자가 표시됩니다.

    1. 조건 추가를 클릭하고 대화상자를 완료합니다. 조건의 필드에 대한 자세한 내용은 조건 지정을 참조하세요.

      조건은 모니터링 리소스, 리소스 측정항목, 조건이 충족되는 시기를 설명합니다. 알림 정책에는 조건이 최소 1개 이상 있어야 하지만 알림 정책에는 조건이 최대 6개까지 포함될 수 있습니다. 알림 정책에 조건이 정확히 1개만 있고 조건이 충족되면 이슈가 생성됩니다. 알림 정책에 조건이 여러 개 있으면 이러한 조건이 결합되는 방식을 지정합니다. 자세한 내용은 여러 조건이 포함된 정책을 참조하세요.

    2. 다음을 클릭하여 알림 섹션으로 이동합니다.

    3. 이슈가 생성될 때 알림을 받으려면 알림 정책에 알림 채널을 추가합니다. 알림 채널을 여러 개 추가할 수 있습니다. 알림 채널 선택에 대한 자세한 내용은 알림 옵션을 참조하세요.

      알림 채널을 추가하려면 알림 채널을 클릭합니다. 대화상자의 메뉴에서 하나 이상의 알림 채널을 선택한 다음 확인을 클릭합니다.

      채널 새로고침 및 관리 버튼이 표시된 알림 대화상자

      추가할 알림 채널이 나열되어 있지 않으면 알림 채널 관리를 클릭합니다. 새 브라우저 탭에서 알림 채널 페이지로 이동합니다. 구성된 알림 채널을 이 페이지에서 업데이트할 수 있습니다. 업데이트를 완료했으면 원래 탭으로 돌아가서 새로고침 을 클릭한 다음 알림 채널을 선택하여 알림 정책에 추가합니다. 자세한 내용은 주문형 채널 만들기를 참조하세요.

    4. (선택사항) 이슈가 열리고 종료될 때 알림을 받으려면 이슈 종료 시 알림을 선택합니다. 기본적으로 알림은 이슈가 열렸을 때만 전송됩니다.

      이슈 종료 시 알림 버튼 이미지

    5. (선택사항) 이슈 자동 종료 기간 필드가 표시되면 관측이 도착하지 않을 때 이슈를 닫기 전 Monitoring이 기다려야 하는 기간으로 이 필드 값을 설정합니다. 이 필드의 기본값은 7일입니다.

      예를 들어 가상 머신(VM)을 모니터링하는 측정항목 기준 조건을 포함하는 알림이 있다고 가정합니다. 이슈가 개설되었을 때 VM을 해제하면 기본적으로 이슈를 닫기 전 Monitoring이 7일 간 기다립니다.

    6. 다음을 클릭하여 문서 섹션으로 이동합니다.

    7. 이름을 클릭하고 정책 이름을 입력합니다. 이 이름은 알림에 포함되며 정책 페이지에 표시됩니다.

    8. (선택사항) 알림에 포함할 문서를 지정합니다. 마크다운을 사용하여 문서 형식을 지정할 수 있습니다. 변수를 사용하면 정책 자체에서 정보를 가져와 문서 콘텐츠를 맞춤설정할 수 있습니다. 이 필드의 콘텐츠 형식 지정 및 맞춤설정 방법에 대한 자세한 내용은 문서 템플릿에서 마크다운 및 변수 사용을 참조하세요.

      예를 들어 문서에는 Addressing High CPU Usage와 같은 제목과 프로젝트를 식별하는 세부정보가 포함될 수 있습니다.

      ## Addressing High CPU Usage
      
      This note contains information about high CPU Usage.
      
      You can include variables in the documentation. For example:
      
      This alert originated from the project ${project}, using
      the variable $${project}.
      

      이 값은 알림에서만 변수를 대체합니다. 미리보기 마크다운 창과 문서를 표시하는 Cloud Console의 다른 위치에는 마크다운 형식만 반영됩니다.

      마크다운을 사용하여 문서화 메모를 작성한 예입니다.

      채널별 태그를 포함해 알림을 컨트롤할 수도 있습니다. 자세한 내용은 채널 컨트롤 사용을 참조하세요.

  4. 저장을 클릭합니다.

미리보기 인터페이스

알림 정책을 만들려면 다음 안내를 따르세요.

  1. Cloud Console에서 Monitoring을 선택합니다.

    Monitoring으로 이동

  2. Cloud Monitoring 탐색 창에서 알림을 선택한 후 정책 만들기를 클릭합니다.

  3. 알림 정책 만들기 페이지의 새 조건 단계에서 알림 정책 조건을 구성합니다.

  4. (선택사항) 다중 조건 알림 정책을 만들려면 다음을 수행합니다.

    1. 추가 조건마다 조건 추가를 클릭한 다음 해당 조건을 구성합니다.
    2. 모든 조건을 추가한 후 다중 조건 트리거 단계에서 이러한 조건을 조합하는 방법을 선택합니다. 자세한 내용은 여러 조건이 포함된 정책을 참조하세요.
  5. (선택사항) 알림 정책의 조건이 충족될 때 알림을 받으려면 알림 및 이름 단계에서 알림 채널 사용을 사용 설정한 후 다음을 수행해야 합니다.

    1. 알림 채널 텍스트를 클릭하여 메뉴를 활성화합니다. 이 메뉴에서 하나 이상의 알림 채널을 선택합니다.

      추가하려는 알림 채널이 나열되어 있지 않으면 주문형 채널 만들기를 참조하세요.

      알림 채널 선택에 대한 자세한 내용은 알림 옵션을 참조하세요.

    2. 이슈가 해결되었을 때 알림을 받으려면 이슈 종료 시 알림을 선택합니다.

      기본적으로 Google Cloud Console로 알림 정책을 만들면 이슈가 생성될 때만 알림이 전송됩니다.

    정책을 수정하여 알림 정책의 알림 채널을 변경할 수 있습니다.

  6. (선택사항) 이슈 자동 종료 기간 필드가 표시되면 관측이 도착하지 않을 때 이슈를 닫기 전 Monitoring이 기다려야 하는 기간으로 이 필드 값을 설정합니다. 이 필드의 기본값은 7일입니다.

    예를 들어 가상 머신(VM)을 모니터링하는 측정항목 기준 조건을 포함하는 알림이 있는 경우입니다. 이슈가 개설되었을 때 VM을 해제하면 기본적으로 이슈를 닫기 전 Monitoring이 7일 간 기다립니다.

  7. (선택사항) 커스텀 문서에 알림을 포함하려면 알림 및 이름 단계의 문서 섹션에 해당 콘텐츠를 추가합니다.

    마크다운을 사용하여 문서 형식을 지정할 수 있습니다. 변수를 사용하면 정책 자체에서 정보를 가져와 문서 콘텐츠를 맞춤설정할 수 있습니다. 예를 들어 문서에는 Addressing High CPU Usage와 같은 제목과 프로젝트를 식별하는 세부정보가 포함될 수 있습니다.

    ## Addressing High CPU Usage
    
    This note contains information about high CPU Usage.
    
    You can include variables in the documentation. For example:
    
    This alert originated from the project ${project}, using
    the variable $${project}.
    

    알림이 생성되면 Monitoring이 변수를 해당 값으로 바꿉니다. 이 값은 알림의 변수만 바꿉니다. 미리보기 창과 Cloud Console의 다른 위치에서만 마크다운 형식을 표시합니다.

    마크다운을 사용하여 문서화 메모를 작성한 예입니다.

    마크다운 및 변수에 대한 자세한 내용은 문서 템플릿에서 마크다운 및 변수 사용을 참조하세요.

    알림 제어를 위해 채널 특정 태그 지정을 포함하는 방법은 채널 제어 사용을 참조하세요.

    해당 정책을 수정하여 알림 정책에 대해 문서를 변경할 수 있습니다.

  8. (선택사항) 알림 정책의 이름을 새 알림에서 의미를 지닌 이름으로 변경하려면 알림 및 이름 단계로 이동하여 정책 이름을 업데이트합니다.

  9. 만들기를 클릭합니다.

조건 구성

이 섹션에서는 미리보기 인터페이스를 사용하여 조건을 구성하는 방법을 설명합니다. 레거시 인터페이스를 사용하는 경우 조건 지정을 참조하세요.

조건을 구성하려면 다음을 수행합니다.

  1. 모니터링할 시계열을 지정할 방법을 선택합니다.

    • 기본 모드

      특정 리소스의 측정항목을 모니터링하는 조건을 구성하되 MQL을 사용하지 않으려면 기본 모드를 사용합니다.

      기본 모드를 선택하면 선택 항목을 MQL로 변환하거나 직접 필터 모드를 사용할 수 있습니다.

    • MQL 모드

      MQL을 사용하여 조건을 설명하거나 측정항목 비율을 모니터링하려면 MQL 모드를 사용합니다.

      MQL 모드를 사용하는 경우 쿼리를 기본 모드 또는 직접 필터 모드로 변환할 수 없습니다.

    • 직접 필터 모드

      다음 항목을 모니터링하려면 직접 필터 모드를 사용합니다.

      • 서비스 수준 목표(SLO)
      • 가상 머신(VM)에서 실행되는 프로세스 수
      • 아직 데이터가 없는 커스텀 측정항목

      직접 필터 모드를 사용하는 경우 쿼리를 기본 모드 도는 MQL 쿼리로 변경할 수 없습니다.

  2. (선택사항) 기본 모드 또는 직접 필터 모드를 사용하는 경우 데이터 변환 필드를 사용하여 선택한 시계열을 처리 및 조합하는 방법을 지정합니다.

  3. 조건 트리거를 구성합니다.

기본 모드

기본 모드를 사용하여 모니터링할 시계열을 선택하려면 다음 안내를 따르세요.

  1. 알림 정책 만들기 페이지에서 측정항목 선택을 클릭하고, 리소스로 이동한 후 메뉴를 탐색합니다. 측정항목을 선택한 후 적용을 클릭합니다.

    특정 문자열이 포함된 측정항목으로 메뉴를 제한하려면 필터 막대에 해당 문자열을 입력합니다. 예를 들어 CPU를 입력한 경우 해당 이름에 CPU가 포함된 측정항목만 표시됩니다. 측정항목이 메뉴에 나열되었는지 확인하기 위해 대소문자를 구분하는 테스트가 수행됩니다.

    선택한 측정항목 또는 리소스를 변경하려면 측정항목 선택 메뉴를 확장한 후 재설정을 클릭하거나 메뉴를 탐색하여 다른 항목을 선택합니다.

  2. (선택사항) 차트에 표시된 일부 시계열만 모니터링하려면 필터를 추가합니다. 필터 대화상자에서 필터 필드를 사용하여 필터링할 라벨을 선택합니다. 예를 들어 리소스 그룹, 이름, 리소스 라벨, 영역, 측정항목 라벨을 기준으로 필터링할 수 있습니다.

    예를 들어 zone =~ ^us.*.a$ 필터는 정규 표현식을 사용하여 해당 영역 이름이 us로 시작하고 a로 끝나는 모든 시계열 데이터를 찾습니다. 자세한 내용은 선택한 데이터 필터링을 참조하세요.

항목을 선택한 후 도구 모음에서 MQL을 클릭하면 쿼리 편집기가 열리고 선택 항목이 포함된 쿼리가 표시됩니다. 기존 쿼리를 수정하고 기본 모드로 돌아가면 수정 사항이 삭제됩니다.

MQL 모드

MQL을 사용하여 조건을 구성하려면 다음을 수행합니다.

  1. 커스텀 알림 만들기의 도구 모음에서 MQL을 클릭한 후 조건에 대한 쿼리를 입력합니다.

    쿼리가 다음 연산 중 하나로 끝나야 합니다.

    자세한 내용은 MQL을 사용한 알림 정책을 참조하세요.

  2. 다음을 클릭하고 조건 트리거를 구성합니다.

기본 모드로 돌아가려면 커스텀 알림 만들기 페이지에서 기본 쿼리를 클릭합니다.

쿼리를 만들거나 기존 쿼리를 수정하고 기본 모드로 돌아가면 수정 사항이 삭제됩니다.

직접 필터 모드

직접 필터 모드를 사용하여 모니터링할 시계열을 선택하려면 다음 안내를 따르세요.

  1. ? (측정항목 선택 섹션 헤더)를 클릭한 후 도움말에서 직접 필터 모드를 선택합니다.

  2. 모니터링 필터를 입력합니다.

    예를 들어 이름에 nginx가 포함된 Compute Engine VM 인스턴스에서 실행되는 프로세스 수를 집계하려면 다음과 같이 입력합니다.

    select_process_count("monitoring.regex.full_match(\".*nginx.*\")")
    resource.type="gce_instance"
    

    구문 정보는 다음 리소스를 참조하세요.

기본 모드로 돌아가려면 ? (측정항목 선택 섹션 헤더)를 클릭한 후 기본 모드를 선택합니다.

기본 모드를 사용하여 선택한 후 직접 필터 모드로 전환하면 모니터링 필터를 확인할 수 있습니다. 모니터링 필터를 수정하지 않은 경우 기본 모드로 돌아갈 수 있습니다. 모니터링 필터를 만들거나 수정한 후 기본 모드로 돌아가면 변경사항이 보존되지 않을 수 있습니다.

모니터링할 시계열을 선택하기 위해 직접 필터 모드를 사용한 후 MQL 모드로 전환하면 변경사항이 보존되지 않습니다.

데이터 변환

이 섹션은 기본 모드 및 직접 필터 모드에만 적용됩니다. MQL 모드에는 적용되지 않습니다.

각 시계열의 정렬 방식과 시계열 결합 방식을 구성하려면 다음 안내를 따르세요.

  1. (선택사항) 시계열의 지점을 고정된 시간 간격으로 정렬하는 방식을 변경하려면 데이터 변환 섹션에서 순환 기간순환 기간 함수를 설정합니다.

    이 필드에서는 일정 기간에 기록된 지점을 결합하는 방식을 지정합니다. 예를 들어 기간이 15분이고 기간 함수가 max인 경우 정렬된 지점은 최근 15분 동안 기록된 모든 샘플의 최댓값입니다.

    자세한 내용은 시계열 정렬을 참조하세요.

  2. (선택사항) 시계열을 하나로 조합하려면 시계열 간 섹션에서 더보기를 클릭한 후 대화상자를 완료합니다. 기본적으로 시계열은 조합되지 않습니다.

    단일 시계열을 만들려면 다음을 수행합니다.

    1. 시계열 집계 필드를 none 이외의 값으로 설정합니다. 예를 들어 mean을 선택하면 표시된 시계열의 각 지점이 개별 시계열의 지점 평균입니다.

    2. 시계열 그룹화 기준 필드가 비어 있는지 확인합니다.

    시계열을 그룹화하려면 다음 안내를 따르세요.

    1. 시계열 집계 필드를 none 이외의 값으로 설정합니다.

      예를 들어 시계열을 zone으로 그룹화한 후 집계 필드를 mean으로 설정하면 영역마다 시계열이 하나씩 존재합니다.

    2. 시계열 그룹화 기준 필드에서 그룹화할 라벨을 하나 이상 선택합니다.

    이전 단계를 완료한 후 표시된 여러 시계열을 단일 시계열로 결합하려면 보조 데이터 변환 필드를 사용합니다.

    자세한 내용은 시계열 조합을 참조하세요.

조건 트리거

조건이 충족되는 시기를 구성하려면 알림 트리거 구성 페이지로 이동한 후 다음 안내를 따르세요.

  1. 조건 유형 필드가 표시되면 조건 유형을 선택합니다.

    • 측정항목 데이터의 도착이 중지될 때 알림을 받으려면 측정항목 부재를 선택합니다.

    • 측정항목의 값에 따라 알림을 표시하려면 기준을 선택합니다.

  2. 조건이 충족될 때 개별 시계열이 참여하는 방식을 지정하려면 알림 트리거 메뉴에서 값을 선택합니다. 이 메뉴를 통해 충족해야 할 조건의 트리거를 만족시켜야 하는 시계열의 하위 집합을 지정할 수 있습니다.

  3. 조건별 필드를 완료합니다.

    • 측정항목 부재 조건

      다음 시간 동안 데이터가 없으면 트리거 필드를 사용하여 측정항목 데이터가 수신되지 않고 있음을 알리기 전에 알림 정책에서 대기해야 하는 시간을 입력합니다.

    • 기준 조건

      기준 위치, 기준 값, 시간이 다음 기준 초과 필드를 사용해 측정항목 값이 조건 기준을 충족하는 방식을 입력합니다. 예를 들어 이 값을 기준 초과, 0.3, 5 minutes로 설정하면 5분 간격의 모든 샘플이 0.3 이상이어야 시계열이 조건을 충족합니다.

      재테스트 범위를 사용하여 알림이 이슈를 생성하기 전 측정이 조건 기준을 충족해야 하는 기간을 입력합니다. 최근 값을 선택한 경우 단일 측정으로 알림이 발생할 수 있습니다. 개념 정보 및 예시는 정렬 간격 및 기간을 참조하세요.

알림 정책의 JSON

알림 정책의 JSON 표현을 보거나 다운로드하려면 다음을 수행합니다.

  1. Cloud Console에서 Monitoring을 선택합니다.

    Monitoring으로 이동

  2. 알림을 선택하고 확인할 정책을 찾은 후 정책 세부정보 페이지를 엽니다.

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

    • JSON을 로컬 시스템에 다운로드하려면 JSON을 클릭합니다.

    • JSON을 보려면 미리보기 인터페이스를 사용하는지 확인하고, 수정을 클릭한 후 코드 보기를 클릭합니다.

      코드 보기가 표시되지 않으면 기존 인터페이스를 사용 중이거나 옵션 더보기에 옵션이 숨겨져 있는 것입니다.

대시보드에 알림 정책 추가

알림 정책에 하나의 조건이 포함된 경우 커스텀 대시보드에서 해당 알림 정책의 요약을 표시할 수 있습니다. 요약에는 알림 정책으로 모니터링되는 시계열, 기준, 미해결 이슈 수가 포함됩니다.

커스텀 대시보드에 알림 정책의 요약을 표시하려면 다음을 수행합니다.

  1. Cloud Console에서 Monitoring을 선택합니다.

    Monitoring으로 이동

  2. 대시보드를 선택하고 수정하려는 커스텀 대시보드를 엽니다.

  3. 수정이 표시되지 않으면 보기를 클릭한 후 수정 모드로 전환을 선택합니다.

  4. 위젯 라이브러리에서 알림 차트를 선택하거나 차트 추가를 클릭한 후 메뉴에서 알림 차트를 선택합니다.

  5. 알림 차트의 구성 창에서 알림 정책 메뉴를 사용하여 알림 정책을 선택합니다. 단일 조건 알림 정책만 알림 정책 메뉴에서 선택할 수 있습니다.

다음 스크린샷은 알림 차트를 보여줍니다.

알림 차트의 예시

이 예시에서 알림 정책은 두 가지 서로 다른 가상 머신의 CPU 사용을 모니터링합니다. 빨간색 점선은 50%로 설정된 조건 기준을 나타냅니다. No incidents 라벨이 있는 녹색 칩은 알림 정책에 대해 미해결된 이슈가 없음을 나타냅니다. 미해결 이슈 수를 보여주는 칩에 포인터를 놓으면 기본 알림 정책으로 연결되는 대화상자가 열립니다.

자세한 내용은 대시보드 및 차트 사용을 참조하세요.

정책 관리

모든 알림 정책을 나열하려면 다음 절차를 따르세요.

  1. Cloud Console에서 Monitoring을 선택합니다.

    Monitoring으로 이동

  2. 알림을 선택합니다.

  3. 정책 목록 일부가 정책 창에 표시됩니다. 모든 정책을 보고 필터링을 사용 설정하려면 모든 정책 보기를 클릭합니다.

알림 정책의 세부정보를 보려면 알림 이름을 클릭합니다.

나열된 알림 정책을 제한하려면 필터를 추가합니다. 각 필터는 이름과 값으로 구성됩니다. 이 값을 정책 이름과 정확히 일치하거나 부분적으로 일치하도록 설정할 수 있습니다. 필터에서는 대소문자를 구분하는 비교를 수행하지 않습니다. 필터가 여러 개인 경우 OR 필터를 삽입하지 않는 한 논리적 AND가 필터를 조인합니다. 다음 스크린샷은 test 또는 My Uptime Check Alert Policy와 일치하는 모든 알림 정책을 보여줍니다.

필터가 포함된 샘플 알림 개요

정책 페이지에서 알림 정책을 수정, 삭제, 복사, 사용 설정 또는 사용 중지할 수 있습니다.

  • 정책을 수정하거나 복사하려면 옵션 더보기 를 클릭하고 해당 옵션을 선택합니다. 정책 수정 및 복사는 알림 정책 만들기와 비슷합니다. 필드의 값을 변경하고 일부 경우에 값을 삭제할 수 있습니다. 완료되면 저장을 클릭합니다.

  • 정책을 삭제하려면 옵션 더보기 를 클릭하고 삭제를 선택합니다. 확인 대화상자에서 삭제를 선택합니다.

  • 사용 설정된 알림 정책 상태를 변경하려면 사용 설정됨 제목 아래 전환을 클릭합니다.

알림 정책을 선택하면 정책 세부정보가 표시됩니다. 예를 들어 다음 스크린샷은 Test staging라는 알림 정책의 세부정보를 보여줍니다.

알림 정책 세부정보 페이지 샘플

알림 섹션에는 이슈가 마감되었을 때 알림을 표시하도록 정책을 구성했는지 여부가 나열됩니다. 이슈가 개설되었을 때는 항상 알림이 표시됩니다. 알림 동작을 변경하려면 알림 정책을 수정합니다.

정책 세부정보 페이지에서 알림 정책을 수정, 삭제, 복사, 사용 설정 또는 사용 중지할 수 있습니다. 예를 들어 사용 설정된 알림 정책을 사용 중지하려면 사용 설정됨을 클릭하고 사용 중지를 선택합니다. 마찬가지로 사용 중지된 정책을 사용 설정하려면 사용 중지됨을 클릭합니다.