maxfrerichs/t3-prometheus-client

TYPO3 client for Prometheus

0.10.2 2025-04-15 08:58 UTC

Requires

• php: >=8.2
• promphp/prometheus_client_php: ^2.14
• promphp/prometheus_push_gateway_php: ^1.1
• typo3/cms-core: ^12.4 || ^13.4
• typo3/cms-scheduler: ^12.4 || ^13.4

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.51
• phpstan/phpstan: ^2.1
• phpunit/phpunit: ^10.0
• typo3/coding-standards: ^0.5.5
• typo3/tailor: ^1.6
• typo3/testing-framework: ^8.0

Replaces

• typo3-ter/t3-prometheus-client: 0.10.2

GPL-2.0-or-later

• Max Frerichs

README

About this extension:

This extension provides a client for Prometheus to access and process timeseries data from system status informations (more info on "How it works"). Both scraping and pushing to a gateway are supported.

Requirements

• TYPO3 12.4 or higher
• PHP 8.2 or higher
• Prometheus

How to use:

• Install extension with composer req maxfrerichs/t3-prometheus-client in your TYPO3 distribution
• Install and configure prometheus. Please refer to the Prometheus documentation for more information regarding this topic.
• Configure the extension. The "DevOps' way to use Prometheus is to expose the app on a separate, non-public port and deploy Prometheus on the same webserver. Exposing the TYPO3 instance on a separate port can be achieved with a VirtualHost config (if you're using apache2). However, you can also configure this extension to provide Basic authentication or Token-based authentication, so you can expose the /metrics endpoint securely to the public, if needed.
• Configure your host. If you want to run Prometheus on the same server, you need to create a VirtualHost config for the non-public port. An example for this config can be found in Examples/config/other-vhosts.example.config Make sure to set a Host header, otherwise TYPO3 will throw an Exception.
• Make sure that the Prometheus config and the extension config match.

Known issues

(Your issue?)

API

Registration of custom metrics is possible by creating a class that implements MFR\T3PromClient\Metrics\MetricInterface or by registering the service with the prometheus.metric tag in Configuration/Services.yaml

TODO:

• Add support for other metric types [WIP].
• Add more default metrics [WIP]
• Write more documentation [WIP]

Contribution:

Every contribution is appreciated. Open an issue, tell me your ideas, request a specific feature, report bugs and so on. You can also write an e-mail to "[e-mail]" or "[e-mail]" :-)