PHPackages                             monkeyscloud/monkeyslegion-telemetry - 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. monkeyscloud/monkeyslegion-telemetry

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

monkeyscloud/monkeyslegion-telemetry
====================================

Comprehensive telemetry package with PSR-3 logging, metrics (Prometheus/StatsD), and distributed tracing for MonkeysLegion projects

2.0.0(5mo ago)11.0k↑142.9%2MITPHPPHP ^8.4

Since Jul 24Pushed 5mo ago1 watchersCompare

[ Source](https://github.com/MonkeysCloud/MonkeysLegion-Telemetry)[ Packagist](https://packagist.org/packages/monkeyscloud/monkeyslegion-telemetry)[ Docs](https://monkeyslegion.com)[ RSS](/packages/monkeyscloud-monkeyslegion-telemetry/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (1)Dependencies (7)Versions (4)Used By (2)

MonkeysLegion Telemetry
=======================

[](#monkeyslegion-telemetry)

[![PHP Version](https://camo.githubusercontent.com/02463ad42fbbb8e930dc93f83e8b2ecd9ad3f718d33bb429f5f8f792f9cfd2e5/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d253545382e342d626c75652e737667)](https://php.net)[![License](https://camo.githubusercontent.com/8bb50fd2278f18fc326bf71f6e88ca8f884f72f179d3e555e20ed30157190d0d/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d677265656e2e737667)](LICENSE)

A comprehensive telemetry package for PHP 8.4+ providing:

- **Metrics** - Counter, Gauge, Histogram, Summary with Prometheus and StatsD adapters
- **Distributed Tracing** - W3C Trace Context compatible spans and trace propagation
- **Logging** - PSR-3 compatible logging with automatic trace correlation

Table of Contents
-----------------

[](#table-of-contents)

- [Installation](#installation)
- [Quick Start](#quick-start)
- [Metrics](#metrics)
    - [Counter](#counter-monotonically-increasing)
    - [Gauge](#gauge-point-in-time-value)
    - [Histogram](#histogram-distributiontiming)
    - [Timer Helper](#timer-helper)
- [Distributed Tracing](#distributed-tracing)
    - [Simple Tracing](#simple-tracing-with-callback)
    - [Manual Span Management](#manual-span-management)
    - [Trace Context](#get-current-trace-context)
- [Logging](#logging-with-trace-correlation)
- [Direct Component Usage](#direct-component-usage)
    - [InMemoryMetrics](#inmemorymetrics-testing)
    - [PrometheusMetrics](#prometheusmetrics)
    - [StatsDMetrics](#statsdmetrics)
    - [Tracer with HTTP Exporter](#tracer-with-http-exporter)
- [PSR-15 Middleware](#psr-15-middleware)
- [PHP 8 Attributes](#php-8-attributes)
- [Complete Application Example](#complete-application-example)
- [Prometheus Endpoint](#prometheus-metrics-endpoint)
- [Configuration Reference](#configuration-reference)
- [Testing](#testing)
- [License](#license)

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

[](#installation)

```
composer require monkeyscloud/monkeyslegion-telemetry
```

### Optional Dependencies

[](#optional-dependencies)

```
# For Prometheus support
composer require promphp/prometheus_client_php

# For PSR-15 middleware
composer require psr/http-message psr/http-server-middleware
```

Quick Start
-----------

[](#quick-start)

```