テレメトリエクスポート（OTEL）

Droidから独自のOTLP互換コレクターへOpenTelemetryメトリクスをエクスポートし、既存のオブザーバビリティスタックで完全に可視化する。

Droidは、OpenTelemetry (OTEL) メトリクスをお客様のOTLP対応コレクターにエクスポートすることができ、既存の可観測性スタック内でDroidアクティビティの完全な可視性を提供します。メトリクスは同じエクスポートサイクルでFactoryのコレクターとお客様のコレクター両方に送信されます。お客様のコレクターにアクセスできない場合でも、Factoryのエクスポートは影響を受けません。

---

​

設定

Droidを起動する前に、以下の環境変数を設定してください：

export OTEL_TELEMETRY_ENDPOINT="https://your-collector.example.com:4318"
export OTEL_TELEMETRY_HEADERS="Authorization=Bearer <your-token>"

Variable	必須	Description
OTEL_TELEMETRY_ENDPOINT	Yes	OTLP HTTPコレクターのベースURL。メトリクスは{endpoint}/v1/metricsに送信されます。
OTEL_TELEMETRY_HEADERS	No	すべてのエクスポートでHTTPヘッダーとして送信されるカンマ区切りのkey=valueペア。値には=を含めることができます（例：base64トークン）。
OTEL_LOG_MESSAGE_CONTENT	No	trueまたは1に設定すると、メッセージ内容（ユーザー / アシスタントのメッセージ、ツールの入力 / 結果）がOTELトレーススパンとしてお客様のエンドポイントにのみエクスポートされ、Factoryには送信されません。OTEL_TELEMETRY_ENDPOINTが必要で、エンドポイントが設定されていない場合は内容は破棄されます。

---

​

仕組み

• OTEL_TELEMETRY_ENDPOINTが設定されている場合、メトリクスはファンアウトエクスポーターを介して同じエクスポートサイクルでお客様のエンドポイントに送信されます。追加のタイマーやメトリクスリーダーの重複はありません。
• お客様のコレクターへの障害は、Factoryの独自エクスポートに影響しません。各エンドポイントは分離されています。
• メトリクスはデルタテンポラリティを使用します。各エクスポートには、最後のフラッシュ以降の新しい値のみが含まれます（60秒間隔）。

---

​

エクスポートされるメトリクス

すべてのメトリクスはdroid.*名前空間を使用します。

Metric	Type	Description
droid.code.files_modified	Counter	セッション中に変更されたファイル数
droid.code.files_read	Counter	セッション中に読み取られたファイル数
droid.code.lines_modified	Counter	変更されたコード行数
droid.git.commits	Counter	作成されたコミット数
droid.git.pull_requests	Counter	作成されたプルリクエスト数
droid.tool.invocations	Counter	ツール呼び出し数
droid.tool.execution_time	Histogram	ツール実行時間（ミリ秒）
droid.mcp.tool_invocations	Counter	MCPツール呼び出し数
droid.skill.invocations	Counter	スキル呼び出し数
droid.hook.invocations	Counter	フック呼び出し数
droid.slash_command.invocations	Counter	スラッシュコマンド呼び出し数
droid.auth.login_success	Counter	ログイン成功数
droid.repo.metadata	Gauge	リポジトリメタデータスナップショット

---

​

共通属性

すべてのデータポイントには、以下の属性が自動的に含まれます：

Attribute	Description
user.id	認証済みユーザーID
organization.id	組織ID
session.id	現在のDroidセッションID

ツール固有の属性（tool.name、mcp.server、skill.nameなど）は該当する場合に含まれます。リソース属性にはservice.name（cli）とservice.versionが含まれます。

---

​

メッセージ内容のロギング

デフォルトでは、テレメトリエクスポートに含まれるのはメトリクスのみで、プロンプトのテキスト、モデルの応答、ツールI/Oはエクスポートされません。メトリクスはFactoryとお客様のコレクターの両方にファンアウトされますが（上記参照）、メッセージ内容はそうではありません。

メッセージ内容（たとえばセッション監査用）を取得するには、次を設定します。

export OTEL_LOG_MESSAGE_CONTENT=true   # または 1

有効にすると、Droidはメッセージ内容をOTELのトレーススパンとして（お客様のエンドポイントの/v1/tracesパスへ）出力し、次を対象にします。

• ユーザーメッセージ（droid.message.user）
• アシスタントの応答（droid.message.assistant）
• ツール呼び出しとその入力（droid.tool.call）
• ツールの結果（droid.tool.result）

メッセージ内容は、設定したコレクターにのみ送信され、Factoryに届くことはありません。 メトリクスとは異なり、内容スパンはOTEL_TELEMETRY_ENDPOINTにのみルーティングされ、Factoryのコレクターが送信先になることはありません。

• お客様のエンドポイント（OTEL_TELEMETRY_ENDPOINT）が必須です。設定されていない場合、内容はFactoryへ送信されるのではなく破棄されます。
• エンドポイントがFactoryのコレクターと同じURLに解決される場合、内容のロギングは自動的に無効になります。
• メトリクスのエクスポートは影響を受けず、引き続きFactoryとお客様のコレクターの両方へファンアウトされます。

---

​

設定例

Generic OTEL Collector / Grafana Alloy

export OTEL_TELEMETRY_ENDPOINT="https://collector.example.com:4318"

Datadog (via Agent OTLP ingestion)

export OTEL_TELEMETRY_ENDPOINT="http://localhost:4318"

Datadog (direct OTLP intake)

export OTEL_TELEMETRY_ENDPOINT="https://otlp.datadoghq.com"
export OTEL_TELEMETRY_HEADERS="dd-api-key=<your-datadog-api-key>"

New Relic

export OTEL_TELEMETRY_ENDPOINT="https://otlp.nr-data.net:4318"
export OTEL_TELEMETRY_HEADERS="api-key=<your-new-relic-license-key>"

Honeycomb

export OTEL_TELEMETRY_ENDPOINT="https://api.honeycomb.io"
export OTEL_TELEMETRY_HEADERS="x-honeycomb-team=<your-api-key>,x-honeycomb-dataset=droid-metrics"

---

​

トラブルシューティング

• コレクターが/v1/metricsパスでOTLP HTTPを受け入れることを確認してください。
• OTEL_TELEMETRY_HEADERSに有効な認証クレデンシャルが含まれていることを確認してください。
• Droidを実行しているマシンからコレクターへのネットワーク接続を確保してください。