Skip to content

v0.1.0-alpha.1 — first public alpha

Pre-release
Pre-release

Choose a tag to compare

View all tags
@sylvesterdamgaard sylvesterdamgaard released this 03 Jul 07:40
v0.1.0-alpha.1
77576ec

First public release — alpha. The public API may still change before the 1.0 stability guarantee, but the core is feature-complete and covered by 249 tests.

Collector-free telemetry for Laravel: Prometheus metrics, OTLP traces and structured events/logs from a plain Composer package. No C extension, no OTel SDK, no protobuf, no sidecar. Metrics work under shared-nothing FPM because state lives in a shared store (Redis/APCu), not the PHP process.

Highlights

  • Metrics — counters, push/observable gauges and histograms over a shared store (Redis / APCu / array), scraped at /telemetry/metrics or pushed via OTLP.
  • Tracing — automatic spans for requests, queue jobs, DB queries & transactions, commands, scheduled tasks, views, cache, outgoing HTTP and Redis, with full W3C traceparent propagation into queued jobs. Per-span CPU/memory attribution.
  • Events & logs — structured events and a telemetry log channel exported as trace-correlated OTLP log records.
  • Redaction engine — every attribute, exception message and log record passes one choke point before export; key- and pattern-based scrubbing (JWTs, credentials, url userinfo) plus a custom hook.
  • The trace id as a support reference — X-Trace-Id response header, trace_id in Laravel Context (Sentry/Flare/logs pick it up), and error-page correlation.
  • Container/k8s/cloud resource detection and self-observability metrics (the package reports on its own export health).
  • 13 bundled Grafana dashboards (APM-style), importable with telemetry:dashboards.
  • High-traffic mode — a Redis spool + telemetry:flush --daemon for sub-second span shipping.
  • Octane-safe (Swoole / RoadRunner / FrankenPHP). Telemetry never throws into your app.

Requirements

PHP ^8.3–8.5, Laravel ^12/^13. Redis recommended for the metric store (APCu or array also supported).

Install

composer require cboxdk/laravel-telemetry:^0.1.0-alpha.1

See the documentation to get started, and the local LGTM stack cookbook to see your first trace in a minute.

Feedback

This is an alpha — bug reports and API feedback are very welcome via issues.

Full changelog: CHANGELOG.md

Assets 2
Loading