oxhq/cachelet-exporter

First-party Cachelet exporter for canonical telemetry records.

v0.2.2 2026-04-24 15:17 UTC

Requires

• php: ^8.2
• illuminate/events: ^12.0|^13.0
• illuminate/http: ^12.0|^13.0
• illuminate/log: ^12.0|^13.0
• illuminate/support: ^12.0|^13.0
• oxhq/cachelet-core: ^0.2

Requires (Dev)

• orchestra/testbench: ^10.0|^11.0
• phpunit/phpunit: ^11.0

MIT

• OxHQ

• cache
• cloud
• laravel
• telemetry
• observability

README

Read-only split of the Cachelet monorepo package at packages/cachelet-exporter.

First-party Cloud exporter for Cachelet's canonical telemetry stream.

Install

composer require oxhq/cachelet-exporter

Features

• listens for CacheletTelemetryRecorded
• exports canonical cachelet.telemetry.v1 records
• ships configurable http, log, and null transports
• allows custom transport classes through the container
• publishes cachelet-exporter.php for endpoint and source metadata

Example

return [
    'enabled' => true,
    'transport' => 'http',
    'client' => [
        'endpoint' => env('CACHELET_EXPORTER_ENDPOINT'),
        'token' => env('CACHELET_EXPORTER_TOKEN'),
    ],
];

When Cachelet emits CacheletTelemetryRecorded, cachelet-exporter wraps the canonical record in cachelet.cloud.export.v1 and forwards it through the configured transport.

Custom transports

Set cachelet-exporter.transport to a class name that implements Oxhq\\Cachelet\\Exporter\\Contracts\\ExporterTransport. The service provider resolves that class through Laravel's container, so test doubles and custom adapters can be injected without patching core Cachelet code.