Processor Addition

Processor addition lets you add an OpenTelemetry Collector processor to transform, filter, or enrich signals (e.g., add or delete attributes, batch, sample, mask PII). Processors defined in the Odigos collector builder config are supported. There are two ways to add a processor addition action: using odictl or using YAML files.

odictl
YAML

Launch odictl

odictl

Select the actions menu

Use Tab to focus on the Actions pane or press a, then press Enter or click + Add Action with your mouse.

Select Processor addition

Use the arrow keys to move through the list of action types. When Processor addition is highlighted, press Enter.

Configure the processor addition

Press i to enter INSERT mode.
Set the processor type and options. Only processors listed in the Odigos collector builder config are supported. Set the processor name (e.g., attributes, batch) and fill in any processor-specific configuration.
When finished, press Esc, then type :wq to save and exit.

To cancel creating the action, press Esc if you are in INSERT mode, then type :q! to exit without saving.

Verify the action has been created

Navigate to the actions configuration folder

cd /etc/odigos-vmagent/actions.d

Create an action YAML file

Create a YAML file for your action using the editor of your choice. The example below uses vi.

sudo vi processor-addition.yaml

Add the processor addition configuration

Add a processor addition action with the desired processor type and config. Processors listed in the Odigos collector builder config are supported. Set config.type to one of those processor names (e.g., attributes, batch), and use config.processorConfig for processor-specific options. See the OpenTelemetry Collector Contrib documentation for each processor’s configuration.For example:

name: processor-addition
actionName: processor-addition
notes: ""
signals:
  - TRACES
# pipelines: []  # optional: target specific pipelines (e.g. traces/otlp-datadog)
orderHint: 0
type: processorAddition
config:
  type: ""
  processorName: ""
  processorConfig: {}

Replace config.type with the processor type (e.g., attributes, batch), set config.processorName if desired, and fill config.processorConfig with the processor’s configuration.

Save the file

:wq!

Verify the action has been created

sudo journalctl -u odigos-vmagent | grep 'Action created'

Mar 11 21:59:43 ip-10-0-1-51 odigos-vmagent[611]: time=2026-03-11T21:59:43.580Z level=INFO source=/go/src/github.com/keyval/odigos-vmagent/pkg/components/controller/tower/mutations/create_action_handler.go:41 msg="Action created" name=processor-addition