ストーリー

OpenTelemetry Collector の設計

Collector デプロイメントパターン

推奨構成（Agent + Gateway）:

Service A ─→ Agent Collector ─┐
Service B ─→ Agent Collector ─┤
Service C ─→ Agent Collector ─┼─→ Gateway Collector ─→ Backend
Service D ─→ Agent Collector ─┤    (集約・ルーティング)
Service E ─→ Agent Collector ─┘

Agent の役割:
├── ローカルバッファリング
├── 基本的なフィルタリング
├── リソース属性の付加
└── バッチ送信

Gateway の役割:
├── テイルサンプリング
├── 高度なフィルタリング
├── ルーティング（バックエンド振り分け）
└── レート制限

パイプライン設計（Receiver → Processor → Exporter）

receivers:        processors:           exporters:
├── otlp          ├── batch             ├── otlphttp (SaaS)
├── prometheus    ├── filter            ├── prometheusremotewrite
├── filelog       ├── attributes        ├── loki
├── hostmetrics   ├── tail_sampling     └── debug
└── k8s_events    ├── resource
                  ├── transform
                  └── memory_limiter

サンプリング戦略

サンプリングの種類

テイルサンプリングの推奨ポリシー

テイルサンプリング設定例:

processors:
  tail_sampling:
    decision_wait: 10s
    policies:
      - name: error-policy
        type: status_code
        status_code: {status_codes: [ERROR]}
      - name: latency-policy
        type: latency
        latency: {threshold_ms: 1000}
      - name: rate-limiting-policy
        type: probabilistic
        probabilistic: {sampling_percentage: 10}

ログ収集標準

構造化ログフォーマット

メトリクス命名規則

命名規則: <namespace>_<subsystem>_<name>_<unit>

例:
  http_server_request_duration_seconds     (ヒストグラム)
  http_server_request_total                (カウンター)
  db_connection_pool_active_connections    (ゲージ)
  payment_transaction_amount_jpy_total     (カウンター)

禁止:
  ✗ requestCount          → ○ http_server_request_total
  ✗ api.latency           → ○ http_server_request_duration_seconds
  ✗ DBConnections         → ○ db_connection_pool_active_connections

データボリューム管理

データティアリング

コスト最適化の原則

「データ収集の鉄則は”必要なデータを最小コストで確保する”ことだ。“全部取って後で考える”は月末の請求書を見て後悔する」 — 田中VPoE

まとめ

チェックリスト

• OTel Collectorのデプロイメントパターンを理解した
• テイルサンプリングの仕組みと推奨ポリシーを理解した
• 構造化ログフォーマットとメトリクス命名規則を理解した
• データティアリングによるコスト最適化を理解した

次のステップへ

次は「ストレージと分析基盤」を学びます。収集したデータをどのように効率的に保存し、高速に分析するかの設計手法を身につけましょう。

推定読了時間: 30分