System Health

Overview

The System Health feature provides a visual, real-time overview of the Etlworks instance’s current status — including CPU, memory, disk, Redis, and database health — directly in the web interface.

It uses the same underlying data as the Health API and is primarily intended for administrators responsible for system monitoring and troubleshooting.

Access and Permissions

The System Health tab is available only to super admin users.

Regular users and tenant administrators do not see this option in the profile menu.

1. Top-right menu → SYSTEM → System Health

2. Select the System Health tab.

Data Sources

All information displayed in this tab is retrieved from the /health and /health?allNodes=true API endpoints:

• In single-node deployments, Etlworks reads local system metrics directly from the host environment.

• In multi-node deployments, each node periodically pushes its metrics to Redis.

  The UI automatically aggregates and displays the status of all active nodes.

See Health API for the full JSON response format and detailed field descriptions.

Single-Node View

When Etlworks runs in single-node mode, the System Health tab shows metrics for the current node only.

Displayed sections:

• CPU — number of cores, current load, and thread counts

• RAM — total, free, and heap memory

• System Disk — free and total space

• Data Disk — optional; displayed if an external or separate data volume is configured

• Database — connection status, version, number of running flows

• Redis — connection status, version, and memory usage

Each section includes a colored badge representing the status:

• Gray (UP) — operating normally

• Yellow (WARNING) — nearing resource limits

• Red (DOWN) — error, out of resources, or unreachable

Multi-Node View

When Etlworks is deployed as a cluster behind a load balancer, the System Health tab switches to multi-node mode.

In this mode, you’ll see:

• A summary header with:

  • Overall cluster health status (UP, WARNING, or DOWN)

  • Last Updated timestamp — the most recent timestamp among all nodes, shown in the browser’s local timezone

  • A Refresh button to manually trigger data reload

• A table of nodes listing:

  • Node ID

  • Node status

  • CPU, RAM, and System Disk metrics for each node

• A Shared Components section showing cluster-wide resources such as:

  • Database

  • Redis

  • Data Disk (if configured)

Statuses are color-coded the same way as in single-node mode.

Rows automatically adjust if nodes go offline or new nodes join.

Color Coding and Status Logic