OTLP コレクターへテレメトリを送る

シナリオ

ルーターのログ, メトリクス, トレースを、OpenTelemetry 互換のバックエンド (Grafana Loki/Tempo/Mimir, Datadog, Honeycomb, 自前の otelcol-contrib など) へ送りたい場合です。 journalctl や routerctl events を毎回叩かずに、外部のダッシュボードで観測したい状態を想定します。

routerd は、すべての常駐デーモンから OpenTelemetry でエクスポートできます。 コレクター本体は routerd のバイナリに同梱しません。 すでに運用している外部の OTLP エンドポイントを指定してください。 routerd は OTLP/gRPC でデータを送ります。

routerd が出すもの

デーモン	service.name	内容
routerd (制御プレーン)	routerd	controller.reconcile トレース、routerd.controller.reconcile カウンター、構造化 slog ログ
routerd-dhcpv6-client	routerd-dhcpv6-client	DHCPv6 ライフサイクルのトレースと構造化ログ (Solicit/Request/Renew, リースイベント)
routerd-dhcpv4-client	routerd-dhcpv4-client	DHCPv4 ライフサイクルのトレースと構造化ログ
routerd-pppoe-client	routerd-pppoe-client	PPPoE セッションのライフサイクル
routerd-healthcheck	routerd-healthcheck	ヘルスチェックの結果（target 属性付きの成功・失敗）

各デーモンはリソース属性に routerd.resource.name を付けるので、リソース単位（例: WAN ごとの DHCPv6 クライアント）でシグナルを分けられます。

エクスポートは OTLP/gRPC です。 logs, metrics, traces は既定で同じエンドポイントを共有しますが、必要なら信号ごとに別のエンドポイントを指定できます。

エクスポートの設定

routerd は OpenTelemetry の標準環境変数を読みます。routerd 独自の構文はありません。OTLP/gRPC エクスポーターの上流が解釈する変数は、そのまま使えます。

主な変数は次のとおりです。

変数	用途
OTEL_EXPORTER_OTLP_ENDPOINT	全シグナル共通のエンドポイント（例: http://collector.lan:4317）
OTEL_EXPORTER_OTLP_LOGS_ENDPOINT / _METRICS_ENDPOINT / _TRACES_ENDPOINT	信号ごとの個別指定
OTEL_EXPORTER_OTLP_INSECURE	true で TLS を無効化（ラボ用）
OTEL_EXPORTER_OTLP_HEADERS	例: マネージドバックエンド向けの Authorization=Bearer ...
OTEL_SERVICE_NAMESPACE	推奨: 全デーモンで routerd を共有する
OTEL_RESOURCE_ATTRIBUTES	サイト・ホスト属性などを key=value,... で自由に指定する

OTEL_EXPORTER_OTLP_ENDPOINT / _LOGS_ENDPOINT / _METRICS_ENDPOINT / _TRACES_ENDPOINT のいずれも未設定なら、routerd はテレメトリの初期化自体を省きます。デーモン側に有効化フラグはありません。「変数を設定しない」ことが、そのまま無効を意味します。

systemd 管理の routerd へ反映

Linux のインストールでは、systemd unit の環境に変数を入れます。 上流の unit が更新されても消えないように、drop-in を使います。

# /etc/systemd/system/routerd.service.d/10-otel.conf
[Service]
Environment=OTEL_EXPORTER_OTLP_ENDPOINT=http://collector.lan:4317
Environment=OTEL_EXPORTER_OTLP_INSECURE=true
Environment=OTEL_SERVICE_NAMESPACE=routerd
Environment=OTEL_RESOURCE_ATTRIBUTES=deployment.environment=home,host.name=edge-router

エクスポートしたい管理対象デーモンにも、同じ drop-in を入れてください。

• /etc/systemd/system/[email protected]/10-otel.conf
• /etc/systemd/system/[email protected]/10-otel.conf
• /etc/systemd/system/[email protected]/10-otel.conf
• /etc/systemd/system/[email protected]/10-otel.conf

そして、次を実行します。

sudo systemctl daemon-reload
sudo systemctl restart routerd.service \
                       'routerd-dhcpv6-client@*.service' \
                       'routerd-healthcheck@*.service'

FreeBSD

routerd が出力する rc.d ラッパーの command_args の環境ブロックに、変数を追加します (ラッパーが対応していれば routerd_envfile=... でも構いません)。

受信側を立てて検証する

OTLP/gRPC バックエンドなら何でも使えます。 スモークテストには、otelcol-contrib の debug exporter が手軽です。

# /tmp/otel-test.yaml
receivers:
  otlp:
    protocols:
      grpc:
        endpoint: 0.0.0.0:4317

exporters:
  debug:
    verbosity: detailed

service:
  pipelines:
    logs:    { receivers: [otlp], exporters: [debug] }
    metrics: { receivers: [otlp], exporters: [debug] }
    traces:  { receivers: [otlp], exporters: [debug] }

otelcol-contrib --config /tmp/otel-test.yaml

routerd を再起動すると、数秒以内に次が見えるはずです。

• routerd.controller.reconcile の Sum メトリック（増加方向）
• controller.reconcile のスパン（status OK）
• routerd の slog 出力が LogRecord として届く

routerd 本体の記録だけ届いてデーモン側が黙っているなら、デーモン用の drop-in が反映されているか、daemon-reload を実行したかを確認してください。

トラブルシューティング

デーモンの journal に address family not supported by protocol が出る。 現在の routerd 生成 systemd unit は address family を制限しません。古いローカル unit や drop-in に RestrictAddressFamilies が残っていないか確認し、その override を削除して systemctl daemon-reload を実行してください。

コレクターに何も届かない。 routerd から到達できるホスト・IP か（getent ahosts と nc -vz host port で確認）、TLS 無しなら OTEL_EXPORTER_OTLP_INSECURE=true を入れたかを確認します。

届いているが service.name がおかしい。 各デーモンが自分自身の service.name を設定します。バックエンドでまとめたいなら、OTEL_RESOURCE_ATTRIBUTES=service.namespace=routerd,... でグループ化してください。service.name 自体は上書きしないでください。

routerd が出さないもの

• 同梱の OTLP コレクター。routerd の隣で別途立てるか、マネージドバックエンドを使ってください。
• 組み込みのストレージバックエンド。routerd はローカルで可視化するための SQLite ログ DB (events.db, dns-queries.db, traffic-flows.db, firewall-logs.db) を持っており、Web 管理画面から確認できます。OTLP エクスポートは「同じデータをホストの外へ送る」用途です。

宣言型の Telemetry リソース

Telemetry を使うと、OTLP エンドポイントを router の YAML に書けます。 routerd は、対応する OpenTelemetry 環境変数を、生成済みの systemd, FreeBSD rc.d の unit に入れます。 コレクターは外部で用意します。 routerd はエクスポーターの設定だけを準備します。

apiVersion: observability.routerd.net/v1alpha1
kind: Telemetry
metadata:
  name: otlp
spec:
  otlp:
    endpoint: http://collector.example.internal:4317
    insecure: true
  serviceNamespace: routerd
  attributes:
    deployment.environment: home
    site: edge
  signals: [logs, metrics, traces]

routerd 内部のイベントストリームも stdout / syslog / Loki へ転送したい場合は、 ObservabilityPipeline を使います。詳しくは Observability pipeline の運用 を参照してください。