WHERE DO I START?
You are here:Integrations > Docker

Docker

Summary

Docker is an open way of building, shipping, and running distributed applications anywhere using containers and images. Netuitive can be used to monitor the performance of your Docker host and containers.

Important   Each Docker container you have running will be listed as Docker Container in your Inventory Explorer. Each Docker host you have running will be listed as SERVER in your Inventory Explorer. You'll be able to identify which of your SERVER elements are Docker hosts via the Docker Summary dashboard (if you have the Docker package installed).
Tip   Netuitive also offers a Docker container with the Linux agent configured to send Docker host and container metrics. The Linux agent Docker container should be used only if the Linux agent cannot be installed on the host.

Configuration

Important   If you haven't installed the Linux agent already, see the instructions on this page for how to install it. If you need to disable the Linux integration or view the unique API key assigned to your account, navigate to the Integrations page under the user account drop-down menu and click the integration designated as Infrastructure under the Integration column.

Collector Configuration

  1. Navigate to the Linux Agent configuration file.
    Note   The configuration file is typically found at /opt/netuitive-agent/conf/netuitive-agent.conf.
  2. Change the enabled setting to True in the [[NetuitiveDockerCollector]] section of the file.
  3. Optionally, add a metric blacklist or whitelist to reduce the number of metrics you receive.

    Regex Examples

    • Escape special regex characters (e.g., ., *, /, etc.) using a /. The following would match containers.*.blkio. metrics and exclude them from collection. For a list of special regex characters you may have to escape, consult this page.
      metrics_blacklist = containers\..*\.blkio\..*
    • Match multiple containers between ( ) and separated by |. The following would match any of the following container IDs and exclude them from collection: abcdef123456, 123456abcdef, ghijkl789012.
      metrics_blacklist = containers\.(abcdef123456|123456abcdef|ghijkl789012)\..*
  4. Save the file, and restart the Linux agent.
  5. Note   This integration's package (computed metrics, dashboards, and policies that will give you important events and alerts) will be automatically enabled and provisioned to your account as soon as Netuitive receives data from the integration. The PACKAGES button on the integration setup page will become active once data is received, so you'll be able to disable and re-enable the package at will.

Additional Configuration Options

Collector Options

Option Default Description
enabled False Enable collecting Docker metrics.
byte_unit   Default numeric output(s).
measure_collector_time   Measure the collector's run time in milliseconds.
memory_path   The path to the kernel's CGroups memory file system.
metrics_blacklist   Regex list to match metrics to block. Mutually exclusive with metrics_whitelist option.
metrics_whitelist   Regex list to match metrics to transmit. Mutually exclusive with metrics_blacklist option.

Dependencies

OS

Redhat 6 and 7
CentOS 6 and 7
Amazon Linux (latest)
Ubuntu 12, 14, 15, and 16
Debian 7, 8, and 9

Miscellaneous

Linux Agent
Docker v. 1.6+

Metrics