> ## 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.

# URL Templatization

> Replace dynamic URL parts with parameter placeholders in VM Agent OpenTelemetry signals

[URL templatization](/vmagent/setup/configuration/actions/overview#url-templatization) replaces variable parts of URLs with parameter placeholders before the URL is recorded in OpenTelemetry signals (e.g., `/users/123` → `/users/{id}`), keeping cardinality under control and making it easier to group traffic by endpoint pattern.

There are two ways to add a URL templatization 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 URL Templatization">
        Use the arrow keys to move through the list of action types. When **URL templatization** is highlighted, press `Enter`.

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

      <Step title="Configure URL templatization">
        1. Press `i` to enter INSERT mode.
        2. Add one or more templatization rules with a `template` (e.g., `/api/v1/resource/{id}`) and optional `examples`.
        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-url.png?fit=max&auto=format&n=vLCErpcm1crPpCjg&q=85&s=b3be0309fc69b49f9459f584906809d5"
          alt="Configure URL templatization"
          style={{    
        width: "700px",
        height: "auto",
        display: "block",
        margin: "0 auto"
      }}
          width="1162"
          height="514"
          data-path="images/vmagent/actions/odictl-action-edit-url.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-url-end.png?fit=max&auto=format&n=vLCErpcm1crPpCjg&q=85&s=36a6abca986d88f1374fb7c014927d8b"
          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-url-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 url-templatization.yaml
        ```
      </Step>

      <Step title="Add the URL templatization configuration">
        Add a URL templatization action with one or more rule groups. Each rule has a `template` (e.g., `/api/v1/resource/{id}`), optional `examples` of matching URLs, and optional `notes`.

        For example:

        ```yaml theme={null}
        name: url-templatization
        actionName: url-templatization
        signals:
          - TRACES
        # pipelines: []  # optional: target specific pipelines (e.g. traces/otlp-datadog)
        type: urlTemplatization
        config:
          templatizationRulesGroups:
            - notes: ""
              templatizationRules:
                - template: "/api/v1/resource/{id}"
                  examples:
                    - "/api/v1/resource/123"
                  notes: ""
        ```
      </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=url-templatization
        ```
      </Step>
    </Steps>
  </Tab>
</Tabs>