Cloud Trace / Cloud Profiler 完全ガイド｜分散トレース・APM・OpenTelemetry

Cloud Trace と Cloud Profiler は GCP の APM (Application Performance Monitoring) コンポーネントで、 Trace は「リクエストの分散トレース」、Profiler は「関数レベルのプロファイル」を提供します。OpenTelemetry 統合により業界標準で計装可能です。

Cloud Trace

主要機能

• 分散トレース (マイクロサービス間のリクエスト追跡)
• Span (操作単位) のタイムラインビュー
• レイテンシ分布 (P50 / P95 / P99) の自動計算
• 異常レイテンシ検出 (Insights)
• OpenTelemetry / OpenCensus 対応

OpenTelemetry での計装例 (Python)

from opentelemetry import trace
from opentelemetry.sdk.trace import TracerProvider
from opentelemetry.sdk.trace.export import BatchSpanProcessor
from opentelemetry.exporter.cloud_trace import CloudTraceSpanExporter

trace.set_tracer_provider(TracerProvider())
trace.get_tracer_provider().add_span_processor(
    BatchSpanProcessor(CloudTraceSpanExporter())
)

tracer = trace.get_tracer(__name__)

@app.route('/order')
def create_order():
    with tracer.start_as_current_span("validate_order"):
        validate()
    with tracer.start_as_current_span("save_to_db"):
        save()
    with tracer.start_as_current_span("send_notification"):
        notify()
    return {"status": "ok"}

Cloud Profiler

主要機能

• 関数レベル CPU 使用率プロファイル
• ヒープ (メモリ) プロファイル
• Flame Graph 表示
• 低オーバーヘッド (本番常時実行可)
• 言語: Java / Python / Go / Node.js
• 料金: 完全無料

セットアップ例 (Python)

# pip install google-cloud-profiler

import googlecloudprofiler

googlecloudprofiler.start(
    service='my-api',
    service_version='1.0.0',
    verbose=3,  # 0=quiet, 4=verbose
)

料金

サンプリング戦略

OpenTelemetry 統合ベストプラクティス

• SDK で計装 → OTel Collector 経由 / 直接 Cloud Trace に送信
• 自動計装 (Auto-instrumentation) で HTTP / gRPC / DB を計装ゼロコード
• Service Name / Version で環境別ビュー
• Trace Context 伝播 (W3C TraceContext) でクロスサービス追跡
• Resource attributes で k8s.cluster.name / cloud.region 等

典型的なユースケース

• マイクロサービス間レイテンシボトルネック特定
• 本番性能劣化の原因調査
• SLO 違反時のドリルダウン
• 新リリース後のリグレッション検知
• コスト最適化 (CPU ホットスポット → リファクタリング)

他 APM 比較

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