Download the PHP package tobento/app-logging-web without Composer

App Logging Web

The App Logging Web package provides a web interface for browsing and inspecting log entries created by the tobento-ch/app-logging package.

This package is especially useful when:

• you want quick visibility into application issues
• you don't have direct access to log files
• you want to inspect logs during development or debugging
• you use modular features where logs may or may not be enabled

Zero-Config Bootstrapping

The Logging Web system works out-of-the-box with sensible defaults.

Simply register the Logging Web Boot in your application, and the full log browsing UI becomes available immediately - no additional configuration required.

All built-in features are automatically discovered, registered, and ready to use.
You can inspect logs, browse log cards, and monitor application logs without writing any custom code.

You only need to customize configuration if you want to override defaults such as:

• enabling or disabling specific logging-web features
• customizing log cards or card collections
• adjusting ACL permissions and access control
• overriding log monitoring behavior
• using a shared log repository across multiple apps
• customizing storage or repository implementations

Table of Contents

• Getting Started
  • Requirements
• Documentation
  • App
  • Logging Web Boot
    • Logging Web Config
  • Features
    • Logs Feature
    • Logs Cards Feature
    • Monitor Logs Feature
  • Console
    • Purge Logs Command
  • Learn More
    • Monitor Logs From Another App
• Credits

  ---

Getting Started

Install the latest version of the App Logging Web package by running:

Requirements

• PHP 8.4 or above

Documentation

App

Check out the App Skeleton if you are using the skeleton.

You may also check out the App to learn more about the app in general.

Logging Web Boot

The LoggingWeb boot does the following:

• installs and loads logging-web config
• implements logging-web interfaces
• boots Logging Web Config

You may also install the App Backend and boot the logging web within the backend application.

Logging Web Config

The configuration for the logging web is located in the app/config/logging-web.php file at the default App Skeleton config location.
There you can configure the available features and other options.

Features

Logs Feature

The Logs feature provides a page for viewing and inspecting log entries created by the tobento-ch/app-logging package.

Config

In the logging web config you can enable and configure this feature:

ACL Permissions

• User can access jobs

If you are using the App Backend, you can assign this permission to roles or users in the backend interface.

Logs Cards Feature

The Logs Cards feature provides cards that display log-related information using the app-card package.
These cards can be added to any card collection, such as the App Backend Dashboard Cards or any other custom card groups.

Config

In the logging web config you can enable and configure this feature:

The ACL check is performed before cards are added.
If ACL is enabled and the user does not have the logs permission, the cards are simply not added to the collection.

Customize Cards

You may customize the cards added by this feature by extending or replacing the LogsCards feature.
The feature uses the configureCards() method to define which cards are created.

To override or extend the cards, create your own feature:

Then register your custom feature instead of the default one:

This allows you to fully control which cards appear, their order, and how they behave.

For more details on creating and customizing cards, see the app-card documentation.

Monitor Logs Feature

The Monitor Logs feature wraps the application loggers and stores log entries in the LogRepositoryInterface for later inspection.
It depends on the Logging boot and is applied automatically when enabled.

Config

In the logging web config you can enable and configure this feature:

This feature ensures that log entries are captured and made available for viewing in the Logs Feature web interface.

Console

Purge Logs Command

Use the following command to purge monitored logs:

Purge logs older than 24 hours

Available Options

If you would like to automate this process, consider installing the App Schedule bundle and using a command task:

Alternatively, you may install the App Task bundle and use the Command Task Registry to register this command.

Learn More

Monitor Logs From Another App

When working with multiple Apps, you may monitor logs across all of them.
To do so, ensure that each app uses the same log repository connection in its config file.

For example, in an app using the App Backend, you might configure:

Next, in another app where you only want to monitor logs:

Finally, in the database config file of both apps, configure the shared:storage database:

By using a shared storage connection, all monitored logs from every app are stored in the same repository, allowing them to be viewed centrally in the Logs Feature web interface.

Credits

• Tobias Strub
• All Contributors