> ## Documentation Index
> Fetch the complete documentation index at: https://factory-docs-auto-sync-jp-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

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

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

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

***

## 設定

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

```bash theme={null}
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とお客様のコレクターの両方にファンアウトされますが（上記参照）、メッセージ内容はそうではありません。

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

```bash theme={null}
export OTEL_LOG_MESSAGE_CONTENT=true   # または 1
```

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

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

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

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

***

## 設定例

<AccordionGroup>
  <Accordion title="Generic OTEL Collector / Grafana Alloy">
    ```bash theme={null}
    export OTEL_TELEMETRY_ENDPOINT="https://collector.example.com:4318"
    ```
  </Accordion>

  <Accordion title="Datadog (via Agent OTLP ingestion)">
    ```bash theme={null}
    export OTEL_TELEMETRY_ENDPOINT="http://localhost:4318"
    ```
  </Accordion>

  <Accordion title="Datadog (direct OTLP intake)">
    ```bash theme={null}
    export OTEL_TELEMETRY_ENDPOINT="https://otlp.datadoghq.com"
    export OTEL_TELEMETRY_HEADERS="dd-api-key=<your-datadog-api-key>"
    ```
  </Accordion>

  <Accordion title="New Relic">
    ```bash theme={null}
    export OTEL_TELEMETRY_ENDPOINT="https://otlp.nr-data.net:4318"
    export OTEL_TELEMETRY_HEADERS="api-key=<your-new-relic-license-key>"
    ```
  </Accordion>

  <Accordion title="Honeycomb">
    ```bash theme={null}
    export OTEL_TELEMETRY_ENDPOINT="https://api.honeycomb.io"
    export OTEL_TELEMETRY_HEADERS="x-honeycomb-team=<your-api-key>,x-honeycomb-dataset=droid-metrics"
    ```
  </Accordion>
</AccordionGroup>

***

## トラブルシューティング

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