Agents - Log Monitoring
Agents send their logs to the R-COM Gateway, so you can follow their activity and troubleshoot problems without accessing the edge host. Each agent has two types of logs:
- Agent Logs – Activity of the agent itself: status changes, power and monitoring changes, configuration updates, and connection events.
- Process Logs – Activity of the agent's processes and their components, for example device reads, filtering, and web requests.
Which entries an agent sends depends on its Log Display Level, and how often it sends them depends on its log settings. See General Settings and Connection & Logging.
Log Levels
Log entries use these levels, from most to least severe:
SEVERE → ERROR → WARNING → INFO → CONFIG → FINE → FINER → FINEST
In the log views, select one or more levels under Log Levels to show only entries with those levels.
Agent Logs
To open an agent's logs, go to Agents > Manage Agents, open the agent, and select the Agent Logs tab.
Agent Logs
| Control | Description |
|---|---|
| Log Levels | Shows only entries with the selected levels. |
| Message contains... | Shows only entries whose message contains the text. |
| From / To | Shows only entries within the date and time range. |
| Apply | Applies the filters. |
| Loaded count | Number of entries loaded so far, for example 100 loaded. Scroll down to load more entries. |
| Download icon | Downloads log entries for a time range. See Download Logs. |
| Refresh logs | Loads the latest entries, for example after you change the configuration or reproduce a problem. |
Each entry shows:
| Column | Description |
|---|---|
| Time | When the entry was created. |
| Level | The log level. |
| Message | What happened. |
| Error | An exclamation icon if the entry contains a log exception. See Log Exceptions. |
When an agent starts, its Agent Logs show entries such as:
INFO Status changed to Starting
INFO Starting agent as per desired state
INFO Status changed to Running
Process Logs
You can open process logs in two places:
- Agents > Manage Agents > [agent] > Process Logs – Select the process in the process selector. The selector row also shows the process status, its template and version, and Open process, which opens the process details.
- Agents > Manage Agents > [agent] > Processes > [process] > Log – The logs of one process on the process details page.
Process Logs
| Control | Description |
|---|---|
| Log levels | Shows only entries with the selected levels. |
| Message contains... | Shows only entries whose message contains the text. |
| Component | Shows only entries from the specified component. |
| From / To | Shows only entries within the date and time range. |
| Apply / Reset | Applies the filters, or clears them. |
| Loaded count | Number of entries loaded so far. Scroll down to load more entries. |
| Download icon | Downloads log entries for a time range. See Download Logs. |
| Refresh icon | Loads the latest entries. |
Each entry shows the Time, Level, Component (the component that wrote the entry, for example Readpoint_V1 or WebRequest_V1), Message, and Error column.
ERROR WebRequest_V1 Error sending WebRequest: The operation was canceled.
FINE Readpoint_V1 Status changed: OK (Collection with 1 tag sent)
Download Logs
You can download log entries from the Agent Logs tab and from the Process Logs tab of an agent. On the Process Logs tab, select the process first.
-
Set Log Levels and Message contains... as needed. The download uses these filters.
-
Select the download icon.
-
Choose a time range:
Range Description Quick range Last 1 hour, Last 8 hours, Last 24 hours, or Last 7 days. Between A start and end date and time. In the last A period that ends now. More than ... ago Entries older than the specified time. -
The panel shows the Log Levels and Message contains... values from the tab. Adjust them if needed, then select Download.
If you do not select a time range, the Gateway asks you to choose one before downloading.
Download time range
Log Exceptions
A log exception is a log entry that the agent's logger did not recognize. If Forward Log Exceptions is enabled for the agent, the agent forwards these entries to the Gateway, and they are marked with an exclamation icon in the Error column of both log types.
Select the icon to open the Exception dialog, which shows the exception details (the stack trace) reported by the agent. Include these details when you contact R-COM support.
Exception details