OpenTelemetry Overview
現在の実装状況
基本機能
- ✅ Trace収集: HTTP、Database等の自動インストルメンテーション
- ✅ Metrics収集: 基本的なアプリケーションメトリクス
- ✅ OTLP Export: gRPCでのデータ送信
- ✅ 設定管理: 環境変数による有効/無効制御
アーキテクチャ
[GROWI App] → [NodeSDK] → [Auto Instrumentations] → [OTLP Exporter] → [Collector]
実装ファイル
| ファイル |
責務 |
node-sdk.ts |
SDK初期化・管理 |
node-sdk-configuration.ts |
設定生成 |
node-sdk-resource.ts |
リソース属性管理 |
logger.ts |
診断ログ |
設定項目
| 環境変数 |
デフォルト |
説明 |
OTEL_ENABLED |
false |
有効/無効 |
OTEL_EXPORTER_OTLP_ENDPOINT |
http://localhost:4317 |
エクスポート先 |
OTEL_SERVICE_NAME |
growi |
サービス名 |
OTEL_SERVICE_VERSION |
自動 |
バージョン |
データフロー
- Auto Instrumentation でHTTP/DB操作を自動計測
- NodeSDK がスパン・メトリクスを収集
- OTLP Exporter が外部Collectorに送信
制限事項
- 機密データの匿名化未実装
- GROWIアプリ固有の情報未送信
参考情報
更新日: 2025-06-19