ข้ามไปยังเนื้อหาหลัก

ความสามารถในการสังเกต

มีสองทาง: log local แบบมีโครงสร้างบน stdout/stderr และ exporter OpenTelemetry ที่ไม่บังคับสำหรับ HTTP, durable jobs, counter และ record warning/error ไม่มีสิ่งใดส่งไปโครงการ Libre WebUI หากไม่มี endpoint OpenTelemetry จะปิด System และ usage แยกกัน

Log แบบมีโครงสร้าง​

LOG_FORMAT=text สร้าง text ปกติ LOG_FORMAT=json สร้าง JSON หนึ่งรายการต่อบรรทัด:

LOG_LEVEL=info
LOG_FORMAT=json

แต่ละ record มีเวลา ISO, level/scope, message, request/job correlation ID และรายละเอียดจำกัด ทุก HTTP request มี X-Request-Id รับตัวอักษร/เลข/./_/- 8–64 ตัว มิฉะนั้นใช้ UUID Query string ถูกลบ

LOG_LEVEL: silent, error, warn, info, debug ปกป้อง debug log เหมือนข้อมูล

ขอบเขต Redaction​

Field ที่คล้าย password, secret, token, key, authorization, cookie, credential, bearer หรือ JWT ถูกลบ string จำกัด 512 ตัวอักษร array, depth, attribute ก็จำกัด error เหลือเพียงชื่อและ message สั้น นี่คือ defense in depth ไม่ใช่อนุญาตให้ log prompt ให้ log ID และ outcome จำกัด access และ retention

OpenTelemetry​

OTEL_EXPORTER_OTLP_ENDPOINT=https://otel-collector.example.com:4318
OTEL_EXPORTER_OTLP_HEADERS=authorization=Bearer example-collector-token
OTEL_SERVICE_NAME=libre-webui

เพิ่ม /v1/traces, /v1/metrics และ /v1/logs ต่อ URL OTEL_EXPORTER_OTLP_HEADERS เป็นรายการ key=value คั่นด้วย comma เก็บ secret เป็น deployment secret OTEL_SERVICE_NAME ค่าเริ่มต้น libre-webui

ไม่มี endpoint ทุกอย่างเป็น no-op ใน mode team app และ worker ส่งออกแยกกัน

สัญญาณ​

HTTP span/counter, durable-job span/counter และ record warning/error ที่ redact แล้วพร้อม correlation ID ไม่มี trace-parent propagation, tree ข้ามบริการ หรือ instrumentation browser/provider เต็ม Token/media usage อยู่ใน analytics และ ค่าใช้จ่าย local

การส่ง​

สูงสุด 2,048 span/record, 512 series; flush ราว 5 วินาที timeout 3 วินาที Error ทิ้ง batch โดยไม่ทำลาย request นี่ไม่ใช่ audit หรือ accounting

การแก้ปัญหา​

ตรวจ OTEL_EXPORTER_OTLP_ENDPOINT, path มาตรฐานสามรายการ และ authorization=Bearer ... Restart หลังเปลี่ยน environment Request ตั้งใจให้ทำงานต่อเมื่อ collector ล้มเหลว Field หาย/ถูกตัดเกิดจาก redaction

เอกสารที่เกี่ยวข้อง​