Telemetri

TelemetriEnterprise Edition+

Ikhtisar

Modul Telemetri NocoBase didasarkan pada OpenTelemetry, menyediakan kemampuan observability terpadu dan extensible untuk aplikasi NocoBase. Modul ini mendukung pengumpulan dan ekspor berbagai metric aplikasi, termasuk HTTP request, penggunaan resource sistem, dan lainnya.

Konfigurasi Variabel Lingkungan

Untuk mengaktifkan modul Telemetri, Anda perlu mengkonfigurasi variabel lingkungan terkait.

TELEMETRY_ENABLED

Konfigurasikan sebagai on.

TELEMETRY_ENABLED=on

TELEMETRY_SERVICE_NAME

Nama service.

TELEMETRY_SERVICE_NAME=nocobase

TELEMETRY_METRIC_READER

Metric exporter, mendukung beberapa exporter, dipisahkan dengan koma. Untuk nilai opsional, lihat dokumen exporter yang ada.

TELEMETRY_METRIC_READER=console,http,prometheus

TELEMETRY_METRICS

Metric yang perlu di-export, dipisahkan dengan koma. Untuk nilai opsional, lihat Metric.

TELEMETRY_METRICS=http_request_cost,process_cpu_percent,process_memory_mb,process_heap_mb,sub_app_status

TELEMETRY_HTTP_RECORD_THRESHOLD

Threshold pencatatan durasi HTTP request (http_request_cost), satuan milidetik. Nilai default 0, artinya mencatat semua request. Saat diatur ke nilai lebih besar dari 0, hanya mencatat request yang durasinya melebihi threshold tersebut.

TELEMETRY_HTTP_RECORD_THRESHOLD=1000

Metric

Saat ini metric yang dicatat dalam aplikasi adalah sebagai berikut. Jika Anda memiliki kebutuhan lebih, Anda dapat merujuk ke dokumen pengembangan untuk melakukan ekstensi, atau hubungi kami.

Nama metricTipe metricDeskripsi
process_cpu_percentObservableGaugePersentase penggunaan CPU proses
process_memory_mbObservableGaugePenggunaan memori proses, satuan MB
process_heap_mbObservableGaugePenggunaan heap memory proses, satuan MB
http_request_costHistogramDurasi HTTP request, satuan ms
http_request_countCounterJumlah HTTP request
http_request_activeUpDownCounterJumlah HTTP request aktif saat ini
sub_app_statusObservableGaugeStatistik jumlah sub-app dengan status berbeda saat ini, dilaporkan oleh Plugin plugin-multi-app-manager