overview.md 2.0 KB

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 自動 バージョン

データフロー

  1. Auto Instrumentation でHTTP/DB操作を自動計測
  2. NodeSDK がスパン・メトリクスを収集
  3. OTLP Exporter が外部Collectorに送信

制限事項

  • 機密データの匿名化未実装
  • GROWIアプリ固有の情報未送信

参考情報


更新日: 2025-06-19