gcp-alerts

name	gcp-alerts
description	GCP 알림 정책 설정 (비용/에러/성능)

GCP Alerting Policies

Cloud Monitoring 알림 정책을 설정하고 관리합니다.

사용법

/gcp-alerts                        # 알림 정책 목록
/gcp-alerts create budget          # 예산 알림 생성
/gcp-alerts create vm-cpu          # VM CPU 알림 생성
/gcp-alerts create error-rate      # 에러율 알림 생성

Workflow

0. API 활성화 (최초 1회)

gcloud services enable monitoring.googleapis.com --project=$PROJECT_ID

1. 알림 정책 목록

PROJECT_ID=$(gcloud config get-value project)
gcloud alpha monitoring policies list --project=$PROJECT_ID \
  --format="table(displayName,enabled,conditions[0].displayName)"

2. 알림 채널 설정 (이메일)

# 이메일 채널 생성
cat > /tmp/email-channel.json << 'EOF'
{
  "type": "email",
  "displayName": "Admin Email",
  "labels": {
    "email_address": "[e-mail]"
  }
}
EOF

gcloud alpha monitoring channels create \
  --channel-content-from-file=/tmp/email-channel.json \
  --project=$PROJECT_ID

3. VM CPU 알림 정책 생성

cat > /tmp/cpu-alert.json << 'EOF'
{
  "displayName": "High CPU Usage",
  "conditions": [{
    "displayName": "CPU > 80%",
    "conditionThreshold": {
      "filter": "resource.type = \"gce_instance\" AND metric.type = \"compute.googleapis.com/instance/cpu/utilization\"",
      "comparison": "COMPARISON_GT",
      "thresholdValue": 0.8,
      "duration": "300s",
      "aggregations": [{
        "alignmentPeriod": "60s",
        "perSeriesAligner": "ALIGN_MEAN"
      }]
    }
  }],
  "combiner": "OR",
  "enabled": true,
  "notificationChannels": ["CHANNEL_ID"]
}
EOF

gcloud alpha monitoring policies create \
  --policy-from-file=/tmp/cpu-alert.json \
  --project=$PROJECT_ID

4. 예산 알림 설정

# 예산 API 활성화
gcloud services enable billingbudgets.googleapis.com

# 예산 생성 (월 $100, 80% 도달 시 알림)
gcloud billing budgets create \
  --billing-account=BILLING_ACCOUNT_ID \
  --display-name="Monthly Budget" \
  --budget-amount=100USD \
  --threshold-rules=threshold-percent=0.8,spend-basis=current-spend \
  --threshold-rules=threshold-percent=1.0,spend-basis=current-spend \
  --all-updates-rule-pubsub-topic=projects/$PROJECT_ID/topics/budget-alerts

5. Cloud Run 에러율 알림

cat > /tmp/error-alert.json << 'EOF'
{
  "displayName": "Cloud Run Error Rate > 5%",
  "conditions": [{
    "displayName": "Error rate",
    "conditionThreshold": {
      "filter": "resource.type = \"cloud_run_revision\" AND metric.type = \"run.googleapis.com/request_count\" AND metric.labels.response_code_class = \"5xx\"",
      "comparison": "COMPARISON_GT",
      "thresholdValue": 0.05,
      "duration": "60s",
      "aggregations": [{
        "alignmentPeriod": "60s",
        "perSeriesAligner": "ALIGN_RATE"
      }]
    }
  }],
  "combiner": "OR",
  "enabled": true
}
EOF

gcloud alpha monitoring policies create \
  --policy-from-file=/tmp/error-alert.json \
  --project=$PROJECT_ID

6. 정책 활성화/비활성화

# 비활성화
gcloud alpha monitoring policies update POLICY_ID \
  --no-enabled \
  --project=$PROJECT_ID

# 활성화
gcloud alpha monitoring policies update POLICY_ID \
  --enabled \
  --project=$PROJECT_ID

7. 정책 삭제

gcloud alpha monitoring policies delete POLICY_ID --project=$PROJECT_ID

자주 쓰는 알림 템플릿

VM 모니터링

알림	메트릭	임계값
높은 CPU	compute.googleapis.com/instance/cpu/utilization	> 80%
높은 메모리	agent.googleapis.com/memory/percent_used	> 90%
디스크 부족	agent.googleapis.com/disk/percent_used	> 85%
VM 다운	Uptime Check 실패	2회 연속

Cloud Run / Functions

알림	메트릭	임계값
에러율	5xx / total	> 5%
지연 시간	request_latencies	p99 > 2s
인스턴스 급증	instance_count	> 50

비용

알림	설정
일일 예산	threshold 80%, 100%
이상 비용	전일 대비 200% 초과

출력 형식

## 알림 정책 목록

| 정책 이름 | 상태 | 조건 |
|-----------|------|------|
| High CPU Usage | 활성 | CPU > 80% for 5분 |
| Error Rate Alert | 활성 | 5xx > 5% for 1분 |
| Monthly Budget | 활성 | $100의 80%, 100% |

---

### 알림 채널

| 채널 | 유형 | 대상 |
|------|------|------|
| Admin Email | email | [e-mail] |
| Slack Webhook | webhook | #alerts |

알림 채널 유형

유형	설정
Email	email_address
Slack	Webhook URL
PagerDuty	Integration Key
SMS	전화번호
Pub/Sub	Topic 이름

비용

• 알림 정책: 무료
• 알림 채널: 무료
• Uptime Check: 무료 (1백만 회/월)

주의사항

• 너무 민감한 임계값 설정 시 알림 폭주
• 적절한 duration 설정으로 일시적 스파이크 필터링
• 중요 알림은 여러 채널로 발송 권장