Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

feat(export): OTLP/JSON exporter for OpenTelemetry integration

Đang mở
  • Có gì không ổn?
#140 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Chưa có ai nhận issue này.

Đánh giá

Độ khó
4/5
Thời gian dự kiến
3-5 ngày
Mức phù hợp với người mới
52/100
Loại issue
Tính năng
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Ít trao đổi
Công nghệ
javascript
Lĩnh vực
observability

Hướng nghiên cứu

Bắt đầu với interface LogExporter từ #139 và điểm vào cấu hình userale.start được trình bày trong issue. Theo dõi cách exporterType và otlpEndpoint được xử lý, sau đó triển khai các ánh xạ Flagon-to-OTLP đã được tài liệu hóa và xác minh rằng các log đến endpoint /v1/logs tiêu chuẩn với cấu trúc JSON được chỉ định.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

enhancement Userale

Summary

Implement an OtlpJsonExporter that sends UserALE logs to any OpenTelemetry Collector via OTLP/HTTP JSON.

Motivation

OpenTelemetry is the de-facto standard for observability. OTLP support lets Flagon users send behavioral data to Grafana, Datadog, Jaeger, and any OTel-compatible backend — without building custom ingestion pipelines.

No competing behavioral analytics library (PostHog, Matomo, Plausible) speaks OTLP. This is a differentiation opportunity.

Design

  • Maps Flagon log fields → OTLP LogRecord attributes using OTel semantic conventions
  • Builds OTLP/JSON payloads using plain objects (zero external dependencies)
  • Ships to standard OTLP HTTP receiver (port 4318, /v1/logs)
  • ~150 lines of code, ~2-3 KB gzipped added to bundle

Attribute Mapping

Flagon Field OTLP Mapping
clientTime timeUnixNano
toolName resource.service.name
useraleVersion resource.telemetry.sdk.version
userId attributes.enduser.id
sessionId attributes.session.id
pageUrl attributes.url.full
target attributes.flagon.dom.target
type attributes.flagon.event_type
logType attributes.flagon.log_type
details body (JSON string)

User Experience

// One config change to enable OTLP
userale.start({
  exporterType: 'otlp',
  otlpEndpoint: 'http://localhost:4318',
});

Depends On

  • #139 (LogExporter interface)
Ngôn ngữ chính
Jupyter Notebook
Star
30
Fork
15
Merge trung bình
7 ngày 11 giờ
Pull request đã merge (30 ngày)
2

Chuẩn bị môi trường

Dự án này không cung cấp dev container, Dockerfile hay hướng dẫn đóng góp, nên bạn cần tự thiết lập môi trường: hãy bắt đầu từ README và xem hướng dẫn đóng góp lần đầu của chúng tôi để biết các bước chung.

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của apache/flagon

Tất cả issue của apache/flagon

Issue tương tự

Thêm issue về Observability & SRE

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.