이 페이지는 Cloud Translation API를 통해 번역되었습니다.

알림 채널 만들기 및 관리

이 문서에서는 Google Cloud 콘솔을 사용하여 알림 채널을 구성하는 방법을 설명합니다. Cloud Monitoring은 이러한 채널을 사용하여 알림 정책이 실행되면 사용자 또는 긴급 대기팀에 알려줍니다. 알림 정책을 만들 때 구성된 알림 채널 목록에서 알림을 받을 사용자를 선택합니다. 예를 들어 Compute Engine 인스턴스를 모니터링하여 Pub/Sub 주제를 게시하고 긴급 대기팀을 위해 Slack 채널에 알림을 보내는 알림 정책을 구성할 수 있습니다.

자세한 내용은 알림 지연 시간 및 이슈별 알림을 참고하세요.

이 문서에서는 Google Cloud 콘솔을 사용하는 방법을 설명합니다. Cloud Monitoring API를 사용하는 경우 API를 통해 알림 채널 만들기 및 관리를 참고하세요.

시작하기 전에

Google Cloud 콘솔을 사용하여 알림 채널을 보고 구성하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대해 Monitoring 편집자(roles/monitoring.editor) IAM 역할을 부여해달라고 요청합니다. 역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

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

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

알림 채널 만들기

알림 정책을 만들 때는 구성된 알림 채널을 선택하고 이를 정책에 추가할 수 있습니다. 알림 채널을 사전 구성하거나 알림 정책을 만드는 동안 구성할 수 있습니다. 자세한 내용은 주문형 채널 만들기를 참조하세요.

Google Cloud 콘솔을 사용하여 알림 채널을 만들려면 다음 표에 포함된 채널별 안내를 따르세요.

이메일

이메일 알림 채널을 추가하려면 다음 안내를 따르세요.

Google Cloud 콘솔에서 알림 페이지로 이동합니다.
알림으로 이동

검색창을 사용하여 이 페이지를 찾은 경우 부제목이 Monitoring인 결과를 선택합니다.
알림 채널 수정을 클릭합니다.
이메일 섹션에서 새로 추가를 클릭합니다.
단일 이메일 주소와 설명을 입력합니다.
저장을 클릭합니다.

그룹 이메일 주소를 알림 정책의 알림 채널로 사용하는 경우 alerting-noreply@google.com의 메일을 수락하도록 그룹을 구성합니다.

알림 정책을 만드는 동안 이메일 채널을 만들 수 있습니다. 자세한 내용은 주문형 채널 만들기를 참조하세요.

모바일 앱

Google Cloud 콘솔 모바일 앱을 사용하여 어디서나 Google Cloud 콘솔 리소스 및 모니터링 정보를 모니터링합니다. Google Cloud 콘솔 모바일 앱 알림은 특정 기기 또는 특정 사용자에게 전송됩니다.

Google Cloud 콘솔 모바일 앱 알림 채널 목록

기기는 알림 채널을 만든 특정 기기로만 알림이 전송됨을 나타냅니다. 기기 범위의 알림 채널의 경우 표시 이름 필드에 기기 정보가 포함됩니다.
사용자는 Google Cloud 콘솔 모바일 앱이 설치된 모든 기기로 알림이 전송되었음을 나타냅니다.

Cloud Monitoring에서 채널을 만들 때 알림 범위를 결정합니다. 범위를 직접 선택하거나 변경할 수는 없습니다.

특정 Google Cloud 프로젝트에 대해 Google Cloud 콘솔 모바일 앱 알림 채널을 구성하려면 다음을 수행합니다.

휴대기기의 앱 스토어에서 Google Cloud 콘솔 모바일 앱을 설치하세요.
Google Cloud 콘솔 모바일 앱에서 볼 프로젝트를 선택합니다.

프로젝트를 선택하면 앱과 선택한 Google Cloud 프로젝트 간에 데이터 교환이 발생합니다. 존재하지 않으면 알림 채널이 생성되며 몇 분 후 알림 채널 페이지의 휴대기기 섹션에 이 채널이 나열됩니다.

알림 정책에 휴대기기를 알림 채널로 추가하려면 알림 알림 섹션에서 Google Cloud 콘솔 (모바일)을 선택한 다음 목록에서 휴대기기를 선택합니다.

PagerDuty

PagerDuty는 Monitoring과의 양방향 동기화를 지원합니다. 따라서 다음 사항이 적용됩니다.

Monitoring에서 이슈가 생성되면 PagerDuty에서 이슈가 열립니다.
Monitoring에서 PagerDuty를 사용하여 이슈를 종료할 수 없습니다.
PagerDuty에서 이슈를 해결하고 Monitoring에서 이슈가 열린 경우에는 이슈가 PagerDuty에서 다시 열립니다.

PagerDuty 알림을 설정하려면 다음 절차를 따르세요.

PagerDuty 계정에서 새 서비스에서 통합을 구성하거나 기존 서비스에 통합을 추가합니다.
1. 계정을 만들거나 기존 계정에 로그인합니다.
2. 서비스 페이지로 이동합니다.
3. 서비스의 통합 패널에서 새 통합의 등록정보를 찾아 메뉴를 펼친 다음 통합 키를 복사합니다.
4. 선택사항: Monitoring의 이슈 심각도 값을 정확하게 매핑하도록 PagerDuty를 구성합니다.
Cloud Monitoring에서 PagerDuty 알림 채널을 추가합니다.
1. Google Cloud 콘솔에서 알림 페이지로 이동합니다.
  알림으로 이동
  
  검색창을 사용하여 이 페이지를 찾은 경우 부제목이 Monitoring인 결과를 선택합니다.
2. 알림 채널 수정을 클릭합니다.
3. PagerDuty 섹션에서 새로 추가를 클릭합니다.
4. 표시 이름을 입력합니다. 이 이름은 1단계에서 새 통합을 구성한 PagerDuty 서비스의 이름과 일치해야 합니다.
5. 1단계에서 복사한 통합 키를 서비스 키 필드에 붙여넣습니다.
6. 저장을 클릭합니다.

알림 정책을 만들 때 PagerDuty 섹션에서 PagerDuty를 선택하고 PagerDuty 구성을 선택합니다.

PagerDuty의 JSON 패킷 형식은 다음과 같습니다.

 {
     "description": A string of various fields in the incident,
     "details": JSON payload with schema version 1.2.
 }

예시 및 details 필드 스키마를 보려면 다음 섹션을 확장합니다.

JSON 예시

기본적으로 알림 백엔드는 버전 1.2 형식 지정으로 JSON 패킷을 생성하려고 시도합니다. 이 형식에 대한 자세한 내용은 다음 섹션을 참조하세요.

다음은 이러한 패킷의 예시입니다.


{
  "incident": {
    "incident_id": "0.opqiw61fsv7p",
    "scoping_project_id": "internal-project",
    "scoping_project_number": 12345,
    "url": "https://console.cloud.google.com/monitoring/alerting/incidents/0.lxfiw61fsv7p?project=internal-project",
    "severity": "no severity",
    "started_at": 1577840461,
    "ended_at": 1577877071,
    "state": "closed",
    "resource_id": "11223344",
    "resource_name": "internal-project gke-cluster-1-default-pool-e2df4cbd-dgp3",
    "resource_display_name": "gke-cluster-1-default-pool-e2df4cbd-dgp3",
    "resource_type_display_name": "VM Instance",
    "resource": {
      "type": "gce_instance",
      "labels": {
        "instance_id": "11223344",
        "project_id": "internal-project",
        "zone": "us-central1-c"
      }
    },
    "metric": {
      "type": "compute.googleapis.com/instance/cpu/utilization",
      "displayName": "CPU utilization",
      "labels": {
        "instance_name": "the name of the VM instance"
      }
    },
    "metadata": {
      "system_labels": { "labelkey": "labelvalue" },
      "user_labels": { "labelkey": "labelvalue" }
    },
    "policy_name": "Monitor-Project-Cluster",
    "policy_user_labels" : {
        "user-label-1" : "important label",
        "user-label-2" : "another label"
    },
    "condition_name": "VM Instance - CPU utilization [MAX]",
    "threshold_value": "0.9",
    "observed_value": "0.835",
    "condition": {
      "name": "projects/internal-project/alertPolicies/1234567890123456789/conditions/1234567890123456789",
      "displayName": "VM Instance - CPU utilization [MAX]",
      "conditionThreshold": {
        "filter": "metric.type=\"compute.googleapis.com/instance/cpu/utilization\" resource.type=\"gce_instance\" metadata.system_labels.\"state\"=\"ACTIVE\"",
        "aggregations": [
          {
            "alignmentPeriod": "120s",
            "perSeriesAligner": "ALIGN_MEAN"
          }
        ],
        "comparison": "COMPARISON_GT",
        "thresholdValue": 0.9,
        "duration": "0s",
        "trigger": {
          "count": 1
        }
      }
    },
    "documentation": {
      "content": "TEST ALERT\n\npolicy.name=projects/internal-project/alertPolicies/1234567890123456789\n\npolicy.display_name=Monitored-Project-NO-GROUPBY\n\ncondition.name=projects/nternal-project/alertPolicies/1234567890123456789/conditions/1234567890123456789\n\ncondition.display_name=VM Instance - CPU utilization [MAX]\n\nproject=internal-project\n\nresrouce.project=internal-project \n\nDONE\n",
      "mime_type": "text/markdown",
      "subject": "ALERT - No severity",
      "links": [
        {
          "displayName": "Playbook",
          "url": "https://myownpersonaldomain.com/playbook?name=${resource.name}"
        }
      ]
    },
    "summary": "CPU utilization for internal-project gke-cluster-1-16-default-pool-e2df4cbd-dgp3 with metric labels {instance_name=gke-cluster-1-default-pool-e2df4cbd-dgp3} and system labels {state=ACTIVE} returned to normal with a value of 0.835."
  },
  "version": "1.2"
}

스키마 구조, 버전 1.2

이 섹션에서는 페이로드 스키마 버전 1.2를 설명합니다. 일부 필드는 반환된 모든 패킷에 표시되지 않거나 빈 값이 표시될 수 있습니다. 이는 알림 정책 구성, 이슈 상태 또는 모니터링되는 리소스에 따라 다릅니다. 일부 필드는 삽입된 구조를 값으로 사용합니다. 이러한 구조는 컨텐츠가 다를 수 있으므로 참조로 설명됩니다.

반환된 패킷에서 필드는 모든 순서로 발생할 수 있습니다. 다음 설명에서는 관련 그룹으로 구성됩니다.

{
  "version": "1.2",
  "incident": {

    이슈에 관한 정보입니다.

    "incident_id": 문자열이며, 이 이슈에 대해 생성된 ID입니다.
    "scoping_project_id": 문자열이며, 측정항목 범위를 호스팅하는 프로젝트 ID입니다.
    "scoping_project_number": 숫자이며, 범위 지정 프로젝트의 프로젝트 번호입니다.
    "url": 문자열이며, 이 이슈에 대한 Google Cloud 콘솔 URL입니다.
    "started_at": 숫자이며, 이슈가 개설된 시간(Unix epoch 초 단위)입니다.
    "ended_at": 숫자이며, 이슈가 종료된 시간(Unix epoch 초 단위)입니다. state가 closed일 때만 채워집니다.
    "state": 문자열이며, 이슈 상태입니다(open 또는 closed). open이면 ended_at이 null입니다.
    "summary": 문자열이며, 이 이슈에 대해 생성된 텍스트 요약입니다.
    "apigee_url": 문자열이며, Apigee 리소스 유형 Environment 및 Proxy*에만 해당하는 이 이슈에 대한 Apigee URL입니다.
    "observed_value": 문자열이며, 조건이 알림을 트리거/확인한 관찰된 값입니다. 조건이 만료되었으면 비어 있을 수 있습니다. 문자열인 경우 알림을 트리거하거나 해결한 관찰된 값이 비어 있을 수 있습니다.

    이슈가 개설된 모니터링 리소스에 대한 정보입니다.

    "resource": {
      "type": 문자열이며, gce_instance와 같이 알림을 제공하는 모니터링 리소스 유형의 식별자입니다. 모니터링 리소스 목록을 참조하세요.
      "labels": 객체이며, 모니터링 리소스 유형과 연관된 라벨의 키-값 쌍입니다.
    },
    "resource_type_display_name": 문자열이며, 모니터링 리소스 유형의 표시 이름입니다.
    "resource_id": 문자열이며, 모니터링 리소스의 인스턴스 ID입니다. resource.labels.instance_id와 동일한 값입니다.
    "resource_display_name": 문자열이며, 모니터링 리소스의 표시 이름입니다.
    "resource_name": 문자열이며, 이 모니터링 리소스의 생성된 이름입니다. 다른 필드의 값으로 구성됩니다.

    시계열 데이터의 측정항목 유형에 대한 정보입니다.

    "metric": {
      "type": 문자열이며, compute.googleapis.com/instance/cpu/utilization와 같이 알림을 받는 측정항목 유형의 식별자입니다. 측정항목 목록을 참조하세요.
      "displayName": 문자열이며, 측정항목 유형의 표시 이름입니다.
      "labels": 객체이며, 측정항목과 연결된 라벨의 키-값 쌍입니다.
    },
    "metadata": {
      "system_labels": 객체이며, 시스템 메타데이터 라벨의 키-값 쌍입니다.
      "user_labels": 객체이며, 사용자 메타데이터 라벨의 키-값 쌍입니다.
    },

    이슈를 개설/해결한 알림 정책 및 조건에 대한 정보입니다.
    값은 관련 AlertPolicy 객체로부터 가져옵니다.

    "policy_name": 문자열이며, 알림 정책의 표시 이름입니다.
    "policy_user_labels": 객체이며, 정책에 연결된 사용자 라벨의 키-값 쌍입니다.
    "documentation": 객체이며, Documentation 형식의 포함된 구조입니다.
    "condition": 객체이며, Condition 형식의 포함된 구조입니다.
    "condition_name": 문자열이며, condition.displayName과 동일한 값인 조건의 표시 이름입니다.
    "severity": 문자열이며, 이슈의 심각도 수준입니다. 알림 정책을 만들 때 이 필드를 정의하지 않으면 Cloud Monitoring이 알림 정책 심각도를 no severity로 설정합니다.
    "threshold_value": 문자열이며, 이 조건의 기준점입니다. 조건이 기준점 조건이 아니면 비어 있을 수 있습니다.
  },
}

지원 중단 정책

페이로드 스키마는 Google Cloud Platform 서비스 약관 1.4(d)항에 설명된 Google Cloud 지원 중단 정책을 따릅니다. 스키마는 생성된 필드 값 형식을 제어하지 않으며, 이러한 형식은 예고 없이 변경될 수 있습니다. 예를 들어 incident.summary, incident.documentation.content, incident.url은 해당 필드와 관련된 데이터를 포함하지만 이러한 필드에 대해 정확한 파싱을 보장하는 제약조건은 이 스키마에 없습니다. 값을 전체적으로 사용하고 지원 중단 정책을 준수할 것으로 예상할 수 있지만 생성된 필드 파싱에 의존하면 안 됩니다.

심각도 수준을 매핑하도록 PagerDuty 구성

기본적으로 PagerDuty 알림에는 모든 문제 심각도 수준이 '심각함'으로 표시됩니다. PagerDuty 알림 심각도가 Monitoring 이슈 심각도와 일치하도록 PagerDuty에서 이벤트 조정 규칙을 구성할 수 있습니다.

PagerDuty 계정에서 서비스 페이지로 이동합니다.
Google Cloud 알림을 수신하는 PagerDuty 서비스를 선택합니다.
설정을 클릭합니다.
이벤트 관리 섹션으로 이동한 다음 조정 규칙 보기를 클릭합니다.
새 규칙을 클릭합니다.
변환하려는 각 모니터링 심각도 값에 대해 심각도 값을 상응하는 PagerDuty 값에 매핑하는 조건부 규칙을 만듭니다.
1. 1단계: 이 규칙은 언제 적용해야 하나요? 메뉴에서 이벤트가 특정 조건과 일치하는 경우를 선택합니다.
2. 코드 편집기를 선택합니다.
3. If 섹션에 event.custom_details.incident.severity matches part VALUE(VALUE은 모니터링 심각도 값의 이름)을 입력한 다음 다음을 클릭합니다.
4. 2단계: 적용할 작업에서 데이터 알림을 선택합니다.
5. 알림 심각도를 C단계에서 입력한 모니터링 값과 일치하는 값으로 설정한 다음 변경사항을 저장합니다.
선택사항: 규칙을 추가하려면 그 외 규칙을 클릭합니다.

SMS

SMS 알림을 구성하려면 다음 절차를 따르세요.

Google Cloud 콘솔에서 알림 페이지로 이동합니다.
알림으로 이동

검색창을 사용하여 이 페이지를 찾은 경우 부제목이 Monitoring인 결과를 선택합니다.
알림 채널 수정을 클릭합니다.
SMS 섹션에서 새로 추가를 클릭합니다.
대화상자를 완료하고 저장을 클릭합니다.

알림 정책을 설정할 때 SMS 알림 유형을 선택하고 목록에서 확인된 전화번호를 선택합니다.

Slack

Monitoring Slack 통합을 사용하면 새 이슈가 생성되었을 때 알림 정책에서 Slack 채널에 새 이슈를 게시할 수 있습니다. Slack 알림을 설정하려면 다음 절차를 따르세요.

Slack 내: Slack 사이트에서 Slack 작업공간 및 채널을 만듭니다. 채널 URL을 기록합니다.
Google Cloud 콘솔에서 알림 페이지로 이동합니다.
알림으로 이동

검색창을 사용하여 이 페이지를 찾은 경우 부제목이 Monitoring인 결과를 선택합니다.
알림 채널 수정을 클릭합니다.
Slack 섹션에서 새로 추가를 클릭하여 Slack 로그인 페이지를 엽니다.
1. Slack 작업공간을 선택합니다.
2. 허용을 클릭하여 Slack 작업공간에 대한 Cloud Monitoring 액세스를 사용 설정합니다. 이렇게 하면 알림 채널의 Monitoring 구성 페이지로 돌아갑니다.
3. Slack 채널 이름 필드에 알림에 사용할 Slack 채널의 이름을 입력합니다.
4. Cloud Alerting 표시 이름 필드에 설명이 포함된 짧은 문구를 입력합니다. Monitoring에서 이 필드의 값을 알림 채널 페이지에 표시합니다.
5. (선택사항) Cloud Monitoring과 Slack 작업공간 간의 연결을 테스트하려면 테스트 알림 보내기를 클릭합니다. 연결에 성공하면 지정한 Slack 알림 채널에 This is a test alert notification... 메시지가 표시됩니다. 수신을 확인하려면 알림 채널을 확인하세요.
알림에 사용하려는 Slack 채널이 비공개 채널인 경우 수동으로 Monitoring 앱을 채널에 초대해야 합니다.
1. Slack을 엽니다.
2. Monitoring 알림 채널로 지정한 채널로 이동합니다.
3. 채널에 다음 메시지를 입력하고 전송하여 Monitoring 앱을 채널에 초대합니다.
```
/invite @Google Cloud Monitoring
```
  Monitoring에서 알림 채널을 만들 때 지정한 비공개 채널에 Monitoring 앱을 초대해야 합니다. Monitoring 앱을 공개 채널에 초대하는 것은 선택사항입니다.
알림 정책을 만들 때 알림 섹션에서 Slack을 선택하고 Slack 구성을 선택합니다.

웹훅

Webhook 알림 채널을 구성하기 전에 다음 사항을 고려하세요.

웹훅은 공개 엔드포인트만 지원합니다. 공개가 아닌 엔드포인트로 전송되는 알림이 필요하면 Pub/Sub 알림 채널을 만들고 Pub/Sub 주제에 대해 구독을 구성합니다. 자세한 내용은 비공개 엔드포인트용으로 구성되었을 때 웹훅 알림 실패를 참고하세요.
Cloud Run 함수가 알림 채널의 웹훅 엔드포인트로 구성된 경우 함수를 호출하는 사용자에게 필요한 인증 권한이 있는지 확인하세요. 자세한 내용은 호출 인증 및 함수에 대한 액세스 사용 설정을 참고하세요.
웹훅 알림 채널은 Microsoft Teams와 호환되지 않습니다. 모니터링에서 Microsoft Teams로 알림 데이터를 전송하려면 모니터링 웹훅을 수신하는 통합 레이어를 만든 다음 Microsoft Teams로 다시 라우트합니다.

웹훅 알림 채널 구성

웹훅 알림을 구성하려면 다음 절차를 따르세요.

웹훅 핸들러: Monitoring에서 웹훅 데이터를 수신할 공개 엔드포인트 URL을 식별합니다.
Google Cloud 콘솔에서 알림 페이지로 이동합니다.
알림으로 이동

검색창을 사용하여 이 페이지를 찾은 경우 부제목이 Monitoring인 결과를 선택합니다.
알림 채널 수정을 클릭합니다.
웹훅 섹션에서 새로 추가를 클릭합니다.
대화상자를 완료합니다.
연결 테스트을 클릭하여 웹훅 엔드포인트로 테스트 페이로드를 보냅니다. 수신 엔드포인트로 이동하여 전송을 확인할 수 있습니다.
저장을 클릭합니다.

알림 정책을 만들 때 알림 섹션에서 웹훅을 선택하고 웹훅 구성을 선택합니다. Error Reporting에서 보낸 알림은 1.0 스키마를 따르고 Monitoring에서 보낸 알림은 1.2 스키마를 따릅니다.

JSON 예시

기본적으로 알림 백엔드는 버전 1.2 형식 지정으로 JSON 패킷을 생성하려고 시도합니다. 이 형식에 대한 자세한 내용은 다음 섹션을 참조하세요.

다음은 이러한 패킷의 예시입니다.


{
  "incident": {
    "incident_id": "0.opqiw61fsv7p",
    "scoping_project_id": "internal-project",
    "scoping_project_number": 12345,
    "url": "https://console.cloud.google.com/monitoring/alerting/incidents/0.lxfiw61fsv7p?project=internal-project",
    "severity": "no severity",
    "started_at": 1577840461,
    "ended_at": 1577877071,
    "state": "closed",
    "resource_id": "11223344",
    "resource_name": "internal-project gke-cluster-1-default-pool-e2df4cbd-dgp3",
    "resource_display_name": "gke-cluster-1-default-pool-e2df4cbd-dgp3",
    "resource_type_display_name": "VM Instance",
    "resource": {
      "type": "gce_instance",
      "labels": {
        "instance_id": "11223344",
        "project_id": "internal-project",
        "zone": "us-central1-c"
      }
    },
    "metric": {
      "type": "compute.googleapis.com/instance/cpu/utilization",
      "displayName": "CPU utilization",
      "labels": {
        "instance_name": "the name of the VM instance"
      }
    },
    "metadata": {
      "system_labels": { "labelkey": "labelvalue" },
      "user_labels": { "labelkey": "labelvalue" }
    },
    "policy_name": "Monitor-Project-Cluster",
    "policy_user_labels" : {
        "user-label-1" : "important label",
        "user-label-2" : "another label"
    },
    "condition_name": "VM Instance - CPU utilization [MAX]",
    "threshold_value": "0.9",
    "observed_value": "0.835",
    "condition": {
      "name": "projects/internal-project/alertPolicies/1234567890123456789/conditions/1234567890123456789",
      "displayName": "VM Instance - CPU utilization [MAX]",
      "conditionThreshold": {
        "filter": "metric.type=\"compute.googleapis.com/instance/cpu/utilization\" resource.type=\"gce_instance\" metadata.system_labels.\"state\"=\"ACTIVE\"",
        "aggregations": [
          {
            "alignmentPeriod": "120s",
            "perSeriesAligner": "ALIGN_MEAN"
          }
        ],
        "comparison": "COMPARISON_GT",
        "thresholdValue": 0.9,
        "duration": "0s",
        "trigger": {
          "count": 1
        }
      }
    },
    "documentation": {
      "content": "TEST ALERT\n\npolicy.name=projects/internal-project/alertPolicies/1234567890123456789\n\npolicy.display_name=Monitored-Project-NO-GROUPBY\n\ncondition.name=projects/nternal-project/alertPolicies/1234567890123456789/conditions/1234567890123456789\n\ncondition.display_name=VM Instance - CPU utilization [MAX]\n\nproject=internal-project\n\nresrouce.project=internal-project \n\nDONE\n",
      "mime_type": "text/markdown",
      "subject": "ALERT - No severity",
      "links": [
        {
          "displayName": "Playbook",
          "url": "https://myownpersonaldomain.com/playbook?name=${resource.name}"
        }
      ]
    },
    "summary": "CPU utilization for internal-project gke-cluster-1-16-default-pool-e2df4cbd-dgp3 with metric labels {instance_name=gke-cluster-1-default-pool-e2df4cbd-dgp3} and system labels {state=ACTIVE} returned to normal with a value of 0.835."
  },
  "version": "1.2"
}

스키마 구조, 버전 1.2

반환된 패킷에서 필드는 모든 순서로 발생할 수 있습니다. 다음 설명에서는 관련 그룹으로 구성됩니다.

기본 인증

Cloud Monitoring에서 보낸 웹훅 요청 외에도 기본 인증은 사용자 이름과 비밀번호에 HTTP 사양을 이용합니다. Cloud Monitoring에서 서버는 적절한 WWW-Authenticate 헤더가 있는 401 응답을 반환해야 합니다. 기본 인증에 대한 상세 정보는 아래를 참조하세요.

토큰 인증

토큰 인증을 사용하려면 엔드포인트 URL에 쿼리 문자열 매개 변수와 서버가 자체적으로 모니터링할 것으로 예상하는 키가 필요합니다. 다음은 토큰이 포함된 샘플 URL입니다.

https://www.myserver.com/stackdriver-hook?auth_token=1234-abcd

Monitoring이 엔드포인트 URL에 이슈를 게시하면 서버에서 연결된 토큰의 유효성을 검사할 수 있습니다. 이 인증 방법은 SSL/TLS와 함께 HTTP 요청을 암호화하여 스누퍼의 토큰 학습을 방지할 때 가장 효과적입니다.

Python의 서버 예는 이 샘플 서버를 참조하세요.

지원 중단 정책

Pub/Sub

이 섹션에서는 Pub/Sub 알림 채널을 구성하는 방법을 설명합니다. 중복성을 위해서는 여러 알림 채널을 만드는 것이 좋습니다. Pub/Sub에는 다른 전송 메커니즘이 사용되기 때문에 Google Cloud 콘솔 모바일 앱, PagerDuty, 웹훅, Slack과 Pub/Sub를 페어링하는 것이 좋습니다.

Pub/Sub 알림 채널을 구성하려면 다음 안내를 따르세요.

필요한 API 사용 설정 및 주제 만들기
주제의 알림 채널 구성
서비스 계정 승인
알림 정책에 알림 채널 설정

데이터 스키마를 이해하려면 스키마 예시를 참조하세요.

알림을 받으려면 pull, push, BigQuery 구독 중 하나를 만들어야 합니다.

구독이 주제와 다른 프로젝트에 있는 경우 구독자 프로젝트에 서비스 계정을 만들고 roles/pubsub.subscriber 역할을 부여합니다.

시작하기 전에

Google Cloud 프로젝트에 첫 번째 Pub/Sub 알림 채널을 추가하면 Cloud Monitoring이 해당 프로젝트의 서비스 계정을 만듭니다. 또한 서비스 계정에 Identity and Access Management 역할인 모니터링 알림 서비스 에이전트를 부여합니다. 이 서비스 계정을 사용하면 Monitoring에서 이 프로젝트의 Pub/Sub 기반 알림 채널로 알림을 보낼 수 있습니다.

서비스 계정에는 다음과 같은 형식이 있습니다.

service-PROJECT_NUMBER@gcp-sa-monitoring-notification.iam.gserviceaccount.com

알림 서비스 계정의 이름에는 고유한 Google Cloud 프로젝트 번호가 포함됩니다. Google Cloud 콘솔의 프로젝트 대시보드에서 프로젝트 이름, ID, 번호를 찾거나 다음 명령어로 검색할 수 있습니다.

gcloud projects describe PROJECT_ID --format="value(project_number)"

Google Cloud 콘솔 또는 Google Cloud CLI를 사용하여 서비스 계정을 보고 수정할 수 있습니다.

필요한 API 사용 설정 및 주제 만들기

알림 채널과 Pub/Sub 주제를 만들려는 Google Cloud 프로젝트에서 다음을 실행합니다.

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Go to project selector

Make sure that billing is enabled for your Google Cloud project.

Enable the Pub/Sub and Cloud Monitoring APIs.

Enable the APIs

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Go to project selector

Make sure that billing is enabled for your Google Cloud project.

Enable the Pub/Sub and Cloud Monitoring APIs.

Enable the APIs

Pub/Sub 주제를 만듭니다. 주제를 만드는 방법에 대한 자세한 내용은 주제 만들기를 참조하세요. 예를 들어 Google Cloud CLI를 사용하여 notificationTopic이라는 주제를 만들려면 다음 명령어를 실행합니다.
```
gcloud pubsub topics create notificationTopic
```

그런 후 Pub/Sub 알림 채널을 구성합니다.

주제의 알림 구성

Pub/Sub 알림 채널을 만들려면 Monitoring API, Google Cloud CLI 또는 Google Cloud 콘솔을 사용할 수 있습니다. 알림 채널을 만든 후 알림 채널로 사용 중인 각 주제를 게시하도록 알림 서비스 계정을 승인합니다.

Monitoring API 또는 Google Cloud CLI를 사용하여 알림 채널을 만드는 방법은 채널 만들기를 참조하세요.

Google Cloud 콘솔을 사용하여 알림 채널을 만들려면 다음을 수행합니다.

Google Cloud 콘솔에서 알림 페이지로 이동합니다.
알림으로 이동

검색창을 사용하여 이 페이지를 찾은 경우 부제목이 Monitoring인 결과를 선택합니다.
만든 Pub/Sub 주제가 포함된 Google Cloud 프로젝트를 선택합니다.
알림 채널 수정을 클릭합니다.
Pub/Sub 섹션에서 새로 추가를 클릭합니다.

생성된 Pub/Sub 채널 대화상자에 Monitoring에서 만든 서비스 계정 이름이 표시됩니다.
서비스 계정을 승인합니다. 서비스 계정은 모든 주제 또는 특정 주제를 게시할 수 있습니다.
- 모든 주제를 게시하려면 역할 관리를 선택하고 Pub/Sub 게시자 역할을 추가합니다.
  
  알림 채널을 구성하는 이 단계를 완료한 후에는 서비스 계정 승인이라는 다음 섹션을 건너뛰고 알림 정책에서 알림 채널 설정으로 진행합니다.
- 특정 주제를 게시하려면 다음 단계로 진행해서 알림 채널 구성을 완료한 후 특정 주제를 게시하도록 서비스 계정을 승인합니다. 서비스 계정을 승인하는 방법은 서비스 계정 승인을 참조하세요.
채널의 표시 이름과 Pub/Sub 주제 이름을 입력합니다.
(선택사항) 채널이 올바르게 구성되었는지 확인하려면 테스트 알림 보내기를 클릭합니다.
채널 추가를 선택합니다.

그런 후 서비스 계정을 승인합니다.

서비스 계정 승인

승인하면 알림 서비스 계정이 사용 중인 각 Pub/Sub 주제를 알림 채널로 게시할 수 있습니다. 이 섹션에서는 다음 작업의 수행 방법을 설명합니다.

특정 주제에 대한 서비스 계정을 승인합니다.
모든 주제에 대한 서비스 계정을 승인합니다.

특정 주제에 대한 서비스 계정 승인

Google Cloud 콘솔 및 Google Cloud CLI를 사용해서 특정 주제를 게시하도록 서비스 계정을 승인할 수 있습니다. 이 섹션에서는 두 가지 접근 방법을 설명합니다.

Google Cloud 콘솔을 사용해서 특정 주제에 대해 서비스 계정을 승인하려면 다음을 수행합니다.

Google Cloud 콘솔에서 주제 페이지로 이동합니다.
주제로 이동

검색창을 사용하여 이 페이지를 찾은 경우 부제목이 Pub/Sub인 결과를 선택합니다.
주제를 선택합니다.
권한 탭에서 주 구성원 추가를 선택합니다.
새 주 구성원 필드에 알림 서비스 계정의 이름을 입력합니다. 서비스 계정의 이름 지정 규칙은 다음과 같습니다.
```
service-PROJECT_NUMBER@gcp-sa-monitoring-notification.iam.gserviceaccount.com
```
Pub/Sub 게시자 역할을 선택한 후 저장을 선택합니다.

Google Cloud CLI를 사용해서 특정 주제에 대해 서비스 계정을 승인하려면 해당 주제에 대한 pubsub.publisher IAM 역할을 서비스 계정에 부여합니다. 예를 들어 다음 명령어는 notificationTopic 주제에 대한 IAM 역할을 구성합니다.

gcloud pubsub topics add-iam-policy-binding \
projects/PROJECT_NUMBER/topics/notificationTopic --role=roles/pubsub.publisher \
--member=serviceAccount:service-PROJECT_NUMBER@gcp-sa-monitoring-notification.iam.gserviceaccount.com

add-iam-policy-binding 명령어의 실행 성공에 대한 응답은 다음과 같습니다.

 Updated IAM policy for topic [notificationTopic].
 bindings:
 ‐ members:
    ‐ serviceAccount:service-PROJECT_NUMBER@gcp-sa-monitoring-notification.iam.gserviceaccount.com
    role: roles/pubsub.publisher
 etag: BwWcDOIw1Pc=
 version: 1

자세한 내용은 pubsub topics add-iam-policy-binding 참조 페이지를 참조하세요.

모든 주제에 대한 서비스 계정 승인

모든 주제에 대한 서비스 계정을 승인하려면 다음을 수행합니다.

Google Cloud 콘솔에서 IAM 페이지로 이동합니다.
IAM으로 이동합니다.

검색창을 사용하여 이 페이지를 찾은 경우 부제목이 IAM 및 관리자인 결과를 선택합니다.
다음 이미지와 같이 Google 제공 역할 부여 포함을 선택합니다.
다음 형식의 서비스 계정을 검색합니다.
```
service-PROJECT_NUMBER@gcp-sa-monitoring-notification.iam.gserviceaccount.com
```
서비스 계정이 목록에 없으면 페이지를 새로고침합니다.
알림 서비스 계정의 경우 수정을 선택하고, 다른 역할 추가를 선택한 다음, Pub/Sub 게시자 역할을 선택합니다.

그런 후 알림 정책에 알림 채널을 설정합니다.

알림 정책에 알림 채널 설정

알림 정책에 Pub/Sub 알림 채널을 사용하려면 채널 유형으로 Pub/Sub를 선택한 후 주제를 선택합니다.

스키마 예

예시 JSON 패킷과 스키마를 보려면 다음 섹션을 확장합니다.

JSON 예시

기본적으로 알림 백엔드는 버전 1.2 형식 지정으로 JSON 패킷을 생성하려고 시도합니다. 이 형식에 대한 자세한 내용은 다음 섹션을 참조하세요.

다음은 이러한 패킷의 예시입니다.


{
  "incident": {
    "incident_id": "0.opqiw61fsv7p",
    "scoping_project_id": "internal-project",
    "scoping_project_number": 12345,
    "url": "https://console.cloud.google.com/monitoring/alerting/incidents/0.lxfiw61fsv7p?project=internal-project",
    "severity": "no severity",
    "started_at": 1577840461,
    "ended_at": 1577877071,
    "state": "closed",
    "resource_id": "11223344",
    "resource_name": "internal-project gke-cluster-1-default-pool-e2df4cbd-dgp3",
    "resource_display_name": "gke-cluster-1-default-pool-e2df4cbd-dgp3",
    "resource_type_display_name": "VM Instance",
    "resource": {
      "type": "gce_instance",
      "labels": {
        "instance_id": "11223344",
        "project_id": "internal-project",
        "zone": "us-central1-c"
      }
    },
    "metric": {
      "type": "compute.googleapis.com/instance/cpu/utilization",
      "displayName": "CPU utilization",
      "labels": {
        "instance_name": "the name of the VM instance"
      }
    },
    "metadata": {
      "system_labels": { "labelkey": "labelvalue" },
      "user_labels": { "labelkey": "labelvalue" }
    },
    "policy_name": "Monitor-Project-Cluster",
    "policy_user_labels" : {
        "user-label-1" : "important label",
        "user-label-2" : "another label"
    },
    "condition_name": "VM Instance - CPU utilization [MAX]",
    "threshold_value": "0.9",
    "observed_value": "0.835",
    "condition": {
      "name": "projects/internal-project/alertPolicies/1234567890123456789/conditions/1234567890123456789",
      "displayName": "VM Instance - CPU utilization [MAX]",
      "conditionThreshold": {
        "filter": "metric.type=\"compute.googleapis.com/instance/cpu/utilization\" resource.type=\"gce_instance\" metadata.system_labels.\"state\"=\"ACTIVE\"",
        "aggregations": [
          {
            "alignmentPeriod": "120s",
            "perSeriesAligner": "ALIGN_MEAN"
          }
        ],
        "comparison": "COMPARISON_GT",
        "thresholdValue": 0.9,
        "duration": "0s",
        "trigger": {
          "count": 1
        }
      }
    },
    "documentation": {
      "content": "TEST ALERT\n\npolicy.name=projects/internal-project/alertPolicies/1234567890123456789\n\npolicy.display_name=Monitored-Project-NO-GROUPBY\n\ncondition.name=projects/nternal-project/alertPolicies/1234567890123456789/conditions/1234567890123456789\n\ncondition.display_name=VM Instance - CPU utilization [MAX]\n\nproject=internal-project\n\nresrouce.project=internal-project \n\nDONE\n",
      "mime_type": "text/markdown",
      "subject": "ALERT - No severity",
      "links": [
        {
          "displayName": "Playbook",
          "url": "https://myownpersonaldomain.com/playbook?name=${resource.name}"
        }
      ]
    },
    "summary": "CPU utilization for internal-project gke-cluster-1-16-default-pool-e2df4cbd-dgp3 with metric labels {instance_name=gke-cluster-1-default-pool-e2df4cbd-dgp3} and system labels {state=ACTIVE} returned to normal with a value of 0.835."
  },
  "version": "1.2"
}

스키마 구조, 버전 1.2

반환된 패킷에서 필드는 모든 순서로 발생할 수 있습니다. 다음 설명에서는 관련 그룹으로 구성됩니다.

지원 중단 정책

Google Chat

Google Cloud Monitoring 앱을 사용하면 Google Chat 스페이스에서 알림을 수신할 수 있습니다.

시작하기 전에

조직 사용자가 Google Cloud Monitoring 앱을 설치하려면 Google Cloud Monitoring 앱에 액세스할 수 있어야 합니다. 액세스 권한이 없으면 Google Workspace 관리자에게 다음을 수행하도록 요청하세요.

Google Cloud Monitoring 앱 설치

Google Cloud Monitoring 앱을 설치하려면 다음 절차를 따라야 합니다. Google Workspace Marketplace 등록정보에서 설치하는 것은 지원되지 않습니다.

앱을 설치하고 스페이스를 알림 채널로 구성하려면 다음을 수행합니다.

Google Chat에서 알림을 받을 스페이스를 열거나 만듭니다.
Google Cloud Monitoring 앱 설치
1. 스페이스 이름을 선택한 다음 앱 및 통합을 선택합니다.
2. Google Cloud Monitoring 앱이 앱 목록에 표시되지 않으면 스페이스로 돌아가서 @Google Cloud Monitoring을 입력한 다음 Enter 키를 누릅니다.
3. 스페이스에 추가를 클릭합니다.
Chat 스페이스 ID를 클립보드에 복사합니다.

Google Cloud Monitoring 앱을 설치한 경우 Chat 스페이스 ID가 설치 확인에 포함됩니다. 그렇지 않으면 Chat 스페이스 URL 끝에 space/ 다음에 있는 일련의 숫자와 문자로 Chat 스페이스 ID가 표시됩니다.
새 브라우저 탭을 열고 알림 채널을 구성합니다.
1. Google Cloud 콘솔에서 알림 페이지로 이동합니다.
  알림으로 이동
  
  검색창을 사용하여 이 페이지를 찾은 경우 부제목이 Monitoring인 결과를 선택합니다.
2. 알림 채널 수정을 클릭합니다.
3. Google Chat 섹션으로 이동하여 새로 추가를 클릭합니다.
4. Chat 스페이스 ID 필드에 Chat 스페이스 ID를 입력한 다음 저장을 클릭합니다.

주문형 채널 만들기

알림 정책에 알림 채널을 추가할 때 목록에서 채널을 선택해야 합니다. 알림 정책을 만들 때 옵션 목록을 업데이트하려면 다음 프로세스를 사용합니다.

알림 대화상자에서 알림 채널 관리를 클릭합니다. 새 브라우저 탭에서 알림 채널 창으로 이동합니다.
새 알림 채널을 추가하려면 채널 유형을 찾아 새로 추가를 클릭한 후 이전 표에 포함된 채널별 안내를 따릅니다.
원래 탭으로 돌아가서 알림 대화상자에서 새로고침을 클릭합니다.
업데이트된 목록에서 알림 채널을 선택합니다.

지원되지 않는 채널에서 알림 받기

선호하는 알림 채널이 지원되지 않는 경우 Pub/Sub에 알림을 보내는 파이프라인을 만드는 것이 좋습니다. Flask를 사용하는 Python 예시는 Cloud Monitoring 및 Cloud Run으로 커스텀 알림 만들기를 참조하세요. 다른 예시는 cloud-alerting-notification-forwarding Git 저장소를 참조하세요.

알림 채널 테스트

Cloud Monitoring은 알림 채널의 테스트 옵션을 지원하지 않습니다. 그러나 알림 정책을 만들고 충족할 조건을 구성하여 알림 채널이 올바르게 구성되었는지 확인할 수 있습니다.

알림 채널을 수동으로 테스트하려면 가상 머신(VM) 인스턴스 중 하나의 CPU 사용률을 모니터링하는 알림 정책을 만들 수 있습니다.

선택사항: Google Cloud 프로젝트에 아직 VM이 없거나 테스트에 다른 VM을 사용하려면 VM을 만듭니다.
1. Google Cloud 콘솔에서 VM 인스턴스 페이지로 이동합니다.
  VM 인스턴스로 이동
  
  검색창을 사용하여 이 페이지를 찾은 경우 부제목이 Compute Engine인 결과를 선택합니다.
2. 인스턴스 만들기를 선택한 후 VM을 구성합니다. VM 만들기에 대한 자세한 내용은 공개 이미지에서 VM 인스턴스 만들기를 참조하세요.
Google Cloud 콘솔에서 알림 페이지로 이동합니다.
알림으로 이동

검색창을 사용하여 이 페이지를 찾은 경우 부제목이 Monitoring인 결과를 선택합니다.
정책 만들기를 선택합니다.
측정항목 선택 메뉴를 사용하여 VM 인스턴스의 CPU 사용률 측정항목을 선택합니다.
필터 추가를 클릭하고 VM의 필터를 추가합니다.
다음과 같이 트리거 구성 필드를 업데이트합니다.
1. 기준점 위치 필드에서 임곗값 미만을 선택합니다.
2. 인스턴스의 CPU 사용률보다 큰 값을 선택합니다. 예를 들어 차트에 CPU 사용률이 약 5%로 표시되면 기준점을 10%로 설정합니다.
  
  이 설정은 VM 인스턴스의 CPU 사용률이 지정된 기준점보다 낮을 때 충족할 조건을 구성합니다. VM 인스턴스의 CPU 사용률보다 큰 기준점을 선택했으므로 알림 정책 조건이 충족됩니다.
정책에 알림 채널을 추가합니다.
이슈 자동 종료 기간을 펼치고 30분을 선택합니다.
정책 이름을 입력하고 정책 만들기를 클릭합니다.
조건이 충족된 후 각 알림 채널에서 알림이 수신되었는지 확인합니다.
알림 정책을 삭제합니다. 자동 종료 기간이 만료되면 이슈가 자동으로 종결 처리됩니다.
이 테스트용으로 VM 인스턴스를 만들었으면 삭제합니다.

예상된 알림을 받지 못하면 로그 탐색기에서 누락된 알림에 대한 정보가 있는 로그 항목을 검색할 수 있습니다. 자세한 내용은 알림이 수신되지 않음을 참고하세요.

알림 채널 수정 및 삭제

Google Cloud 콘솔을 사용하여 알림 채널을 수정하거나 삭제하려면 다음 절차를 따르세요.

Google Cloud 콘솔에서 알림 페이지로 이동합니다.
알림으로 이동

검색창을 사용하여 이 페이지를 찾은 경우 부제목이 Monitoring인 결과를 선택합니다.
알림 채널 수정을 클릭합니다.

알림 채널 대시보드에는 각 알림 채널 유형에 대한 섹션이 있습니다. 각 섹션에는 해당 유형의 모든 구성이 나열됩니다.
- 항목을 수정하려면 수정을 클릭합니다. 변경이 완료되면 저장을 클릭합니다.
- 항목을 삭제하려면 삭제를 클릭합니다. 확인 대화상자에서 삭제를 클릭합니다.

알림 채널 로그 보기

로그 탐색기를 사용하여 알림 채널 오류를 볼 수 있습니다.

Google Cloud 콘솔에서 로그 탐색기 페이지로 이동합니다.
로그 탐색기로 이동

검색창을 사용하여 이 페이지를 찾은 경우 부제목이 Logging인 결과를 선택합니다.
쿼리를 입력하고 실행합니다. 알림 채널 오류 관련 쿼리에 대해서는 Cloud Monitoring 쿼리를 참조하세요.

다음 단계

이슈에 대한 자세한 내용은 다음 문서를 참조하세요.