Process Resources Collector

Summary

The Process Resources Collector can be used to collect CPU- and Memory-type metrics on a per-process level. Additional configuration options are available below the instructions.

Configuration

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 collectors folder.
    The default location is /opt/netuitive-agent/conf/collectors.
  2. Open the ProcessResourcesCollector.conf file.
  3. Change the enabled setting to True.
  4. For each process you’d like to monitor, include the following below the [process] section:
    [[process_name]]
    name = ".*regex-statement.*"

    …where process_name is the name of the process you want to monitor and .*regex-statement.* is the proper “name contains” regular expression syntax used to capture the process’s metrics.

    The below snippet details how to capture NGINX process metrics using a regex statement for names that begin with “nginx”:

    [[nginx]]
    name = "^nginx"
  5. Save the configuration file, and restart the Linux Agent.

Additional Configuration Options

  • Collector Options
    Option Default Description
    enabled False Enable collecting these metrics.
    process
    [[example_process_name]]
        name = ".*sample_regex.*"
    
        [[diamond]]
        selfmon=True
    A subcategory of settings inside of which each collected process has its configuration.
    byte_unit Default numeric output(s).
    cmdline Regex that matches the full command line process name (including all the options).

    cmdline=java.*Elasticsearch
    exe Regex that matches the executable file that’s used to run the process.

    exe=^\/usr\/lib\/postgres\/+d.+d\/bin\/postgres$
    measure_collector_time Measure the collector’s run time in milliseconds.
    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.
    unit The unit of the memory data collected.

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