PHPackages                             jop-software/typo3-loki - 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. jop-software/typo3-loki

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

jop-software/typo3-loki
=======================

Grafana Loki integration for TYPO3

v1.1.1(1y ago)24.1k—0%2[6 issues](https://github.com/jop-software/typo3-loki/issues)GPL-2.0-or-laterPHPPHP ^7.4 || ^8.0

Since May 15Pushed 1y ago1 watchersCompare

[ Source](https://github.com/jop-software/typo3-loki)[ Packagist](https://packagist.org/packages/jop-software/typo3-loki)[ Docs](https://jop-software.de)[ RSS](/packages/jop-software-typo3-loki/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (5)Dependencies (7)Versions (9)Used By (0)

TYPO3 Loki Client
=================

[](#typo3-loki-client)

Monitor logging output of your TYPO3 installation

Professional Support
--------------------

[](#professional-support)

Professional support is available, please contact  for more information.

Configuration
-------------

[](#configuration)

There are two possible ways to use this extension.

1. Use the JsonWriter to convert all logs to JSON before writing them to the log file.
    This way, you can process the logs with a different loki client like [Promtail](https://grafana.com/docs/loki/latest/clients/promtail/)

```
$GLOBALS['TYPO3_CONF_VARS']['LOG']['writerConfiguration'] = [
    // Log handling configuration for ERROR logs
    // Set this to DEBUG to process all logs.
    \TYPO3\CMS\Core\Log\LogLevel::ERROR => [
        // Convert all logs to JSON to scrape them with loki clients like Promtail
        \Jops\TYPO3\Loki\Log\Writers\JsonWriter::class => [],
    ],
];
```

2. Use the LokiWriter to send logs directly to a configured loki instance.
    You can define labels here, that will be attached to the log line sent to loki.
    See: [Configure a Loki instance](#configure-a-loki-instance)

```
$GLOBALS['TYPO3_CONF_VARS']['LOG']['writerConfiguration'] = [
    // Log handling configuration for ERROR logs
    // Set this to DEBUG to process all logs.
    \TYPO3\CMS\Core\Log\LogLevel::ERROR => [
        // Configure LokiWrite to send logs to Loki
        \Jops\TYPO3\Loki\Log\Writers\LokiWriter::class => [
            "labels" => [
                "key" => "value",
            ],
        ],
    ],
];
```

### Configure a Loki instance.

[](#configure-a-loki-instance)

If you want to use the LokiWriter, you need to have a loki instance configured. This can be done with the Extension Configuration in the backend or in the `AdditionalConfiguration.php`.
If your Loki installation is secured with http basic auth, you can provide those credentials here as well. Keep in mind that the credentials **are store as plain text** in the configuration file.

This could be an example configuration:

```
$GLOBALS['TYPO3_CONF_VARS']['EXTENSIONS']['loki'] = [
    "base-url" => "https://loki.example.com",
    // Optional: Add basic-auth credentials if needed
    "basic-auth" => [
        "username" => "username",
        "password" => "secure-password",
    ],
];
```

Supported TYPO3 Versions
------------------------

[](#supported-typo3-versions)

The extension is only officially available and released for TYPO3 11.

If you need it in an older project, you can find a version that is compatible with TYPO3 9 and 10 in the [`typo3-9-10-compatability`](https://github.com/jop-software/typo3-loki/tree/typo3-9-10-compatability) branch. Use `dev-typo3-9-10-compatability` as the version in composer.

Local Development
-----------------

[](#local-development)

We use [DDEV](https://ddev.com) for local development.

You get a complete ddev setup in this repository, just run `ddev start`.

License
-------

[](#license)

This project is licensed under [GPL-2.0-or-later](https://www.gnu.org/licenses/old-licenses/gpl-2.0.html), see the [LICENSE](./LICENSE) file for more information.

© 2022, [jop-software Inh. Johannes Przymusinski](mailto:info@jop-software.de)

###  Health Score

31

—

LowBetter than 68% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity24

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity58

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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 ~182 days

Recently: every ~227 days

Total

6

Last Release

544d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/6f9b34126c88f80ae2aee933e82e75f4bc6012ff6f6ca3a37ed7b99379181ab0?d=identicon)[johannes.przymusinski](/maintainers/johannes.przymusinski)

---

Top Contributors

[![cngJo](https://avatars.githubusercontent.com/u/17183555?v=4)](https://github.com/cngJo "cngJo (52 commits)")

---

Tags

grafanagrafana-lokihacktoberfestmonitoringtypo3typo3-cms-extensiontypo3-extensionloggingmonitoringTYPO3 CMStypo3grafanalog-aggregationlokiGrafana Loki

###  Code Quality

Static AnalysisPHPStan

Code StylePHP\_CodeSniffer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/jop-software-typo3-loki/health.svg)

```
[![Health](https://phpackages.com/badges/jop-software-typo3-loki/health.svg)](https://phpackages.com/packages/jop-software-typo3-loki)
```

###  Alternatives

[rollbar/rollbar

Monitors errors and exceptions and reports them to Rollbar

33723.7M81](/packages/rollbar-rollbar)[datadog/php-datadogstatsd

An extremely simple PHP datadogstatsd client

19124.6M15](/packages/datadog-php-datadogstatsd)[rollbar/rollbar-laravel

Rollbar error monitoring integration for Laravel projects

14110.4M7](/packages/rollbar-rollbar-laravel)[analog/analog

Fast, flexible, easy PSR-3-compatible PHP logging package with dozens of handlers.

3451.5M24](/packages/analog-analog)[networkteam/sentry-client

A Sentry client for TYPO3. It forwards errors and exceptions to Sentry - https://sentry.io/

371.0M4](/packages/networkteam-sentry-client)[honeybadger-io/honeybadger-laravel

Honeybadger Laravel integration

431.2M](/packages/honeybadger-io-honeybadger-laravel)

PHPackages © 2026

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