Monitoring Agent Logs

The Monitoring Agent Logs are available from the location where the Obkio Monitoring Agent was installed. A subset of these logs are also uploaded to the Obkio platform and can be viewed from the Web application. These logs are useful to troubleshoot issues or understand what's going on with an agent. The Obkio support team might need these logs to better assist a client.

Only a subset of the Monitoring Agent Logs are uploaded to the Obkio platform in order to only store the most meaningful information. The complete set of logs can be obtained from the Monitoring Agent. These logs are available from the Web application through the following steps :

1. Select on the Agent icon available on the left side menu.
2. Select the Agent that contains the logs.
3. Select the three dots button available on the top right of the screen.
4. Select View logs.

Note: The logs from a public agent are not available from the Web application.

The location of the Monitoring Agent Logs depends on the type of agents used. Here's the default location for each type of Monitoring Agent :

• Docker Software Agent -> Look for the STDOUT of the container. docker logs <comtainer-id> can be used to view this output.
• Linux Software Agent -> /opt/obkio/apps/agent/agent*.log (supervisor: /opt/obkio/logs/).
• macOS Software Agent -> /Library/ObkioSupervisor/apps/agent/agent*.log (supervisor: /Library/ObkioSupervisor/logs/).
• Windows Software Agent -> C:\Program Files\Obkio Supervisor\apps\agent\agent*.log (supervisor: C:\Program Files\Obkio Supervisor\logs\).
• Hardware Agent -> These logs are only available to Obkio support team.
• Public Agent -> These logs are only available to the enterprise hosting the agent.
• Virtual Appliance Agent -> These logs are only available to Obkio support team.

Over time, multiple files are used to store the logs. agent*.log is used to represent these files: the current one is agent.log and older ones are renamed with a timestamp, for example agent-2026-11-10T15-04-05.000.log. The Obkio Supervisor writes its own logs to obkio-supervisor-<version>.log in its logs directory, rotated the same way. For more information, look at the log retention documentation.

Note: Agents installed before the Obkio Supervisor (agent v2) still write their logs to the old locations: /opt/obkio/agent.log* on Linux, /Library/ObkioAgent/agent.log* on macOS and C:\Program Files\Obkio\agent.log* on Windows. Their logs rotate at 5.24 MB as agent.log.1, agent.log.2 and so on, up to 10 files.

The agent will store up to 10 MB (10 485 760 bytes to be exact) of logs in the agent.log file. Once the maximum file size is reached, the file will be renamed with a timestamp, for example agent-2026-11-10T15-04-05.000.log, and the following logs will be put in a new agent.log file. Up to 3 of these older files are kept: when a new one is created, the oldest is deleted. The Obkio Supervisor log works the same way with a 5 MB file size and 3 older files, and its files are also deleted after 90 days.

At that point, the oldest file agent.log.10 is deleted when the agent.log reaches again the maximum file size. So, the agent can store up to 57.64 MB of logs (11 files of ~ 5.24 MB each for a brief moment).