Docs » Install and configure Splunk Distribution of OpenTelemetry Collector » Use the Collector with Splunk Observability Cloud » SignalFx Smart Agent configuration translation tool

SignalFx Smart Agent configuration translation tool 🔗

Use translatesfx to translate your existing Smart Agent configuration file into a configuration that can be used by the Collector. translatesfx is a command-line tool provided by Splunk Observability Cloud.

Note

translatesfx aims to automate most of the configuration changes required when migrating from the Smart Agent to the Collector. Any configuration produced by translatesfx should be carefully evaluated and tested before being put into production.

There are two approaches to using translatesfx, from the command line or from the GUI.

From the command line 🔗

To run the tool from the command line, download the executables from the releases page. The executables are also contained in the RPM, MSI, and Debian packages as well as the Docker images (version 0.36.1 and higher).

The translatesfx command requires one argument, a Smart Agent configuration file, and accepts an optional second argument, which is the the working directory used by any Smart Agent #from file expansion directives. The translatesfx command uses this working directory to resolve any relative paths to files referenced by any #from directives at runtime.

% translatesfx <sfx-file> [<file expansion working directory>]

If this working directory argument is omitted, translatesfx expands relative file paths using the current working directory:

% translatesfx path/to/sfx/<config-filename>.yaml
% translatesfx /etc/signalfx/sa-config.yaml

When translatesfx runs, it sends the translated Collector configuration to the standard output. To write the contents to disk, redirect this output to a new Collector configuration file:

% translatesfx /etc/signalfx/sa-config.yaml > /etc/signalfxotel-config.yaml

From the GUI 🔗

  1. Access the Smart Agent configuration converter at https://bossofopsando11y.com/configurator/saconverter. This tool is translatesfx with a GUI.

  2. Paste your Smart Agent configuration in the Smart Agent YAML section of the GUI.

The corresponding translated Collector configuration file is populated in the OpenTelemetry YAML section.

View your translated configuration file.