Event Logger Plugins

Monorepo containing WordPress plugins for request lifecycle logging, performance monitoring, and real-time visualization.

Plugins

Dependencies

newspack-event-logger (core - no dependencies)
    |
    +-- newspack-event-dashboards
    +-- newspack-event-jobs
    +-- newspack-event-aggregator
    |       |
    |       +-- newspack-performance-aggregator
    |
    +-- newspack-performance-logger
            |
            +-- newspack-performance-workers
            |       |
            |       +-- newspack-performance-dashboards
            |       +-- newspack-performance-request-log
            |
            +-- newspack-performance-gyroscope

• newspack-event-logger: Required by all other plugins
• newspack-event-aggregator: Aggregates logs from remote servers (optional, for hub deployments)
• newspack-performance-aggregator: Hub-mode coordination (requires event-aggregator for server registry)
• newspack-performance-logger: Required by workers and gyroscope
• newspack-performance-workers: Required by dashboards and request-log (provides requests.log via Request Builder)

Requirements

• PHP 8.0+
• WordPress 6.0+
• Memcached server
• Write access to /tmp/event-logger/

Build Commands

# Install dependencies
npm install
composer install

# Build all plugin admin UIs
npm run build

# Watch mode (development)
npm run watch

# Build individual plugin autoloaders
composer build:autoloaders

# Lint
npm run lint:js
npm run lint:scss
composer lint

Installation

1. Run npm install && npm run build to build admin UIs
2. Run composer build:autoloaders to generate autoloaders for each plugin
3. Symlink or copy plugin directories to wp-content/plugins/
4. Activate plugins in WordPress admin (respect dependency order)

Directory Structure

newspack-event-logger-plugins/
    newspack-event-logger/           # Core plugin
    newspack-event-dashboards/
    newspack-event-jobs/
    newspack-event-aggregator/       # Multi-server aggregation
    newspack-performance-logger/
    newspack-performance-workers/
    newspack-performance-dashboards/
    newspack-performance-gyroscope/
    newspack-performance-request-log/
    newspack-performance-aggregator/ # Hub-mode coordination
    package.json                     # Unified npm build
    composer.json                    # Shared dev dependencies and autoload

Each plugin has its own composer.json for autoloading and vendor/ directory.