Monitor Resilio with DataDog

Feature availability

DataDog integration is available in Resilio 6.0 and newer.

You can monitor your Resilio deployment with DataDog via a custom Agent check script.

Prerequisites

Monitoring your Resilio deployment with DataDog requires:

• A DataDog Agent with the logs_enabled: true in the Agent's datadog.yaml configuration file.
• API feature enabled in your Resilio license.

Set up DataDog integration

To monitor your Resilio deployment with DataDog:

1. Download the resilio_reporting.py DataDog Agent check script and place it in your DataDog Agent's checks.d directory.

   • Linux: /etc/datadog-agent/checks.d/resilio_reporting.py
   • Windows: C:\ProgramData\Datadog\conf.d\resilio_reporting.py

   Note

   The script provided is a sample implementation of a DataDog Agent check. You can modify it or use it as a reference to create your own.

2. Download the conf.yaml configuration file and place it in your DataDog Agent's conf.d directory.

   • Linux: /etc/datadog-agent/conf.d/sync_it_reporting.d/conf.yaml
   • Windows: C:\ProgramData\Datadog\conf.d\sync_it_reporting.d\conf.yaml

3. Generate API token:

   Important

   The API token must be tied to an administrator account with Super Administrator permissions to ensure access to audit logs. Note that this token can be used to access all Management Console's API endpoints, so it should be kept secure.

   1. In the Management Console, select Settings > API.
   2. Click + Create new token.
   3. Enter description, select an administrator account that will be tied to this token, then click Save.
   4. Copy the token value and use it in the next step.

4. Edit the conf.yaml file and add your API token and the Management Console's URL.

   init_config:
   
   instances:
     - base_url: https://<YOUR_RESILIO_SERVER_HOST>:8446
       api_token: "<YOUR_API_TOKEN>"
       views:
         - audit_logs_view
         - events_logs_view
         - file_events_view
       query_limit: 10000
       tls_verify: true
       tags:
         - env:dev
         - service:resilio-reporting
       min_collection_interval: 60
   
   logs:
     - type: integration
       source: resilio_reporting
       service: resilio-reporting
   

   tls_verify

   tls_verify parameter must be true in production environments, unless you configure trust for an internal CA instead.

5. (Optional) To enable verification via self-signed CA, add ca_cert parameter to your configuration file with a path to your custom CA bundle file on the Agent host.

   init_config:
   
   instances:
     - base_url: https://<YOUR_RESILIO_SERVER_HOST>:8446
       api_token: "<YOUR_API_TOKEN>"
       ca_cert: "/etc/ssl/certs/trust-but-verify.pem"
       views:
         - audit_logs_view
         - events_logs_view
         - file_events_view
       max_pages_per_check: 20
       query_limit: 2000
       tls_verify: true
       tags:
         - env:dev
         - service:resilio-reporting
       min_collection_interval: 60
   
   logs:
     - type: integration
       source: resilio_reporting
       service: resilio-reporting