PHPackages                             mteu/typo3-monitoring - 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 &amp; Monitoring](/categories/logging)
4. /
5. mteu/typo3-monitoring

ActiveTypo3-cms-extension[Logging &amp; Monitoring](/categories/logging)

mteu/typo3-monitoring
=====================

Exposes health status information of selected components in your TYPO3 instance to be integrated in external monitoring

1.0.0(4w ago)61.9k2[1 PRs](https://github.com/mteu/typo3-monitoring/pulls)GPL-2.0-or-laterPHPPHP ~8.3.0 || ~8.4.0 || ~8.5.0CI passing

Since Jul 16Pushed 1mo agoCompare

[ Source](https://github.com/mteu/typo3-monitoring)[ Packagist](https://packagist.org/packages/mteu/typo3-monitoring)[ RSS](/packages/mteu-typo3-monitoring/feed)WikiDiscussions main Synced 2w ago

READMEChangelog (10)Dependencies (84)Versions (38)Used By (0)

[![CGL](https://github.com/mteu/typo3-monitoring/actions/workflows/cgl.yaml/badge.svg)](https://github.com/mteu/typo3-monitoring/actions/workflows/cgl.yaml)[![Tests](https://github.com/mteu/typo3-monitoring/actions/workflows/tests.yaml/badge.svg?branch=main)](https://github.com/mteu/typo3-monitoring/actions/workflows/tests.yaml)[![Coverage](https://camo.githubusercontent.com/ec090cdf03722ac96b55b605bd4f9cfc43a7d8ba3bbeed2c76d64e5618326a0e/68747470733a2f2f636f766572616c6c732e696f2f7265706f732f6769746875622f6d7465752f7479706f332d6d6f6e69746f72696e672f62616467652e7376673f6272616e63683d6d61696e)](https://coveralls.io/github/mteu/typo3-monitoring?branch=main)

[![Extension Icon](Resources/Public/Icons/Extension.svg)](Resources/Public/Icons/Extension.svg)TYPO3 Monitoring
================

[](#typo3-monitoring)

[![TYPO3 Support](https://camo.githubusercontent.com/c387afffe840cf5ff9d466319733c8ce2ec73323b8e2683df9cdc10cc7423e8a/68747470733a2f2f62616467656e2e6e65742f62616467652f5459504f332f7631332f4646383730303f69636f6e3d7479706f33)](https://camo.githubusercontent.com/c387afffe840cf5ff9d466319733c8ce2ec73323b8e2683df9cdc10cc7423e8a/68747470733a2f2f62616467656e2e6e65742f62616467652f5459504f332f7631332f4646383730303f69636f6e3d7479706f33)[![TYPO3 Support](https://camo.githubusercontent.com/7953949bb14a7a49a9e0429c8b47499a99448511fd84be6c219865c18eae24b5/68747470733a2f2f62616467656e2e6e65742f62616467652f5459504f332f7631342f4646383730303f69636f6e3d7479706f33)](https://camo.githubusercontent.com/7953949bb14a7a49a9e0429c8b47499a99448511fd84be6c219865c18eae24b5/68747470733a2f2f62616467656e2e6e65742f62616467652f5459504f332f7631342f4646383730303f69636f6e3d7479706f33)[![PHP Version Require](https://camo.githubusercontent.com/962fd05df1a49628387ba3cd7d34c4e3668e15239c1354fe951bf213c2f91afd/68747470733a2f2f706f7365722e707567782e6f72672f6d7465752f7479706f332d6d6f6e69746f72696e672f726571756972652f706870)](https://packagist.org/packages/mteu/typo3-monitoring)[![Stability](https://camo.githubusercontent.com/d9c90aa9b2164e93ba010ba103c022d4f150c611d45e048f6e90c3c7dfad7bfc/68747470733a2f2f7479706f332d6261646765732e6465762f62616467652f6d6f6e69746f72696e672f73746162696c6974792f62616467656e2e737667)](https://camo.githubusercontent.com/d9c90aa9b2164e93ba010ba103c022d4f150c611d45e048f6e90c3c7dfad7bfc/68747470733a2f2f7479706f332d6261646765732e6465762f62616467652f6d6f6e69746f72696e672f73746162696c6974792f62616467656e2e737667)[![Latest version](https://camo.githubusercontent.com/9a23babeb23f105abbd02a4dc53491fd2fb295d07a910613295b32020359785b/68747470733a2f2f7479706f332d6261646765732e6465762f62616467652f6d6f6e69746f72696e672f76657273696f6e2f62616467656e2e737667)](https://camo.githubusercontent.com/9a23babeb23f105abbd02a4dc53491fd2fb295d07a910613295b32020359785b/68747470733a2f2f7479706f332d6261646765732e6465762f62616467652f6d6f6e69746f72696e672f76657273696f6e2f62616467656e2e737667)[![Total downloads](https://camo.githubusercontent.com/207452146a6146ed6e5108ccabf51975d78b0bf298fe467fe12769214ccdcc4a/68747470733a2f2f7479706f332d6261646765732e6465762f62616467652f6d6f6e69746f72696e672f646f776e6c6f6164732f62616467656e2e737667)](https://camo.githubusercontent.com/207452146a6146ed6e5108ccabf51975d78b0bf298fe467fe12769214ccdcc4a/68747470733a2f2f7479706f332d6261646765732e6465762f62616467652f6d6f6e69746f72696e672f646f776e6c6f6164732f62616467656e2e737667)

This package provides the TYPO3 CMS extension `EXT:monitoring`, which equips TYPO3 with a highly extensible monitoring system for tracking the health state of custom components. It delivers health reports via an API endpoint, a CLI command, and a backend dashboard, with optional push notifications to external channels.

🚀 Features
----------

[](#-features)

- [Extensible monitoring system](Documentation/README.md) for custom authorization, monitoring checks, and push notifications.
- Delivers health reports in several ways:
    - Structured JSON responses for the overall health status
    - Command-line interface for running monitoring checks
    - Backend Dashboard
    - Optional [Push notification](Documentation/Reporters.md) to external channels (e.g. the built-in [EmailReporter](Documentation/Reporter/EmailReporter.md))
- Built-in providers this package ships:
    - [Scheduler Provider](Documentation/Providers/Scheduler.md) (Monitors TYPO3 Scheduler tasks.)
- Caching for expensive monitoring operations

🔥 Quick Start
-------------

[](#-quick-start)

### Installation

[](#installation)

```
composer require mteu/typo3-monitoring
```

### Configuration

[](#configuration)

```
# config/system/settings.php
return [
    'EXTENSIONS' => [
        'monitoring' => [
            'api' => [
                'endpoint' => '/monitor/health',
                'enforceHttps' => true,
            ],
            'authorizer' => [
                'mteu\Monitoring\Authorization\TokenAuthorizer' => [
                    'enabled' => true,
                    'secret' => 'your-secure-secret',
                    'authHeaderName' => 'X-TYPO3-MONITORING-AUTH',
                ],
            ],
        ],
    ],
];
```

See [Documentation/Configuration.md](Documentation/Configuration.md) for all available settings.

### Generate the token

[](#generate-the-token)

The `secret` you configure is **not** the value you send. The token is an HMAC of the endpoint path keyed with that secret — send the token, not the secret.

The easiest way to get a ready-to-use value: open the **Monitoring → Authorizers**backend module, which displays the current token for your configured endpoint.

Or generate it programmatically (endpoint path first, then secret):

```
use TYPO3\CMS\Core\Crypto\HashService;

$token = (new HashService())->hmac('/monitor/health', 'your-secure-secret');
```

Then send it in the configured header:

```
curl -H "X-TYPO3-MONITORING-AUTH: " https:///monitor/health
```

See [Documentation/Authorization.md](Documentation/Authorization.md) for the token's security properties.

### Endpoint

[](#endpoint)

```
GET https:///monitor/health

```

Access requires authentication — either a TYPO3 backend administrator session or a token header. See [Documentation/Authorization.md](Documentation/Authorization.md) for details, including the security properties of the token.

The endpoint returns a JSON health report. See the [API Reference](Documentation/Api.md) for the full response schema and HTTP status codes.

🧑‍💻 Development
---------------

[](#‍-development)

For guides on creating custom providers and authorizers, see the [Documentation](Documentation/README.md).

📙 Documentation
---------------

[](#-documentation)

Please have a look at the extension [documentation](Documentation/README.md). It provides a detailed look into the possibilities you have in extending and customizing this extension for your specific TYPO3 components.

🤝 Contributing
--------------

[](#-contributing)

Contributions are very welcome! Please have a look at the [Contribution Guide](CONTRIBUTING.md). It lays out the workflow of submitting new features or bugfixes.

🔒 Security
----------

[](#-security)

Please refer to the [Security Policy](SECURITY.md) if you discover a security vulnerability in this extension. Be warned, though. I cannot afford bounty. This is a private project.

💛 Acknowledgements
------------------

[](#-acknowledgements)

This extension is inspired by [`cpsit/monitoring`](https://github.com/CPS-IT/monitoring) and its generic approach to offer an extensible provider interface. I've transformed and extended the underlying concept into a TYPO3 specific implementation.

⭐ License
---------

[](#-license)

This extension is licensed under the [GPL-2.0-or-later](LICENSE.txt) license.

💬 Support
---------

[](#-support)

For issues and feature requests, please use the [GitHub issue tracker](https://github.com/mteu/typo3-monitoring/issues).

###  Health Score

52

—

FairBetter than 96% of packages

Maintenance92

Actively maintained with recent releases

Popularity25

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity66

Established project with proven stability

 Bus Factor1

Top contributor holds 60.9% 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.

###  Release Activity

Cadence

Every ~26 days

Recently: every ~16 days

Total

15

Last Release

28d ago

Major Versions

0.5.0 → v1.x-dev2026-05-28

0.5.1 → 1.0.02026-07-16

PHP version history (2 changes)0.1.0PHP ~8.3.0 || ~8.4.0

0.4.2PHP ~8.3.0 || ~8.4.0 || ~8.5.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/876091a683280d445656ba977b7923a3824059a2808749a851e104ba14ac85bd?d=identicon)[mteu](/maintainers/mteu)

---

Top Contributors

[![mteu](https://avatars.githubusercontent.com/u/2636487?v=4)](https://github.com/mteu "mteu (413 commits)")[![renovate[bot]](https://avatars.githubusercontent.com/in/2740?v=4)](https://github.com/renovate[bot] "renovate[bot] (254 commits)")[![eliashaeussler](https://avatars.githubusercontent.com/u/16313625?v=4)](https://github.com/eliashaeussler "eliashaeussler (10 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (1 commits)")

---

Tags

monitoringtypo3-cms-extension

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/mteu-typo3-monitoring/health.svg)

```
[![Health](https://phpackages.com/badges/mteu-typo3-monitoring/health.svg)](https://phpackages.com/packages/mteu-typo3-monitoring)
```

###  Alternatives

[typo3/cms

TYPO3 CMS is a free open source Content Management Framework initially created by Kasper Skaarhoj and licensed under GNU/GPL.

1.2k1.9M122](/packages/typo3-cms)[typo3/cms-core

TYPO3 CMS Core

3313.6M5.6k](/packages/typo3-cms-core)[flow-php/flow

PHP ETL - Extract Transform Load - Data processing framework

86337.5k](/packages/flow-php-flow)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

595.8M668](/packages/shopware-core)[drupal/core-recommended

Locked core dependencies; require this project INSTEAD OF drupal/core.

6943.5M448](/packages/drupal-core-recommended)[tempest/framework

The PHP framework that gets out of your way.

2.3k37.6k20](/packages/tempest-framework)

PHPackages © 2026

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