PHPackages                             shel/neos-logs - 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 & Monitoring](/categories/logging)
4. /
5. shel/neos-logs

ActiveNeos-plugin[Logging & Monitoring](/categories/logging)

shel/neos-logs
==============

Allows access to logfiles and exceptions from the Neos CMS backend

1.5.1(7mo ago)759.3k↓55.9%6[4 issues](https://github.com/Sebobo/Shel.Neos.Logs/issues)2GPL-3.0+PHPPHP ^8.1

Since Dec 19Pushed 3d ago1 watchersCompare

[ Source](https://github.com/Sebobo/Shel.Neos.Logs)[ Packagist](https://packagist.org/packages/shel/neos-logs)[ RSS](/packages/shel-neos-logs/feed)WikiDiscussions main Synced 2d ago

READMEChangelog (7)Dependencies (2)Versions (14)Used By (2)

Log file and exception viewer for Neos CMS
==========================================

[](#log-file-and-exception-viewer-for-neos-cms)

[![Latest Stable Version](https://camo.githubusercontent.com/d3583740a7dbc375517b22f8eec079e12b10e0b6580d9407cdd25432d01d33d4/68747470733a2f2f706f7365722e707567782e6f72672f7368656c2f6e656f732d6c6f67732f762f737461626c65)](https://packagist.org/packages/shel/neos-logs)[![Total Downloads](https://camo.githubusercontent.com/dc9ace6b0a36b25df571a8c4a15b29241e24472d591b35dc84ea47147246cfd8/68747470733a2f2f706f7365722e707567782e6f72672f7368656c2f6e656f732d6c6f67732f646f776e6c6f616473)](https://packagist.org/packages/shel/neos-logs)[![License](https://camo.githubusercontent.com/e296d43d75803b79528dc3605cb62d93d307b4fa193292946c62631e3a330e6e/68747470733a2f2f706f7365722e707567782e6f72672f7368656c2f6e656f732d6c6f67732f6c6963656e7365)](https://packagist.org/packages/shel/neos-logs)

This package provides a new module in the [NeosCMS](https://www.neos.io)backend to view logs and exceptions of a Neos instance.

Usually it's recommended to use other, more powerful tools for this use case like [Sentry](http://sentry.io) or [Kibana](https://www.elastic.co/de/products/kibana), but there are cases in which those tools cannot be used.

This package was built to help in situations where one has to quickly investigate something, e.g. to understand an error the client had with their site.

Features
--------

[](#features)

- Backend module
    - View all logfiles in the `Data/Logs` directory
        - Filter log lines by their level
        - Download logfiles
    - View all exception files in the `Data/Logs/Exceptions` directory
        - Shows shortened excerpt for each exception
        - Groups exceptions by their code or message to reduce clutter
        - Download exception files
        - Search for exceptions by code or their message
        - Mark recent exceptions
- CLI
    - List all exceptions as table
    - Show details of an exception

Installation
------------

[](#installation)

Run this in your site package:

```
composer require --no-update shel/neos-logs

```

Then run `composer update` in your project root.

Usage
-----

[](#usage)

After the installation, you will have a new backend module in Neos - available only for administrators - that will allow you to view all local log and exception files.

Lines in the logfiles can be filtered by their level. You can also change the number of lines that should be visible.

### CLI

[](#cli)

You can also use the CLI commands to list all exceptions or show details of a specific exception.

To list all exceptions:

```
./flow logs:exceptions
```

To show details of a specific exception:

```
./flow logs:showexceptions
```

`` is the filename of the exception file without the `.txt` extension. If you don't provide an id, the command will list all exceptions, and you can choose one to show details.

Examples
--------

[](#examples)

Overview screen:

[![Overview](Documentation/overview.jpg)](Documentation/overview.jpg)

Viewing a logfile:

[![Logfile](Documentation/logfile.jpg)](Documentation/logfile.jpg)

Search in exceptions:

[![Search exceptions](Documentation/search_exceptions.jpg)](Documentation/search_exceptions.jpg)

Exceptions in CLI:

[![CLI exceptions](Documentation/cli_exceptions.jpg)](Documentation/cli_exceptions.jpg)

Contributions
-------------

[](#contributions)

Contributions are very welcome!

Please create detailed issues and PRs.

**If you use this package and want to support or speed up its development, [get in touch with me](mailto:hyphens@helzle.it).**

Or you can also support me directly via [patreon](https://www.patreon.com/shelzle).

License
-------

[](#license)

See [License](./LICENSE.txt)

###  Health Score

55

—

FairBetter than 97% of packages

Maintenance72

Regular maintenance activity

Popularity38

Limited adoption so far

Community20

Small or concentrated contributor base

Maturity74

Established project with proven stability

 Bus Factor1

Top contributor holds 83.1% 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 ~195 days

Recently: every ~232 days

Total

12

Last Release

236d ago

PHP version history (2 changes)1.4.0PHP ^7.4 || ^8.0

1.4.2PHP ^8.1

### Community

Maintainers

![](https://www.gravatar.com/avatar/5c9f106db319e8698dcb4aedfe8034f0442d379ebbd78fcd67b884999b2236f1?d=identicon)[Sebobo](/maintainers/Sebobo)

---

Top Contributors

[![Sebobo](https://avatars.githubusercontent.com/u/596967?v=4)](https://github.com/Sebobo "Sebobo (49 commits)")[![Kleisli](https://avatars.githubusercontent.com/u/18674199?v=4)](https://github.com/Kleisli "Kleisli (3 commits)")[![ahaeslich](https://avatars.githubusercontent.com/u/1756367?v=4)](https://github.com/ahaeslich "ahaeslich (2 commits)")[![jonnitto](https://avatars.githubusercontent.com/u/4510166?v=4)](https://github.com/jonnitto "jonnitto (2 commits)")[![so-grimm](https://avatars.githubusercontent.com/u/119854907?v=4)](https://github.com/so-grimm "so-grimm (2 commits)")[![lorenzulrich](https://avatars.githubusercontent.com/u/1816023?v=4)](https://github.com/lorenzulrich "lorenzulrich (1 commits)")

---

Tags

hacktoberfestlogfilesloggingneos-cmslogloggingexceptionflowNeosneoscmsanalyseViewerlogfile

### Embed Badge

![Health badge](/badges/shel-neos-logs/health.svg)

```
[![Health](https://phpackages.com/badges/shel-neos-logs/health.svg)](https://phpackages.com/packages/shel-neos-logs)
```

###  Alternatives

[monolog/monolog

Sends your logs to files, sockets, inboxes, databases and various web services

21.4k1.0B8.2k](/packages/monolog-monolog)[symfony/monolog-bundle

Symfony MonologBundle

2.9k262.9M1.8k](/packages/symfony-monolog-bundle)[sentry/sentry

PHP SDK for Sentry (http://sentry.io)

1.9k247.1M335](/packages/sentry-sentry)[sentry/sentry-laravel

Laravel SDK for Sentry (https://sentry.io)

1.3k127.1M203](/packages/sentry-sentry-laravel)[sentry/sdk

This is a meta package of sentry/sentry. We recommend using sentry/sentry directly.

327139.0M166](/packages/sentry-sdk)[syonix/monolog-viewer

An easy-to-use viewer for log files generated by Monolog (https://github.com/Seldaek/monolog)

2746.1k](/packages/syonix-monolog-viewer)

PHPackages © 2026

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