README

Lightweight developer tools for Syntexa Framework - monitoring, profiling, and debugging.

Features

• Real-time Metrics Dashboard: Monitor Swoole server metrics, application statistics, and memory usage
• Log Viewer: View and filter application logs in real-time
• Profiler Integration: View profiler events and performance segments
• Lightweight: No heavy dependencies like Grafana - simple, fast, and developer-friendly

Installation

The module is automatically available when added to composer.json:

{
    "require": {
        "syntexa/module-dev-tools": "*"
    }
}

Usage

Once installed, access the developer tools at:

http://localhost:9501/dev-tools

Endpoints

• GET /dev-tools - Main dashboard (HTML interface)
• GET /dev-tools/api/metrics - JSON metrics endpoint
• GET /dev-tools/api/logs?file=error.log&lines=100&filter=error - Log viewer API
• GET /dev-tools/api/profiler?limit=50 - Profiler events API

Features

Metrics Dashboard

• Swoole Metrics: Connections, workers, requests, coroutines
• Application Metrics: Request count, errors, uptime
• Memory Metrics: Current and peak memory usage

Log Viewer

• View multiple log files
• Filter logs by keyword
• Adjust number of lines displayed
• Real-time updates

Profiler

• View profiler events from Inspector module
• See performance segments and durations
• Filter by event type

Requirements

• PHP 8.4+
• Swoole extension
• Syntexa Inspector module (for profiler functionality)

Development

This module is designed to be lightweight and fast. It reads statistics from JSON files generated by the Swoole server and integrates with the existing Inspector module for profiling.