Gözlemlenebilirlik
İki yol vardır: stdout/stderr üzerinde yapılandırılmış yerel günlükler ve HTTP, kalıcı işler, sayaçlar ile uyarı/hata kayıtları için isteğe bağlı OpenTelemetry dışa aktarıcısı. Libre WebUI projesine hiçbir veri gönderilmez; uç nokta olmadan OpenTelemetry kapalıdır. Sistem ve kullanım ayrı olarak açıklanır.
Yapılandırılmış günlükler
LOG_FORMAT=text normal metin, LOG_FORMAT=json ise satır başına JSON üretir:
LOG_LEVEL=info
LOG_FORMAT=json
Kayıtlarda ISO zamanı, düzey/kapsam, ileti, istek veya iş ilişkilendirme ID’si ve sınırlı ayrıntılar bulunur. Her HTTP isteğinde X-Request-Id vardır; 8–64 harf, rakam, ., _ ve - kabul edilir, aksi durumda UUID kullanılır. Sorgu dizesi çıkarılır.
LOG_LEVEL değerleri: silent, error, warn, info, debug. Hata ayıklama günlüklerini veri gibi koruyun.
Sansürleme sınırı
Parola, gizli değer, belirteç, anahtar, yetkilendirme, cookie, kimlik bilgisi, bearer veya JWT’ye benzeyen alanlar çıkarılır; dizeler 512 karakterle, diziler, derinlik ve öznitelikler de sınırlarla kısıtlanır; hata yalnızca ad ve kısa ileti bırakır. Bu, katmanlı savunmadır; istemleri günlükleme izni değildir. ID’leri ve sonuçları günlükleyin, erişimi ve saklama süresini sınırlandırın.
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
URL’ye /v1/traces, /v1/metrics ve /v1/logs eklenir. OTEL_EXPORTER_OTLP_HEADERS, virgülle ayrılmış key=value listesidir. Gizli değerleri dağıtım sırları olarak saklayın. OTEL_SERVICE_NAME varsayılan olarak libre-webui değerini kullanır.
Uç nokta yoksa her şey etkisizdir. team modunda uygulama ve worker ayrı ayrı dışa aktarır.
Sinyaller
HTTP kapsamları ve sayaçları, kalıcı iş kapsamları ve sayaçları ile ilişkilendirme ID’leri içeren sansürlenmiş uyarı/hata kayıtları üretilir. Üst iz bağlamının yayılması, hizmetler arası ağaçlar veya tarayıcı/sağlayıcı için tam enstrümantasyon yoktur. Belirteç ve medya kullanımı yerel analitik ve maliyet sayfalarında bulunur.
Teslimat
En fazla 2.048 kapsam ve kayıt, 512 seri; yaklaşık 5 saniyede bir boşaltma; 3 saniyelik zaman aşımı. Hata, grubu atar ancak isteği bozmaz. Bu bir denetim veya muhasebe sistemi değildir.
Sorun giderme
OTEL_EXPORTER_OTLP_ENDPOINT, üç standart yolu ve authorization=Bearer ... değerini denetleyin. Ortam değişikliğinden sonra yeniden başlatın. Toplayıcı çöktüğünde isteklerin çalışmaya devam etmesi tasarlanmış davranıştır. Eksik veya kısaltılmış alanlar sansürleme sınırlarından kaynaklanır.