Trace và log OpenTelemetry, lưu cạnh lỗi của bạn

Trả lời nhanh#

• Gửi trace và log bằng OpenTelemetry SDK chuẩn hoặc Collector qua OTLP/HTTP.

• Chúng được lưu trên node cạnh lỗi, và một issue mở được trace của nó cùng các dòng log xung quanh.

• Xác thực bằng ingest key bvi_, loại khoá chỉ gửi được dữ liệu.

• Không có metrics, không có tracing trên trình duyệt và không phải APM đầy đủ.

Bạn có gì#

• Trace. Danh sách trace và span kèm biểu đồ theo thời gian, lọc theo project, môi trường, service và thời gian, và waterfall mọi span của một trace.

• Log. Tìm theo chữ, service, môi trường, mức độ hoặc trace id, và mở các dòng ghi ngay trước và sau một dòng.

• Lỗi nối với cả hai. Event lỗi có trace id mở được trace của nó với span lỗi được tô, cùng các dòng log.

• Bằng chứng kết nối. Tab Kết nối của project liệt kê service nào đã gửi trace hoặc log, bằng SDK nào và lần cuối khi nào (tổng quan OpenTelemetry).

Cài đặt là exporter chuẩn#

Tạo ingest key (bắt đầu bằng bvi_, chỉ hiện một lần và chỉ gửi được dữ liệu), rồi trỏ OTLP exporter tới Belvador bằng các biến môi trường chuẩn:

export OTEL_EXPORTER_OTLP_ENDPOINT=https://ingest.belvador.dev/otlp/<project-id>export OTEL_EXPORTER_OTLP_PROTOCOL=http/protobufexport OTEL_EXPORTER_OTLP_HEADERS=Authorization=Bearer%20<your-ingest-key>export OTEL_TRACES_EXPORTER=otlpexport OTEL_LOGS_EXPORTER=otlpexport OTEL_METRICS_EXPORTER=noneexport OTEL_SERVICE_NAME=my-serviceexport OTEL_RESOURCE_ATTRIBUTES=deployment.environment.name=production

Không cần gói Belvador nào cho trace và log. Hướng dẫn theo runtime: Node.js, Python, Go, Java, Collector — hoặc bắt đầu từ hướng dẫn nhanh.

Runtime đã kiểm thử#

"Đã kiểm thử" nghĩa là chúng tôi đã chạy phiên bản SDK đó với Belvador và đọc lại dữ liệu. Endpoint OTLP trả 200 khi edge đã nhận bền vững một batch; node vẫn có thể bỏ bớt dòng khi vượt giới hạn, và trang usage hiện số dòng bị bỏ (tham chiếu OTLP).

Kiểm soát dung lượng#

Trong beta, mỗi workspace lưu được 5 GB trace và 5 GB log mỗi tháng, giữ 7 ngày. Sampling ở SDK hoặc Collector là cách kiểm soát chính; hướng dẫn có cấu hình giữ trace của các request lỗi và bỏ bớt trace thường (sampling và chi phí). Thông lượng đo được ở trang benchmark.

Không phải là#

• Không có metrics. Metrics OTLP bị từ chối; đặt OTEL_METRICS_EXPORTER=none.

• Không tracing trên trình duyệt. Ingest key là bí mật; chỉ gửi từ server, worker và Collector.

• Không phải APM đầy đủ. Không có service map, profiling hay session replay. Trace và log được giữ để debug, trong thời gian có hạn.

• Chỉ OTLP/HTTP, protobuf hoặc JSON.

Câu hỏi thường gặp#

Dùng OpenTelemetry có phải bỏ Sentry không?#

Không. Giữ Sentry SDK cho lỗi và thêm OpenTelemetry cho trace và log; khi dùng chung, lỗi mang trace id của span đang chạy (Sentry cùng OpenTelemetry).

Trace được lưu ở đâu?#

Trên node của bạn, như lỗi. Khi node không liên lạc được, edge giữ các batch đã niêm phong bằng khoá của node.