---
title: "Google Cloud Monitoring 전화 알림: 웹훅으로 울리기"
description: "Cloud Monitoring은 이메일, SMS, 푸시는 보내도 전화는 걸지 못합니다. GCP 알림 정책을 전화 웹훅으로 보내는 설정, 페이로드 필드, 필터, 주의점."
date: 2026-11-15
author: Nooc
authorAvatarLink: /images/avatars/nooc.webp
authorLink: https://nooc.me
tags:
  - Google Cloud
  - Cloud Monitoring
  - GCP
  - 전화 알림
  - 웹훅
  - 온콜
---

# Google Cloud Monitoring 전화 알림: 알림 정책에서 휴대폰 벨소리까지

Google Cloud Monitoring에는 전화를 걸 방법이 없습니다. 알림 채널은 이메일, SMS, Google Cloud 모바일 앱, Slack, Google Chat, PagerDuty, Pub/Sub, 웹훅이고, Google 문서조차 SMS는 완전히 신뢰할 수 없으며 지역에 따라 제공되지 않을 수 있다고 말합니다. 알림 정책이 수신 전화처럼 울리게 하고 싶다면, 가장 짧은 길은 Echobell 전화 채널을 가리키는 웹훅 채널 하나와 템플릿 두 줄, 조건 하나입니다.

이 가이드는 채널, 웹훅, Cloud Monitoring이 실제로 보내는 페이로드 필드, "open" 인시던트는 울리고 "closed" 인시던트는 조용히 두는 방법, 그리고 휴대폰이 얼마나 자주 울릴지 정하는 알림 정책 설정을 다룹니다.

## 새벽 3시에 기본 채널로는 부족한 이유

- **이메일**은 직접 열어 볼 때까지 기다립니다.
- **SMS**는 Google의 표현대로 완전히 신뢰할 수 있는 채널 유형이 아니며, 국가에 따라 제공되지 않을 수 있습니다. 다른 문자처럼 방해 금지에서 무음 처리되기도 합니다.
- **모바일 앱**은 평범한 푸시를 보냅니다. 잠금 화면에 표시되지만 계속 울리지는 않습니다.
- **PagerDuty**는 전화를 걸 수 있지만, 자체 설정과 계약이 필요한 완전한 온콜 플랫폼입니다.

반면 웹훅 채널은 공개 HTTPS 엔드포인트가 있는 곳이라면 어디든 닿을 수 있고, Cloud Monitoring은 인시던트마다 구조화된 JSON 문서를 보냅니다. Echobell에 필요한 건 그게 전부입니다.

## 준비물

- 알림 정책이 하나 이상 있는 Google Cloud 프로젝트(또는 알림을 걸고 싶은 업타임 체크)
- 알림 채널을 편집할 권한(`roles/monitoring.notificationChannelEditor` 또는 Monitoring Editor)
- 설치된 Echobell([App Store](https://apps.apple.com/app/apple-store/id6743597198?pt=128151925&ct=blog-google-cloud-monitoring-phone-call-alerts-ko&mt=8) / [Google Play](https://play.google.com/store/apps/details?id=one.echobell.echobellandroid))
- 10분

프로젝트 쪽에서 인바운드 트래픽을 받을 필요는 없습니다. 아웃바운드 요청은 Cloud Monitoring이 보냅니다.

## 1단계 — 울리는 채널 만들기

Echobell에서 채널을 만들고 알림 유형을 **전화(Calling)** 로 설정합니다. 전화 채널은 푸시가 아니라 수신 전화처럼 동작하므로 화면 전체에 표시되고 울립니다. iOS 집중 모드나 방해 금지에서는 집중 모드 설정에서 전화를 허용한 경우에만 울립니다.

채널의 **고급 설정**을 열고 **사용자 지정 템플릿**을 켭니다. Cloud Monitoring은 모든 내용을 `incident` 객체로 감싸므로, 템플릿은 중첩된 필드를 읽습니다.

```
제목: {{incident.state}}: {{incident.policy_name}}
본문: {{incident.summary}}
```

**링크 템플릿**을 지정하면 알림을 눌렀을 때 Google Cloud 콘솔에서 인시던트가 열립니다.

```
{{incident.url}}
```

새로 열린 인시던트만 울리도록 **조건**을 추가합니다.

```
incident.state == "open"
```

채널 상세 화면에서 채널의 웹훅 URL을 복사합니다.

```
https://hook.echobell.one/t/<channel-token>
```

## 2단계 — Google Cloud에 웹훅 알림 채널 추가하기

1. **Monitoring → Alerting**을 열고 **Edit notification channels**를 클릭
2. **Webhooks** 아래에서 **Add new**를 클릭
3. **Endpoint URL**: 1단계의 Echobell 채널 URL
4. **Display name**: `Echobell (call)`
5. **Use HTTP Basic Auth**는 끈 상태로 두기
6. **Test connection**을 클릭한 뒤 **Save**

Basic Auth는 일부러 끕니다. Google의 Basic Auth 핸드셰이크는 엔드포인트가 첫 요청에 `401`과 `WWW-Authenticate` 헤더로 응답하기를 기대합니다. Echobell은 URL에 든 비밀 토큰으로 인증하므로, 그 URL은 비밀번호처럼 다루세요.

채널을 Terraform으로 관리한다면 같은 채널은 다음과 같습니다.

```hcl
resource "google_monitoring_notification_channel" "echobell_call" {
  display_name = "Echobell (call)"
  type         = "webhook_tokenauth"

  labels = {
    url = "https://hook.echobell.one/t/<channel-token>"
  }
}
```

토큰은 버전 관리에 넣지 마세요. URL을 커밋하지 말고 변수나 Secret Manager에서 읽어 오세요.

## 3단계 — 전화할 가치가 있는 정책에만 채널 연결하기

알림 정책을 열고 **Notifications and name**으로 가서 **Notification channels**에 `Echobell (call)`을 추가합니다. 정책 하나가 여러 채널에 동시에 알릴 수 있으므로, 기존 이메일이나 Slack 채널은 그대로 둬도 됩니다.

여기서는 까다롭게 고르세요. 이것이 진짜 필터입니다. "운영 API 다운"과 "데이터베이스 디스크 가득 참"에만 연결된 채널은 드물게 울리기 때문에, 울릴 때 여전히 받게 됩니다. "CPU 5분간 70% 초과"는 이메일에 남겨 두세요.

같은 페이지의 두 가지 설정이 휴대폰에 도착하는 내용을 좌우합니다.

- **Notify on incident closure.** 켜면 인시던트가 닫힐 때도 Cloud Monitoring이 알림을 보냅니다. 1단계의 `incident.state == "open"` 조건이 그 알림을 울리지 않게 막고, 6단계에서 조용히 받는 방법을 보여 줍니다.
- **Incident autoclose duration.** 지표가 데이터를 보고하지 않으면 열린 인시던트는 이 기간 후에 닫힙니다. 특별한 이유가 없다면 기본값을 유지하세요.

## 4단계 — 페이로드의 실제 모양 알기

Cloud Monitoring은 기본적으로 스키마 버전 1.2를 보냅니다. 쓸 만한 필드만 남기면, 열린 인시던트는 다음과 같습니다.

```json
{
  "version": "1.2",
  "incident": {
    "incident_id": "0.opqiw61fsv7p",
    "scoping_project_id": "my-project",
    "url": "https://console.cloud.google.com/monitoring/alerting/incidents/0.opqiw61fsv7p?project=my-project",
    "state": "open",
    "renotify": false,
    "started_at": 1794713564,
    "ended_at": null,
    "policy_name": "Prod API 5xx rate",
    "condition_name": "5xx ratio above 5%",
    "resource_display_name": "prod-api",
    "threshold_value": "0.05",
    "observed_value": "0.183",
    "severity": "Critical",
    "policy_user_labels": {
      "team": "payments"
    },
    "documentation": {
      "content": "Check the latest deploy first. Runbook: https://wiki.example.com/api-5xx",
      "mime_type": "text/markdown"
    },
    "summary": "5xx ratio for prod-api with metric labels {response_code_class=500} is above the threshold of 0.050 with a value of 0.183."
  }
}
```

템플릿을 고치기 전에 알아 둘 점:

- **모든 내용은 `incident` 아래에 있습니다.** `{{policy_name}}`은 빈 값으로 렌더링되고, `{{incident.policy_name}}`은 그렇지 않습니다.
- **`state`는 `open` 또는 `closed`입니다.** 조건과 제목 템플릿이 기대는 것은 이 필드 하나입니다.
- **`summary`는 자동 생성된 텍스트입니다.** Google은 형식이 안정적이라고 약속하지 않으므로, 표시에는 쓰되 조건에서 매칭하지는 마세요.
- **필드가 빠질 수 있습니다.** Google은 정책과 인시던트 상태에 따라 일부 필드가 없거나 null이라고 밝힙니다. 빠진 필드는 Echobell에서 빈 문자열로 렌더링되므로 템플릿은 계속 동작합니다. 다만 정책에서 설정하지 않는 필드로 조건을 만들지는 마세요.
- **`documentation.content`는 직접 쓰는 내용입니다.** 정책의 **Documentation** 칸에 입력한 내용이 그대로 여기에 도착합니다. 울리는 휴대폰에서는 자동 생성된 요약보다 한 줄짜리 지시("먼저 최근 배포를 확인")가 더 유용합니다.
- **심각도는 정책을 따릅니다.** 정책에 설정한 수준이 그대로 들어옵니다. 이것으로 필터링하기 전에 테스트 인시던트를 보내 정확한 값을 확인하세요.

직접 쓴 문장으로 시작하고 요약으로 보완하는 본문:

```
{{incident.documentation.content}}
{{incident.summary}}
```

## 5단계 — 무엇을, 얼마나 자주 울릴지 정하기

필터링의 대부분은 어떤 정책에 채널을 연결할지 고를 때 이미 끝났습니다. 나머지는 Echobell의 채널 조건이 맡습니다.

| 목표 | 조건 |
| --- | --- |
| 인시던트가 열릴 때만 울리기 | `incident.state == "open"` |
| 한 번만 울리고 재알림에는 울리지 않기 | `incident.state == "open" && !incident.renotify` |
| 특정 팀의 정책에만 울리기 | `incident.state == "open" && incident.policy_user_labels.team == "payments"` |
| 야간에만 울리기(00:00–07:00 UTC) | `incident.state == "open" && hour < 7` |

**재알림.** 인시던트가 열려 있는 동안 정책은 알림을 다시 보낼 수 있습니다. API에서는 `alertStrategy.notificationChannelStrategy[].renotifyInterval`이며, 30분에서 24시간까지 설정할 수 있습니다. 이 반복 알림은 `renotify: true`와 함께 도착합니다. 울리게 할지는 선택입니다. 다시 울리는 것은 아무도 고치지 않은 인시던트에 대한 투박하지만 효과적인 에스컬레이션이고, 건너뛰면 긴 장애가 밤새 울리는 일을 막을 수 있습니다. 표의 두 번째 행이 건너뛰는 방법입니다.

**사용자 라벨.** `team: payments` 같은 정책 사용자 라벨은 `policy_user_labels`에 담겨 전달됩니다. 이 라벨로 조건을 걸면 여러 정책에 연결된 한 채널이 일부 정책에서만 울리고 나머지에서는 조용히 있게 할 수 있습니다. 라벨은 필터일 뿐 분기 수단이 아닙니다. 각 웹훅 URL은 항상 같은 Echobell 채널을 트리거하므로, 라벨로 인시던트를 다른 사람의 채널로 보낼 수는 없습니다.

Echobell의 시간 변수는 UTC이므로 먼저 자신의 표준시에서 환산하세요. 전체 변수 목록은 [조건 레퍼런스](/ko/docs/conditions)에 있습니다.

## 6단계 — 종료 알림에는 조용한 문을 따로

**Notify on incident closure**를 켜면, 닫힌 인시던트는 볼 가치가 있는 좋은 소식이지만 울릴 만한 일은 아닙니다. **시간 민감(Time Sensitive)**(또는 일반) 유형의 두 번째 Echobell 채널을 같은 템플릿, 조건 없이 만들고, Google Cloud에 두 번째 웹훅 채널로 추가한 뒤 두 채널을 모두 정책에 연결하세요. 제목 템플릿은 이미 "closed: Prod API 5xx rate"로 읽힙니다.

| Echobell 채널 | 조건 | 채널 유형 | 동작 |
| --- | --- | --- | --- |
| `gcp-call` | `incident.state == "open"` | 전화 | 수신 전화처럼 울림 |
| `gcp-log` | 없음 | 시간 민감 또는 일반 | 열림, 재알림, 종료를 모두 받되 울리지 않음 |

## 믿기 전에 테스트하기

**먼저 Echobell 쪽을 테스트하세요.** Cloud Monitoring과 같은 모양의 페이로드를 POST합니다.

```bash
curl -X POST https://hook.echobell.one/t/<channel-token> \
  -H 'Content-Type: application/json' \
  -d '{"version":"1.2","incident":{"state":"open","renotify":false,"policy_name":"Manual test","summary":"Testing the Echobell path","url":"https://console.cloud.google.com/monitoring/alerting"}}'
```

**그다음 Google 쪽을 테스트하세요.** **Test connection** 버튼은 실제 인시던트가 아닌 필드로 된 샘플 페이로드를 보내므로 조건을 통과하지 못할 수 있습니다. 엔드투엔드 테스트를 하려면 이미 넘어서 있는 임계값으로 임시 정책을 만들고(예: VM CPU 사용률 1% 초과), `Echobell (call)`을 연결해 발생을 기다린 뒤 정책을 삭제하세요.

`curl`로는 울리는데 실제 정책으로는 울리지 않는다면, 문제는 Echobell 채널이 아니라 Google 쪽에 있습니다. 채널이 연결되지 않았거나, 조건이 아직 지속 시간을 채우지 못했거나, 엔드포인트 URL을 잘못 복사한 경우입니다.

## 로그 기반 알림과 업타임 체크

- **업타임 체크**는 그 자체로는 아무에게도 알리지 않고, 알림 정책에 데이터를 넘깁니다. 업타임 체크에서 정책을 만들고 같은 웹훅 채널을 연결하세요.
- **로그 기반 알림 정책**은 인시던트가 열릴 때만 알립니다. Google은 이 정책들에 대해 종료 알림을 보내지 않으며, 알림 속도 제한이 필수입니다. 이 제한이 시끄러운 로그 한 줄이 당신을 울릴 수 있는 빈도에 상한을 둡니다. `incident.state == "open"` 조건은 그대로 동작하고, 종료용 채널은 이 정책들로부터 아무것도 받지 않을 뿐입니다.

## 인시던트 중에 중요한 제한

- **본문 1 MiB.** Echobell은 1 MiB를 넘는 트리거 본문을 HTTP 413으로 거부합니다. Cloud Monitoring 인시던트는 몇 KB 정도입니다.
- **토큰당 분당 120회 요청.** 이를 넘으면 트리거는 `429`를 `RATE_LIMIT_EXCEEDED`, `Retry-After`와 함께 반환합니다. 정책 하나로는 거의 근처에도 가지 않지만, 리전 장애 중 수십 개 정책이 한꺼번에 발생하면 닿을 수 있습니다. 전화 채널을 짧은 목록에만 연결해야 하는 또 하나의 이유입니다.
- **알림 본문 1500바이트.** 더 긴 렌더링 결과는 잘립니다. 정책 문서는 짧게 쓰거나, 런북 전체 대신 런북 링크를 넣으세요.

## 이 구성이 제공하지 않는 것

- **확인(ack)이 없습니다.** 전화를 받아도 Google Cloud의 인시던트가 확인되거나 닫히지 않습니다.
- **에스컬레이션도 로테이션도 없습니다.** 채널을 구독한 모든 사람에게 전화가 가고, 그다음 사람은 없습니다.
- **인시던트를 넘어서는 중복 제거가 없습니다.** 흔들리는 조건은 매번 새 인시던트를 열고, 그때마다 울립니다. 정책에서 지속 시간 창을 늘려 해결하세요.

이것들이 결정적 문제라면 완전한 온콜 플랫폼이 필요합니다. 필요한 게 "운영 정책이 발생하면 전화해 줘"라면, 콘솔 화면 두 개면 됩니다.

## 문제 해결

**인시던트는 열렸는데 아무것도 오지 않음.** **Monitoring → Alerting**에서 인시던트를 열고 정책에 웹훅 채널이 있는지 확인하세요. 엔드포인트 URL이 토큰까지 포함한 전체 Echobell URL인지도 확인하세요.

**알림은 왔는데 울리지 않음.** 채널 유형이 **전화(Calling)** 가 아니거나, 휴대폰의 집중 모드 설정에서 전화를 허용하지 않은 경우입니다. 채널과 집중 모드 설정을 확인하세요.

**알림이 비어 있음.** 템플릿이 최상위 필드를 읽고 있습니다. 앞에 `incident.`을 붙이세요. `{{policy_name}}`이 아니라 `{{incident.policy_name}}`입니다.

**30분마다 다시 울림.** 정책에 재알림 간격이 설정되어 있습니다. 이를 제거하거나 조건에 `!incident.renotify`를 추가하세요.

**인시던트가 닫힐 때 울림.** 조건에 `incident.state == "open"`이 빠졌거나 다른 채널에 설정되어 있습니다.

## 자주 묻는 질문

### Google Cloud Monitoring이 자체적으로 전화번호에 전화를 걸 수 있나요?

아니요. 알림 채널은 이메일, SMS, Google Cloud 모바일 앱, Slack, Google Chat, PagerDuty, Pub/Sub, 웹훅입니다. 음성 전화에는 외부 서비스가 필요합니다. 온콜 플랫폼이나 Echobell 같은 전화 웹훅입니다.

### Pub/Sub나 Cloud Function이 필요한가요?

아니요. Cloud Monitoring이 직접 인시던트를 웹훅 URL로 POST합니다. Pub/Sub는 공개되지 않은 엔드포인트를 위해 Google이 권장하는 방법입니다. Echobell의 엔드포인트는 공개되어 있으므로 웹훅 채널로 충분합니다.

### Cloud Monitoring 알림이 방해 금지를 뚫나요?

전화형 알림으로 도착할 때만 그렇습니다. 전화 유형의 Echobell 채널은 수신 전화처럼 동작하므로, 집중 모드 설정에서 전화를 허용해 두면 iOS 집중 모드와 방해 금지가 통과시킵니다. SMS나 일반 푸시는 통과하지 못합니다. **실패한 전화 재시도**도 함께 켜 두세요. 집중 모드 설정에서 "반복 통화 허용"을 켜 두면 3분 안에 다시 걸려 온 두 번째 전화는 울릴 수 있습니다.

### 웹훅에서 Basic Auth 옵션을 써야 하나요?

아니요. Echobell은 URL의 토큰으로 인증합니다. Google의 Basic Auth 흐름은 먼저 `401` 챌린지를 기대하지만, Echobell은 이를 보내지 않습니다.

### 정책마다 다른 사람에게 전화할 수 있나요?

네. 대상마다 Echobell 채널을 하나씩 만들고, 각 채널의 URL을 Google Cloud에 별도의 웹훅 채널로 추가한 뒤, 그 대상이 담당하는 정책에 연결하면 됩니다. 웹훅 URL 하나는 항상 같은 Echobell 채널을 트리거하므로, `policy_user_labels` 조건으로 그 채널에서 일부 정책을 음소거할 수는 있어도 다른 채널로 넘길 수는 없습니다. 확인 기능이 없으므로 "전화"로 구독한 모든 사람에게 전화가 갑니다.

### 프로젝트가 여러 개라면요?

알림 채널은 하나의 프로젝트에 속합니다. 프로젝트마다 웹훅 채널을 만들거나(같은 Echobell URL을 모든 프로젝트에서 쓸 수 있습니다), 다른 프로젝트를 모니터링하는 범위 지정 프로젝트(scoping project)에서 알림을 보내세요.

## 정리

경로는 네 부분입니다. `incident.state == "open"` 조건이 있는 전화 채널, 그것을 가리키는 웹훅 알림 채널, 전화할 가치가 있는 짧은 정책 목록, 그리고 의존하기 전에 하는 실제 테스트. 나머지는 전부, 한 달 뒤에도 그 벨소리가 의미를 갖도록 그 목록을 충분히 짧게 유지하는 방법에 관한 이야기입니다.

[iPhone용 Echobell 다운로드](https://apps.apple.com/app/apple-store/id6743597198?pt=128151925&ct=blog-google-cloud-monitoring-phone-call-alerts-ko&mt=8) 또는 [Google Play에서 받기](https://play.google.com/store/apps/details?id=one.echobell.echobellandroid) 후, 가장 중요한 알림 정책을 연결해 보세요.

## 관련 글

- [채널 조건 레퍼런스](/ko/docs/conditions)
- [템플릿 레퍼런스](/ko/docs/template)
- [웹훅 연동 가이드](/ko/docs/webhook)
- [CloudWatch 전화 알림](/ko/blog/cloudwatch-alarm-phone-call-alerts)
- [Prometheus Alertmanager 전화 알림](/ko/blog/alertmanager-phone-call-alerts)
- [개발자를 위한 알림 피로 해소 가이드](/ko/blog/fix-alert-fatigue-developer-guide)
- [중요 알림으로 iOS 집중 모드 뚫기](/ko/blog/how-to-bypass-ios-focus-mode-for-critical-alerts)
