Fluxheim/Tài liệu/Quan sát hệ thống

Quan sát hệ thống

Dùng Prometheus và OpenTelemetry để xem lưu lượng tổng hợp, lỗi, lượt tải xuống và mức sử dụng trang mà không theo dõi từng khách truy cập.

Prometheus metric

[metrics]
enabled = true
listen = "127.0.0.1:9100"

xuất OTLP

FLUXHEIM_OTLP=enabled
OTEL_EXPORTER_OTLP_ENDPOINT=http://otel-collector:4318
OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf
OTEL_METRIC_EXPORT_INTERVAL=5000

The quan sát hệ thống compose stack sets these for the website service. Set FLUXHEIM_OTLP=disabled to run the same binary without exporting metric or traces.

Phiên bản 1.6.37 làm local observability smoke đáng tin cậy hơn bằng cách thử lại các lần khởi động Prometheus và Jaeger tạm thời với cổng mới khi cổng host-network cạnh tranh với process runner khác.

Giữ labels có cardinality thấp: route group, language, status class, download artifact và GitHub target đều hữu ích. Không có raw IP address hoặc user identifier.

Bảng điều khiển có gì

Tín hiệuTại sao nó quan trọng
request theo routeShows which công khai pages and docs are being used.
request theo localeHiển thị ngôn ngữ nào cần được chăm sóc nhiều nhất.
status classHiển thị lỗi mà không theo dõi người dùng cá nhân.
Download clicksHiển thị các tạo phẩm phát hành nào hữu ích.
Số lần nhấp vào GitHubHiển thị những liên kết dự án bên ngoài nào quan trọng.

ranh giới quyền riêng tư

  • Dùng bộ đếm tổng hợp và histogram thay cho log request thô.
  • Do not label metrics with IP addresses, user agents, or full URLs.
  • Giữ trình nghe Prometheus và OTLP ở chế độ loopback hoặc mạng nội bộ.
  • Hiển thị hành vi theo dõi trên trang quyền riêng tư và cookie.
Tiếng Việt