メインコンテンツまでスキップ

OTLP コレクターへのテレメトリ送出

routerd のログ、メトリクス、トレース、サービス属性を Telemetry リソースから OTLP コレクターへ送出する構成

routerd のテレメトリを OpenTelemetry コレクターへ送る例です。 長時間稼働、ヘルスチェック、DPI、apply のレイテンシーの観測に使えます。

完全な YAML は examples/telemetry-export.yaml にあります。

構成図

図の対応表

番号意味主なリソース
[1]logs、metrics、traces を出す routerd プロセス。Telemetry/otlp
[2]OTLP コレクターのエンドポイント。Telemetry.spec.otlp.endpoint
[3]コレクターが転送する先のバックエンド。routerd 管理外

この例で管理するもの

領域routerd リソース
テレメトリの送出先Telemetry/otlp
サービスの識別情報serviceNamespace, attributes
シグナルlogs, metrics, traces

設定の要点

# [1] routerd のテレメトリ送出を有効にする。
- apiVersion: observability.routerd.net/v1alpha1
kind: Telemetry
metadata:
name: otlp
spec:
# [2] OTLP コレクターのエンドポイント。
otlp:
endpoint: http://collector.example.internal:4317
insecure: true
serviceNamespace: routerd
attributes:
deployment.environment: lab
site: example
signals:
- logs
- metrics
- traces

確認

routerctl validate -f examples/telemetry-export.yaml --replace
routerctl describe Telemetry/otlp

コレクターやバックエンド側でデータが届いていることを確認します。 エンドポイントは信頼できる管理網または観測用ネットワークに置いてください。