#เทเลเมทรี (Telemetry)

#ภาพรวม

โมดูลเทเลเมทรี (Telemetry) ของ NocoBase ถูกสร้างขึ้นบน OpenTelemetry เพื่อมอบคุณสมบัติการสังเกตการณ์ (Observability) ที่เป็นหนึ่งเดียวและขยายต่อได้สำหรับแอปพลิเคชัน NocoBase โมดูลนี้รองรับการรวบรวมและส่งออกตัวชี้วัด (Metrics) ของแอปพลิเคชันที่หลากหลาย รวมถึงคำขอ HTTP และการใช้งานทรัพยากรระบบครับ

#การกำหนดค่าตัวแปรสภาพแวดล้อม

ในการเปิดใช้งานโมดูลเทเลเมทรี คุณจำเป็นต้องกำหนดค่า ตัวแปรสภาพแวดล้อม ที่เกี่ยวข้องครับ

#TELEMETRY_ENABLED

กำหนดค่าเป็น on

TELEMETRY_ENABLED=on

#TELEMETRY_SERVICE_NAME

ชื่อบริการ (Service name)

TELEMETRY_SERVICE_NAME=nocobase

#TELEMETRY_METRIC_READER

ตัวส่งออกตัวชี้วัด (Metric exporters) รองรับการใช้งานหลายตัวโดยคั่นด้วยเครื่องหมายจุลภาค (comma) สำหรับค่าที่เลือกใช้ได้ โปรดอ้างอิงจากเอกสารของตัวส่งออกที่มีอยู่ครับ

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) มีหน่วยเป็นมิลลิวินาที (ms) ค่าเริ่มต้นคือ 0 ซึ่งหมายถึงการบันทึกทุกคำขอ หากกำหนดค่ามากกว่า 0 จะบันทึกเฉพาะคำขอที่มีระยะเวลาเกินเกณฑ์ที่กำหนดเท่านั้นครับ

TELEMETRY_HTTP_RECORD_THRESHOLD=1000

#ตัวชี้วัด

รายการตัวชี้วัดที่บันทึกในแอปพลิเคชันปัจจุบันมีดังนี้ หากคุณต้องการเพิ่มเติม สามารถอ้างอิงได้จาก เอกสารการพัฒนา เพื่อทำการขยายส่วนขยาย หรือติดต่อเราได้ครับ