> ## Documentation Index
> Fetch the complete documentation index at: https://docs.odigos.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Processor Addition

> Add OpenTelemetry Collector processors to transform, filter, or enrich OpenTelemetry signals in the VM Agent

[Processor addition](/vmagent/setup/configuration/actions/overview#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](https://github.com/odigos-io/odigos/blob/main/collector/builder-config.yaml#L61) are supported.

There are two ways to add a processor addition action: using `odictl` or using YAML files.

<Tabs>
  <Tab title="odictl">
    <Steps>
      <Step title="Launch odictl">
        ```shell theme={null}
        odictl
        ```
      </Step>

      <Step title="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.

        <img
          src="https://mintcdn.com/odigos/vLCErpcm1crPpCjg/images/vmagent/actions/odictl-action-select.png?fit=max&auto=format&n=vLCErpcm1crPpCjg&q=85&s=ce5670b32757477053e84051653a4f2c"
          alt="Select Actions menu"
          style={{    
        width: "700px",
        height: "auto",
        display: "block",
        margin: "0 auto"
      }}
          width="3428"
          height="1916"
          data-path="images/vmagent/actions/odictl-action-select.png"
        />
      </Step>

      <Step title="Select Processor addition">
        Use the arrow keys to move through the list of action types. When **Processor addition** is highlighted, press `Enter`.

        <img
          src="https://mintcdn.com/odigos/vLCErpcm1crPpCjg/images/vmagent/actions/odictl-action-type-processor.png?fit=max&auto=format&n=vLCErpcm1crPpCjg&q=85&s=e46e98be90aa2ffc5700b8bbbacd880a"
          alt="Select Processor addition action"
          style={{    
        width: "700px",
        height: "auto",
        display: "block",
        margin: "0 auto"
      }}
          width="1652"
          height="862"
          data-path="images/vmagent/actions/odictl-action-type-processor.png"
        />
      </Step>

      <Step title="Configure the processor addition">
        1. Press `i` to enter INSERT mode.
        2. Set the processor type and options. Only processors listed in the [Odigos collector builder config](https://github.com/odigos-io/odigos/blob/main/collector/builder-config.yaml#L61) are supported. Set the processor name (e.g., `attributes`, `batch`) and fill in any processor-specific configuration.
        3. When finished, press `Esc`, then type `:wq` to save and exit.

        <img
          src="https://mintcdn.com/odigos/vLCErpcm1crPpCjg/images/vmagent/actions/odictl-action-edit-processor.png?fit=max&auto=format&n=vLCErpcm1crPpCjg&q=85&s=24f8bf1bc445dbcde9c46f043bdb3608"
          alt="Configure Processor addition"
          style={{    
        width: "700px",
        height: "auto",
        display: "block",
        margin: "0 auto"
      }}
          width="1212"
          height="552"
          data-path="images/vmagent/actions/odictl-action-edit-processor.png"
        />

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

      <Step title="Verify the action has been created">
        <img
          src="https://mintcdn.com/odigos/vLCErpcm1crPpCjg/images/vmagent/actions/odictl-action-processor-end.png?fit=max&auto=format&n=vLCErpcm1crPpCjg&q=85&s=487d86bb45b3bfec60a40842b6a37851"
          alt="Verify the action has been created"
          style={{    
        width: "700px",
        height: "auto",
        display: "block",
        margin: "0 auto"
      }}
          width="3426"
          height="1914"
          data-path="images/vmagent/actions/odictl-action-processor-end.png"
        />
      </Step>
    </Steps>
  </Tab>

  <Tab title="YAML">
    <Steps>
      <Step title="Navigate to the actions configuration folder">
        ```shell theme={null}
        cd /etc/odigos-vmagent/actions.d
        ```
      </Step>

      <Step title="Create an action YAML file">
        Create a YAML file for your action using the editor of your choice. The example below uses [vi](https://en.wikipedia.org/wiki/Vi).

        ```shell theme={null}
        sudo vi processor-addition.yaml
        ```
      </Step>

      <Step title="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](https://github.com/odigos-io/odigos/blob/main/collector/builder-config.yaml#L61) 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](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/processor) for each processor's configuration.

        For example:

        ```yaml theme={null}
        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: {}
        ```

        <Note>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.</Note>
      </Step>

      <Step title="Save the file">
        ```shell theme={null}
        :wq!
        ```
      </Step>

      <Step title="Verify the action has been created">
        ```shell theme={null}
        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
        ```
      </Step>
    </Steps>
  </Tab>
</Tabs>