Real-time Monitoring¶

xcorecli provides powerful monitoring tools to help you keep an eye on your system's performance and health.

The `top` Dashboard¶

The flagship monitoring tool is xcli manager top. It provides a comprehensive, real-time dashboard inside your terminal.

Launch Dashboard
1	`xcli manager top`

Dashboard Tabs:¶

System: CPU, Memory, Disk, and Network usage.
Services: Status and uptime of databases, cache, and API.
Workers: Active Celery tasks and worker health.
Plugins: Resource usage per plugin.

Resource Profiling¶

For a more data-focused view of resource consumption:

Resource Summary
1	`xcli manager resources`

This command generates a detailed report of which components are consuming the most memory and CPU cycles. Use the --watch flag for a live-updating table.

Metrics & Logs¶

Metrics¶

If metrics are enabled in integration.yaml, you can view a snapshot of counters and gauges:

1	`xcli manager metrics`

Unified Logs¶

Instead of tailing multiple files, use the manager's log viewer to see a merged stream of application, worker, and plugin logs.

Follow Logs
xcli manager logs --follow

Filtering Logs

You can filter logs by a specific plugin name to reduce noise:

xcli manager logs my-plugin --follow

Configuration

Observability settings are defined in the observability section of your integration.yaml.

observability:
  logging:
    file: "log/xcore.log"