Docs » Configure application receivers » Configure application receivers for hosts and servers » Host process list

Host process list 🔗

Description 🔗

The Splunk Distribution of OpenTelemetry Collector provides this integration as the processlist monitor via the Smart Agent Receiver.

This monitor reports the currently running processes for a host, analogous to how the top or ps command on Unix/Linux systems works. The output format is a special base64-encoded event that gets processed by our backend and displayed under the Infrastructure view for a specific host. Historical process information is not retained on the backend, only the most recent version.

See signalfx-agent/pkg/monitors/processlist/ for the monitor source.

Installation 🔗

This monitor is available in the SignalFx Smart Agent Receiver, which is part of the Splunk Distribution of OpenTelemetry Collector.

To install this integration:

  1. Deploy the Splunk Distribution of OpenTelemetry Collector to your host or container platform.

  2. Configure the monitor, as described in the next section.

Configuration 🔗

The Splunk Distribution of OpenTelemetry Collector allows embedding a Smart Agent monitor configuration in an associated Smart Agent Receiver instance.

Note: Providing a processlist monitor entry in your Smart Agent or Collector configuration is required for its use. Use the appropriate form for your agent type.

Smart Agent 🔗

To activate this monitor in the Smart Agent, add the following to your agent configuration:

monitors:  # All monitor config goes under this key
 - type: processlist
   ...  # Additional config

See Smart Agent example configuration for an autogenerated example of a YAML configuration file, with default values where applicable.

When used with the Smart Agent Receiver, this monitor must also be used in a logs pipeline with a Resource Detection processor. For more information, see SignalFx Smart Agent Receiver Configuration.

Splunk Distribution of OpenTelemetry Collector 🔗

If you are using the Splunk Distribution of OpenTelemetry Collector and want to collect metrics about the processes currently running on a host, use the Host Metrics Receiver.

Metrics 🔗

There are no metrics available for this integration.