Arbyte Structured Logging for Seq

Description

The plugin sends structured WordPress and WooCommerce log events to a Seq server using the CLEF ingestion format.

Arbyte Structured Logging for Seq is an independent WordPress plugin and is not affiliated with, endorsed by, or sponsored by Datalust or the Seq project. Seq is a product of Datalust.

Features:

• Sends WordPress PHP errors, uncaught exceptions, and fatal errors to Seq.
• Integrates with WooCommerce’s log handler system when WooCommerce is active.
• Buffers events and sends them in batches of up to 100 events.
• Retries transient HTTP failures.
• Redacts sensitive context fields such as passwords, tokens, API keys, and credentials.
• Supports configurable minimum log levels.
• Provides an admin connection test.
• Supports configuration through the WordPress settings page or wp-config.php constants.

The plugin installs an early bootstrap during activation so fatal errors that occur before normal plugin loading can also be reported. Events may contain exception messages, stack traces, file paths, site names, and site URLs. Configure the destination and retention policy in accordance with your privacy requirements.

Requirements

• WordPress 6.5 or later
• PHP 8.1 or later
• A Seq server with CLEF ingestion enabled
• WooCommerce is optional; WooCommerce logs are forwarded automatically when it is active.

Configuration

The settings page supports the following options:

• Seq base URL
• Optional API key
• Minimum logging level: debug, info, notice, warning, error, critical, alert, or emergency

For deployment configuration, define these constants in wp-config.php:

`php

define(‘WP_SEQ_URL’, ‘https://seq.example.com’);
define(‘WP_SEQ_API_KEY’, ‘your-api-key’);
define(‘WP_SEQ_MIN_LEVEL’, ‘warning’);
`

Constants override the corresponding settings-page values. Fields overridden by constants are disabled in the settings page.