AI翻訳通知

このドキュメントはAIによって翻訳されました。正確な情報については英語版をご参照ください。

テレメトリ

テレメトリEnterprise Edition+

概要

NocoBase のテレメトリ (Telemetry) モジュールは OpenTelemetry に基づいて構築されており、NocoBase アプリケーションに統一された拡張可能なオブザーバビリティ(可観測性)を提供します。このモジュールは、HTTP リクエストやシステムリソースの使用状況など、さまざまなアプリケーションメトリクスの収集とエクスポートをサポートしています。

環境変数の設定

テレメトリモジュールを有効にするには、関連する 環境変数 を設定する必要があります。

TELEMETRY_ENABLED

on に設定します。

TELEMETRY_ENABLED=on

TELEMETRY_SERVICE_NAME

サービス名。

TELEMETRY_SERVICE_NAME=nocobase

TELEMETRY_METRIC_READER

メトリクスエクスポーター。カンマ区切りで複数のエクスポーターをサポートします。利用可能な値については、既存のエクスポーターのドキュメントを参照してください。

TELEMETRY_METRIC_READER=console,http,prometheus

TELEMETRY_METRICS

エクスポートするメトリクス。カンマ区切りで指定します。利用可能な値については、メトリクス を参照してください。

TELEMETRY_METRICS=http_request_cost,process_cpu_percent,process_memory_mb,process_heap_mb,sub_app_status

TELEMETRY_HTTP_RECORD_THRESHOLD

HTTP リクエスト所要時間 (http_request_cost) の記録しきい値(ミリ秒単位)。デフォルト値は 0 で、すべてのリクエストを記録します。0 より大きい値を設定すると、所要時間がそのしきい値を超えたリクエストのみが記録されます。

TELEMETRY_HTTP_RECORD_THRESHOLD=1000

メトリクス

現在アプリケーションで記録されているメトリクスは以下の通りです。さらに必要な場合は、開発ドキュメント を参照して拡張するか、お問い合わせください。

メトリクス名メトリクスタイプ説明
process_cpu_percentObservableGaugeプロセスの CPU 使用率(パーセント)
process_memory_mbObservableGaugeプロセスのメモリ使用量(MB 単位)
process_heap_mbObservableGaugeプロセスのヒープメモリ使用量(MB 単位)
http_request_costHistogramHTTP リクエストの所要時間(ms 単位)
http_request_countCounterHTTP リクエスト数
http_request_activeUpDownCounter現在のアクティブな HTTP リクエスト数
sub_app_statusObservableGaugeステータスごとのサブアプリケーション数の統計。plugin-multi-app-manager プラグインによって報告されます。