Configuration Files

The agent stores its configuration on the hidden directory .datasentinel located in the userโ€™s home directory.

2 files are present:

  • agent.yml

  • connections.yml

You can modify the agent properties directly through these files (except for passwords, which are encrypted).


The agentโ€™s actions are recorded in the datasentinel.log file located in the log subdirectory of its distribution.

The log file is automatically rotated to remove outdated entries and manage data retention.

By default, the log level is set to INFO. To increase the log level, one can set it to debug in the agent section of the configuration file agent.yml.

Internal Limits

The agent has limits in place to control its consumption and prevent excessive overhead.

Memory usage

Memory consumption of the agent is checked every 15 minutes. If it exceeds the defined limit (2 gigabytes by default) for any reason (which should never append) , the agent stops and notifies the platform of its shutdown. A line is also added to its log file.

You can control this memory limit by setting the max-memory-mb parameter in the agentโ€™s configuration file and restarting the agent for the changes to take effect.

  "version": "3.2.0",
  "port": 8282,
  "max-memory-mb": 1024,
  "last_upload": "",
  "collection-rate": "high",
  "tables-monitoring-limit": 3000,
  "query-monitoring-limit": 30000,
  "sql-max-size": 312000,
  "start_time": "2020-10-23 15:43:23",
  "proxy": {
    "host": "",
    "port": 0,
    "user": "",
    "password": ""
  "upload_server": {
    "host": "",
    "port": 443
  "connections": {
    "connections": 1,
    "running": 1,
    "not running": 0

Last updated