kislayphp/metrics

High-performance C++ PHP extension providing comprehensive metrics collection and monitoring for PHP microservices

0.0.3 2026-03-14 16:46 UTC

Requires

• php: >=8.2

Suggests

• kislayphp/config: Configurable metrics collection
• kislayphp/core: HTTP/HTTPS server metrics
• kislayphp/discovery: Service health metrics
• kislayphp/eventbus: Real-time metrics streaming
• kislayphp/gateway: API gateway metrics
• kislayphp/queue: Queue processing metrics

Provides

• ext-kislayphp_metrics: *

Apache-2.0

• KislayPHP Team

• php
• microservices
• php-extension
• php-echo-system
• cpp-extension
• php-metrics
• php-monitoring
• php-observability
• php-prometheus
• php-statsd
• php-influxdb
• php-telemetry
• php-performance-monitoring
• php-microservices-metrics
• distributed-monitoring

Extension name: ext-kislayphp_metrics

Supports Zend Thread Safety (ZTS): ✅

Supports non-Thread Safe mode (NTS): ✅

Supported operating systems: no restrictions

README

Application metrics for PHP microservices. Counter, gauge, histogram, and timer types with zero instrumentation overhead. Prometheus-compatible export.

Part of the KislayPHP ecosystem.

✨ What It Does

kislayphp/metrics provides C++-backed metrics primitives for PHP applications. All metric operations use atomic operations — measuring your code doesn't slow it down.

<?php
$metrics = new Kislay\Metrics\Collector();
$metrics->counter('requests_total')->increment();
$metrics->histogram('request_duration_ms')->observe($ms);
echo $metrics->export(); // Prometheus text format

📦 Installation

pie install kislayphp/metrics

Enable in php.ini:

extension=kislayphp_metrics.so

🚀 Quick Start

<?php
$metrics = new Kislay\Metrics\Collector();

// Counter — monotonically increasing
$metrics->counter('http_requests_total', ['method' => 'GET', 'status' => '200'])
        ->increment();

// Gauge — value that goes up and down
$metrics->gauge('active_connections')->set(42);
$metrics->gauge('queue_depth')->increment();
$metrics->gauge('queue_depth')->decrement();

// Histogram — distribution of values
$start = microtime(true);
// ... handle request ...
$metrics->histogram('request_duration_seconds')
        ->observe(microtime(true) - $start);

// Timer (convenience wrapper for histogram)
$timer = $metrics->timer('db_query_seconds')->start();
// ... run query ...
$timer->stop();

// Export as Prometheus text format
$app->get('/metrics', function($req, $res) use ($metrics) {
    $res->send($metrics->export(), 'text/plain; version=0.0.4');
});

📖 Public API

namespace Kislay\Metrics;

class Collector {
    public function counter(string $name, array $labels = []): Counter;
    public function gauge(string $name, array $labels = []): Gauge;
    public function histogram(string $name, array $labels = [], array $buckets = []): Histogram;
    public function timer(string $name, array $labels = []): Timer;
    public function export(): string;    // Prometheus text format
    public function reset(): void;
}

class Counter  { public function increment(float $by = 1): void; public function get(): float; }
class Gauge    { public function set(float $value): void; public function increment(float $by = 1): void; public function decrement(float $by = 1): void; public function get(): float; }
class Histogram { public function observe(float $value): void; }
class Timer    { public function start(): TimerHandle; }
class TimerHandle { public function stop(): float; }

Legacy aliases: KislayPHP\Metrics\*

🔗 Ecosystem

core · gateway · discovery · metrics · queue · eventbus

📄 License

Apache License 2.0 · Full Docs