composer require vortos/vortos-metrics

composer require promphp/prometheus_client_php

composer require open-telemetry/sdk open-telemetry/exporter-otlp guzzlehttp/guzzle

use Vortos\Metrics\DependencyInjection\MetricsPackage;

$packages = [
    new LoggerPackage(),     // order 10
    new TracingPackage(),    // order 50
    new MetricsPackage(),    // order 55
    new HttpPackage(),
    // ...
];

use Vortos\Metrics\Config\MetricsAdapter;
use Vortos\Metrics\DependencyInjection\VortosMetricsConfig;

return static function (VortosMetricsConfig $config): void {
    $config->adapter(MetricsAdapter::Prometheus)
           ->prometheusEndpointToken($_ENV['METRICS_TOKEN'] ?? '');
};

scrape_configs:
  - job_name: 'my-app'
    static_configs:
      - targets: ['your-app:80']
    bearer_token: 'your-metrics-token'

use Vortos\Metrics\Config\MetricsAdapter;
use Vortos\Metrics\DependencyInjection\VortosMetricsConfig;

return static function (VortosMetricsConfig $config): void {
    $config->adapter(MetricsAdapter::StatsD)
           ->statsDHost($_ENV['STATSD_HOST'] ?? '127.0.0.1')
           ->statsDPort(8125);
};

use Vortos\Metrics\Config\MetricsAdapter;
use Vortos\Metrics\DependencyInjection\VortosMetricsConfig;

return static function (VortosMetricsConfig $config): void {
    $config
        ->adapter(MetricsAdapter::OpenTelemetry)
        ->namespace('myapp')
        ->service(
            name: 'checkout-api',
            version: $_ENV['APP_VERSION'] ?? '',
            environment: $_ENV['APP_ENV'] ?? 'prod',
        )
        ->otlpCollector(
            endpoint: $_ENV['OTEL_EXPORTER_OTLP_METRICS_ENDPOINT'] ?? 'http://otel-collector:4318/v1/metrics',
            timeoutMs: 200,
        );
};

php vortos make:config metrics

use Vortos\Metrics\Config\{MetricsAdapter, MetricsModule};
use Vortos\Metrics\DependencyInjection\VortosMetricsConfig;

return static function (VortosMetricsConfig $config): void {

    // Choose adapter (default: NoOp)
    $config->adapter(MetricsAdapter::Prometheus);

    // Set the metric namespace prefix — all names become {namespace}_{name}
    $config->namespace('myapp');   // default: 'vortos'

    // Prometheus storage backend (choose one)
    $config->prometheusStorageInMemory();  // default — single process only
    $config->prometheusStorageApc();       // PHP-FPM multi-process safe
    $config->prometheusStorageRedis(       // FrankenPHP multi-process safe
        prefix: 'metrics:',
        host: $_ENV['REDIS_HOST'] ?? '127.0.0.1',
        port: 6379,
        password: $_ENV['REDIS_PASSWORD'] ?? '',
    );

    // Endpoint security (production requires one of these)
    $config->prometheusEndpointToken($_ENV['METRICS_TOKEN'] ?? '');
    // OR confirm network-level protection is in place:
    $config->prometheusEndpointOpenAccess();

    // StatsD settings
    $config->statsDHost('127.0.0.1')
           ->statsDPort(8125)
           ->statsDSampleRate(0.1);   // send 10% of metrics (reduces UDP volume)

    // OpenTelemetry OTLP metrics settings
    $config
        ->service('checkout-api', version: $_ENV['APP_VERSION'] ?? '', environment: $_ENV['APP_ENV'] ?? 'prod')
        ->otlpCollector('http://otel-collector:4318/v1/metrics', timeoutMs: 200);

    // Direct vendor helpers (choose one instead of otlpCollector when pushing directly)
    // $config->newRelicOtlp($_ENV['NEW_RELIC_LICENSE_KEY'] ?? '');
    // $config->datadogOtlp($_ENV['DD_API_KEY'] ?? '', site: $_ENV['DD_SITE'] ?? 'datadoghq.com');

    // Silence high-cardinality or high-volume modules
    $config->disableModule(MetricsModule::Cache);
    $config->disableModule(MetricsModule::Persistence);
};

use Vortos\Metrics\Contract\MetricsInterface;

final class OrderService
{
    public function __construct(private readonly MetricsInterface $metrics) {}

    public function place(Order $order): void
    {
        $start = hrtime(true);

        try {
            // ... place order
            $this->metrics->counter('orders_placed_total', [
                'currency' => $order->getCurrency(),
                'channel'  => $order->getChannel(),
            ])->increment();

        } finally {
            $elapsed = (hrtime(true) - $start) / 1_000_000; // nanoseconds → ms
            $this->metrics->histogram('order_processing_duration_ms', labels: [
                'currency' => $order->getCurrency(),
            ])->observe($elapsed);
        }
    }
}