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

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

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

Allows access to logfiles and exceptions from the Neos CMS backend

1.5.1(6mo ago)753.0k—7.9%5[4 issues](https://github.com/Sebobo/Shel.Neos.Logs/issues)2GPL-3.0+PHPPHP ^8.1

Since Dec 19Pushed 6mo 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 1mo ago

READMEChangelog (7)Dependencies (2)Versions (13)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

50

—

FairBetter than 96% of packages

Maintenance57

Moderate activity, may be stable

Popularity37

Limited adoption so far

Community19

Small or concentrated contributor base

Maturity73

Established project with proven stability

 Bus Factor1

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

190d 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 (46 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 (1 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.4k964.9M7.0k](/packages/monolog-monolog)[symfony/monolog-bundle

Symfony MonologBundle

2.9k249.1M1.6k](/packages/symfony-monolog-bundle)[sentry/sentry

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

1.9k227.1M273](/packages/sentry-sentry)[sentry/sentry-laravel

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

1.3k114.3M154](/packages/sentry-sentry-laravel)[sentry/sdk

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

328134.8M151](/packages/sentry-sdk)[syonix/monolog-viewer

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

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

PHPackages © 2026

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