PHPackages                             ortic/telemetry-client - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Logging & Monitoring](/categories/logging)
4. /
5. ortic/telemetry-client

ActiveLibrary[Logging & Monitoring](/categories/logging)

ortic/telemetry-client
======================

Laravel package to send error telemetry data to an Ortic telemetry server

027PHP

Since Apr 10Pushed 2mo agoCompare

[ Source](https://github.com/ortic/telemetry-client)[ Packagist](https://packagist.org/packages/ortic/telemetry-client)[ RSS](/packages/ortic-telemetry-client/feed)WikiDiscussions master Synced 3w ago

READMEChangelogDependenciesVersions (1)Used By (0)

Ortic Telemetry Client
======================

[](#ortic-telemetry-client)

A Laravel package that automatically captures and sends error telemetry data to your Ortic telemetry server. Install, configure two environment variables, and all unhandled exceptions are reported automatically.

Installation
------------

[](#installation)

### 1. Add the package via Composer

[](#1-add-the-package-via-composer)

```
composer require ortic/telemetry-client
```

For **local development** with a path repository:

```
{
    "repositories": [
        {
            "type": "path",
            "url": "../telemetry-client"
        }
    ]
}
```

```
composer require ortic/telemetry-client:@dev
```

### 2. Publish the config (optional)

[](#2-publish-the-config-optional)

```
php artisan vendor:publish --tag=telemetry-config
```

This creates `config/telemetry.php` where you can customize ignored exceptions, timeout, etc.

### 3. Configure environment variables

[](#3-configure-environment-variables)

Add these to your `.env` file (get these values from the Ortic telemetry project setup wizard):

```
TELEMETRY_DSN=your-dsn-token-here
TELEMETRY_ENDPOINT=https://your-ortic-instance.com/api/telemetry/ingest
```

That's it! All unhandled exceptions will now be reported automatically.

Optional Configuration
----------------------

[](#optional-configuration)

```
# Disable telemetry (e.g. for local dev)
TELEMETRY_ENABLED=false

# Override the environment name (defaults to APP_ENV)
TELEMETRY_ENVIRONMENT=staging

# Set a custom server name (defaults to hostname)
TELEMETRY_SERVER_NAME=web-01

# HTTP timeout in seconds (default: 5)
TELEMETRY_TIMEOUT=5

# Enable performance tracing (default: false)
TELEMETRY_TRACING_ENABLED=true

# Fraction of requests to trace: 1.0 = all, 0.1 = 10% (default: 1.0)
TELEMETRY_TRACING_SAMPLE_RATE=1.0

# Only send transactions longer than this (in ms, default: 0 = all)
TELEMETRY_TRACING_MIN_DURATION=0
```

Manual Reporting
----------------

[](#manual-reporting)

You can also manually report exceptions or caught errors:

```
use Ortic\TelemetryClient\Facades\Telemetry;

try {
    // risky operation
} catch (\Exception $e) {
    Telemetry::reportException($e, [
        'order_id' => $order->id,
        'payment_method' => 'stripe',
    ]);
}
```

What Gets Sent
--------------

[](#what-gets-sent)

Each error report includes:

- **Exception class** and message
- **File and line** where the exception occurred
- **Stack trace** (up to 50 frames)
- **Request URL**, method, and user agent
- **Server name** and environment
- **Authenticated user** ID and email (if available)
- **Custom extra data** you attach manually

Ignored Exceptions
------------------

[](#ignored-exceptions)

By default, these exception types are **not** reported (configurable in `config/telemetry.php`):

- `NotFoundHttpException` (404s)
- `MethodNotAllowedHttpException` (405s)
- `ValidationException`
- `AuthenticationException`

How It Works
------------

[](#how-it-works)

1. The package registers a singleton `TelemetryClient` via Laravel's service container
2. During boot, it hooks into Laravel's exception handler using `reportable()`
3. When an unhandled exception occurs, the client builds a JSON payload and sends it via HTTP POST to your telemetry endpoint
4. The telemetry server groups errors by fingerprint (`sha256(class + message + file + line)`) and tracks frequency
5. All HTTP errors are caught silently — **telemetry will never break your application**

Requirements
------------

[](#requirements)

- PHP 8.1+
- Laravel 10, 11, or 12
- Guzzle 7+

###  Health Score

21

—

LowBetter than 18% of packages

Maintenance57

Moderate activity, may be stable

Popularity7

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity12

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/9288570e91c034c82414fc2085a87344711e329feb063d21ab7b18ece811234e?d=identicon)[Remo](/maintainers/Remo)

---

Top Contributors

[![Remo](https://avatars.githubusercontent.com/u/129864?v=4)](https://github.com/Remo "Remo (7 commits)")

### Embed Badge

![Health badge](/badges/ortic-telemetry-client/health.svg)

```
[![Health](https://phpackages.com/badges/ortic-telemetry-client/health.svg)](https://phpackages.com/packages/ortic-telemetry-client)
```

###  Alternatives

[psr/log

Common interface for logging libraries

10.4k1.2B10.8k](/packages/psr-log)[open-telemetry/api

API for OpenTelemetry PHP.

1938.5M261](/packages/open-telemetry-api)[open-telemetry/sdk

SDK for OpenTelemetry PHP.

2326.5M315](/packages/open-telemetry-sdk)[illuminated/console-logger

Logging and Notifications for Laravel Console Commands.

8676.7k](/packages/illuminated-console-logger)[relaxart/monolog-docker-handler

Docker handler for monolog

1442.6k](/packages/relaxart-monolog-docker-handler)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)