Eventarc 完全ガイド｜CloudEvents・90+ イベントソース・サーバレストリガー

Eventarc は GCP の統一イベントルーティング基盤で、90+ サービスのイベントを CloudEvents 標準形式で Cloud Run / Cloud Functions / Workflows / GKE に配信します。「GCP のイベント駆動の中央神経」と位置づけられるサービスです。

主要コンセプト

• Trigger: イベントソース → ターゲットの配信ルール
• Event Provider: イベント発生源 (Cloud Audit Logs / GCS / Pub/Sub 等)
• Destination: イベント配信先 (Cloud Run / Functions / Workflows)
• CloudEvents: CNCF 標準イベントメタデータ仕様
• Filter: type / serviceName / methodName で絞り込み

主要イベントソース

Trigger 作成例

# GCS バケットアップロード → Cloud Run トリガー
gcloud eventarc triggers create my-trigger \
  --location=asia-northeast1 \
  --destination-run-service=image-processor \
  --destination-run-region=asia-northeast1 \
  --event-filters="type=google.cloud.storage.object.v1.finalized" \
  --event-filters="bucket=my-upload-bucket" \
  [email protected]

# Audit Log → Cloud Functions (特定操作)
gcloud eventarc triggers create iam-audit-trigger \
  --location=asia-northeast1 \
  --destination-run-service=audit-handler \
  --event-filters="type=google.cloud.audit.log.v1.written" \
  --event-filters="serviceName=iam.googleapis.com" \
  --event-filters="methodName=google.iam.admin.v1.SetIamPolicy"

CloudEvents 形式

{
  "specversion": "1.0",
  "id": "12345-abcde",
  "source": "//storage.googleapis.com/projects/_/buckets/my-bucket",
  "type": "google.cloud.storage.object.v1.finalized",
  "datacontenttype": "application/json",
  "subject": "objects/photo.jpg",
  "time": "2026-05-24T10:00:00.000Z",
  "data": {
    "bucket": "my-bucket",
    "name": "photo.jpg",
    "size": "1024000",
    "contentType": "image/jpeg"
  }
}

受信側コード例 (Cloud Run / Python)

from cloudevents.http import from_http
from flask import Flask, request

app = Flask(__name__)

@app.route("/", methods=["POST"])
def handle_event():
    event = from_http(request.headers, request.get_data())
    print(f"Event ID: {event['id']}")
    print(f"Event Type: {event['type']}")
    print(f"Data: {event.data}")
    # 処理ロジック
    return ("", 204)

料金

• Eventarc 自体: 無料
• 内部 Pub/Sub: $40/TB (月 6 GB 無料)
• ターゲット (Cloud Run / Functions): 各サービス料金
• 実質ほぼ無料で大規模利用可能

他クラウド比較

典型的なユースケース

• GCS アップロード → 画像リサイズ / OCR / ML 推論
• BigQuery クエリ完了 → 通知 / 次工程起動
• IAM 変更監査 → セキュリティ通知 (Audit Log → Cloud Functions)
• Firestore 変更 → Algolia インデックス更新
• Vertex AI 学習完了 → モデル評価 / デプロイ
• Cloud Build 完了 → Cloud Deploy リリース作成

※ Google Cloud は Google LLC の商標です。最新情報は Eventarc 公式 をご確認ください。