Skip to content

Latest commit

 

History

History
 
 

smartagentextension

README.md

SignalFx Smart Agent Extension

Note: The SignalFx Smart Agent extension is only supported on x86_64/amd64 platforms. Support for arm64 platforms is currently experimental.

The smartagent extension provides a mechanism to specify config options that are not just specific to a single instance of the Smart Agent Receiver but are applicable to all instances. This component provides a means of migrating your existing Smart Agent configuration to the Splunk Distribution of OpenTelemetry Collector.

As the Smart Agent Receiver doesn't provide 1:1 functional parity with the SignalFx Smart Agent in itself, only a subset of existing configuration fields are supported by the Smart Agent Extension at this time:

  1. The bundleDir field refers to the path of a supported Smart Agent release bundle. The x86_64/amd64 Splunk Distribution of OpenTelemetry Collector packages include the agent bundle, and their installers source its value via the SPLUNK_BUNDLE_DIR environment variable by default.
  2. The collectd field refers to performance and debugging configurables for the collectd subprocess and associated mechanisms. If the Smart Agent Extension or this field are not configured, the Agent defaults will be inherited. This configuration object's configDir refers to the location for internal configuration files and is set to the value of the SPLUNK_COLLECTD_DIR environment variable by the default agent deployment mode config.
  3. procPath for host or mounted container procfs access (default /proc)
  4. etcPath for host or mounted container volume/filesystem etc content (default /etc)
  5. varPath for host or mounted container volume/filesystem var content (default /var)
  6. runPath for host or mounted container volume/filesystem run content (default /run)
  7. sysPath for host or mounted container sysfs access (default /sys)

In the below example configuration, configDir and bundleDir will be used for all instances of the smartagent receiver that wrap around a collectd based monitor.

extensions:
  smartagent:
    bundleDir: /bundle/
    procPath: /custom/proc
    collectd:
      configDir: /tmp/collectd/config