> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coreflux.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Routes Monitoring

> View real-time route status and logs — monitor connection health, message counts, and export logs

<Frame caption="Route card for MyS7Route with the monitor icon highlighted and a Route Monitor tooltip">
  <img src="https://mintcdn.com/coreflux/W9CJ-kgVY3a3sCeL/images/route-card-monitor.png?fit=max&auto=format&n=W9CJ-kgVY3a3sCeL&q=85&s=f45676e6d1c3755e7ccb4e53846915a0" alt="Coreflux HUB route card titled MyS7Route with a green status dot in the top-right corner and a row of action icons at the bottom — a gear for Configuration, a monitor icon currently hovered showing a Route Monitor tooltip, a globe for Documentation, and a trash can for Delete" width="405" height="239" data-path="images/route-card-monitor.png" />
</Frame>

## Why Monitor Routes?

You need to know whether a route is running correctly — whether it is connected, how many messages it has processed, and whether there are errors. The Monitor window gives you live status metrics and real-time logs filtered to a single route, so you can troubleshoot without searching through broker-wide output.

## When to Use It

* **Verifying connectivity** — Confirm that a route is connected to its target system after creation or configuration changes
* **Tracking activity** — Check message counts and error rates to validate that events and mappings are executing
* **Troubleshooting connections** — See why a route failed to connect using status details and log entries
* **Exporting for analysis** — Download filtered logs as JSON, CSV, or LOG for offline review

***

## Accessing the Monitor

Open the Routes Manager, click on a route card, and select **Monitor**. The Monitor window opens with two tabs: **Status** and **Logs**.

<Frame caption="Opening the Monitor from a route card in the Routes Manager">
  <img src="https://mintcdn.com/coreflux/W9CJ-kgVY3a3sCeL/images/access-monitoring.gif?s=2cbc19ba8bafe934d91aee3a1e4d10a2" alt="Coreflux HUB Routes Manager showing how to click a route card and select Monitor to open the monitoring window" width="800" height="500" data-path="images/access-monitoring.gif" />
</Frame>

***

## Status Tab

The Status tab displays live metrics from the broker for the selected route.

<Frame caption="Monitor: SiemensS7Route — Status tab showing connection state, health, message count, error count, activity timeline, and the raw JSON status payload">
  <img src="https://mintcdn.com/coreflux/NyitfZKdXrngxrt5/images/route-monitor-status.png?fit=max&auto=format&n=NyitfZKdXrngxrt5&q=85&s=f3270fe990e54b28246bef2213f773a1" alt="Coreflux HUB Monitor: SiemensS7Route window with the SIEMENS_S7 type badge, Connection Connected, Health Green, and Uptime 00:30:40 in the header; Status tab selected showing an Overview with Connection Connected Since 30m ago, Health Green with Uptime 00:30:40, Messages 1,835 with 1,835 ok and 0 failed, and Errors 0 with 0 consecutive; an Activity Timeline with Last Activity and Last Success 6s ago on 4/16/2026 and Last Error None; and an Advanced Raw JSON panel displaying the SiemensS7Route status payload with name, type, connection, health, errors, messages, lastActivity, lastSuccess, uptime, connectedSince, and timestamp fields" width="1024" height="639" data-path="images/route-monitor-status.png" />
</Frame>

| Field          | Description                                                |
| -------------- | ---------------------------------------------------------- |
| **Connection** | Whether the route is currently connected to its target     |
| **Health**     | Health indicator (Green, Yellow, Red) based on error rates |
| **Messages**   | Total messages processed, with success and failure counts  |
| **Errors**     | Total and consecutive error counts                         |

The **Activity Timeline** shows timestamps for last activity, last success, and last error. The **Advanced: Raw JSON** section shows the full status payload from the broker, including uptime and connection timestamps.

***

## Logs Tab

The Logs tab shows real-time log entries filtered to the selected route.

<Frame caption="Monitor: SiemensS7Route — Logs tab showing three INFO entries for ProcessCloudCLICommand with level filters, JSON format selector, and export controls">
  <img src="https://mintcdn.com/coreflux/W9CJ-kgVY3a3sCeL/images/route-monitor-logs.png?fit=max&auto=format&n=W9CJ-kgVY3a3sCeL&q=85&s=2e5bead40c1792010a422b7cfeffea38" alt="Coreflux HUB Monitor: SiemensS7Route window with Logs tab selected showing three INFO log entries from 16:40:49 for Category Event, Name ProcessCloudCLICommand, Outcome Success, Description Processing MQTT command -addTraceLog with topics CtrlFlux/SiemensS7Route/Fatal, /Error, and /Warning; plus ALL, Fatal, Error, WARN, and INFO 3 filter buttons, a JSON format selector, an export download icon, a 3 / 3 entry counter in the bottom left, and a red Clear Logs icon in the bottom right" width="1024" height="639" data-path="images/route-monitor-logs.png" />
</Frame>

### Filter by Level

Use the filter buttons to show only certain log levels:

| Filter    | Description                 |
| --------- | --------------------------- |
| **ALL**   | Show all log entries        |
| **FATAL** | Fatal errors only           |
| **ERROR** | Errors only                 |
| **WARN**  | Warnings only               |
| **INFO**  | Informational messages only |

### Log Entry Fields

Each log entry displays:

| Field           | Description                          |
| --------------- | ------------------------------------ |
| **Timestamp**   | When the event occurred              |
| **Log level**   | FATAL, ERROR, WARN, or INFO          |
| **Category**    | Event category (e.g., Action, Event) |
| **Name**        | Event or action name                 |
| **Outcome**     | Success or failure                   |
| **Description** | Detailed message or structured data  |

### Export

Use the export dropdown to choose a format:

* **JSON** — Structured export for parsing or integration
* **CSV** — Spreadsheet-friendly format
* **LOG** — Plain text log file

Click **Export** to download the filtered logs.

<Frame caption="Exporting SiemensS7Route logs as JSON with a Logs Exported confirmation toast in the top-right corner">
  <img src="https://mintcdn.com/coreflux/W9CJ-kgVY3a3sCeL/images/route-logs-export.png?fit=max&auto=format&n=W9CJ-kgVY3a3sCeL&q=85&s=1657490ccd652ffc5f6836514b77d9f5" alt="Coreflux HUB Monitor: SiemensS7Route Logs tab displaying the three INFO ProcessCloudCLICommand entries and a Logs Exported toast in the top-right corner confirming Exported 3 logs as JSON, with level filters, JSON format selector, and export controls still visible" width="1024" height="639" data-path="images/route-logs-export.png" />
</Frame>

### Clear Logs

Use **Clear Logs** to remove displayed entries from the view. This does not affect the broker — it only clears the HUB display.

***

## Next Steps

<CardGroup cols={2}>
  <Card title="Routes Configuration" icon="cog" href="/coreflux-hub/routes/configuration">
    Edit route settings if status or logs show connection or configuration issues.
  </Card>

  <Card title="Broker Logs" icon="file-lines" href="/coreflux-hub/system/broker-logs">
    View broker-wide logs for system-level troubleshooting.
  </Card>
</CardGroup>
