> For the complete documentation index, see [llms.txt](https://docs.apica.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.apica.io/flow/pipeline-management/data-flow-pipelines-new.md).

# Configuring Pipelines

The pipeline is a series of processes through which telemetry data flows systematically. A pipeline can be understood as a grouping of rules that perform certain actions. For example, an extract pipeline can have rules that extract or normalize the data. Similarly, a filter pipeline can have rules that drop logs/fields and redact values from the incoming message. Pipelines can be arranged in a specific order to achieve efficient operation on the incoming data.

## Creating a Pipeline

1. Select **Explore** → **Pipelines**.
2. Select **Actions** → **Create Pipeline**.

<figure><img src="https://2948796384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LmzGprckLqwd5v6bs6m%2Fuploads%2F7KQ3bbzolS0mDtLHZOc9%2Fimage.png?alt=media&amp;token=772410df-38a9-4326-8434-992692b8f2ad" alt=""><figcaption><p>Navigating to Pipeline Page</p></figcaption></figure>

<figure><img src="https://2948796384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LmzGprckLqwd5v6bs6m%2Fuploads%2FpitmwDIn4qWhN8xMIWiZ%2Fimage.png?alt=media&amp;token=879bbd03-698e-4cfe-9212-0d46d34e153b" alt=""><figcaption><p>Actions button to create Pipeline</p></figcaption></figure>

The builder has two panels: **Pipeline Preview** and **Pipeline Configuration**.

<figure><img src="https://2948796384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LmzGprckLqwd5v6bs6m%2Fuploads%2FCWSXTaLnsGExhVHhl0Tf%2FScreenshot%20from%202026-09-18%2015-00-05.png?alt=media&amp;token=986c3bfb-b828-4b4a-9f65-5c0f2ac626ea" alt=""><figcaption></figcaption></figure>

Select **EXISTING RULES** to attach saved rules inin **Configure Rules for - \<pipeline>**.

Each rule opens in **Pipeline Configuration**. Complete its shared fields, condition, and rule-specific settings. See [Rules](/flow/rules.md) for shared fields and conditions.

<figure><img src="https://2948796384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LmzGprckLqwd5v6bs6m%2Fuploads%2F1E8UvFATTM7m8mSWlEaH%2Fimage.png?alt=media&amp;token=9a963592-93fe-42d1-a479-242ba9b84236" alt=""><figcaption><p>A new drop rule was added</p></figcaption></figure>

The rule list shows **Rule Name**, **Rule Type**, **Savings**, **Enabled**, and **Actions**. Drag a rule to reorder execution. Use **Enabled** to switch a rule on or off.

Use **Expand rule** to open one rule at a time. Select **Delete rule** to remove a rule. Confirm **Are you sure you want to remove the rule?**. The deletion takes effect when you save.

Opening a pipeline from **Pipelines** uses a full page. Opening it from the topology graph uses **Configure Pipeline** as a modal. Both views have **Close** and **Save** buttons.

Validation runs when you select **Save**. A banner lists all issues. For each missing required rule field, it displays: `&lt;Field(s)&gt; is a required field and cannot be empty in &lt;rule name&gt; rule.` A missing pipeline name displays: `Pipeline name is a required field and cannot be empty.`

<figure><img src="https://2948796384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LmzGprckLqwd5v6bs6m%2Fuploads%2FlXCNXEaVcJ95B9KKPcJ2%2FScreenshot%202025-05-02%20215739.png?alt=media&amp;token=934e64ca-1362-4340-ac32-135290cf7ab3" alt=""><figcaption><p>Created pipeline displayed in the pipeline list</p></figcaption></figure>

### Editing a Pipeline

To edit a pipeline, open **Explore** → **Pipelines**. Select the ellipsis beside the pipeline, then select **Configure Pipeline**. It opens as a full page from **Pipelines**.

<figure><img src="https://2948796384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LmzGprckLqwd5v6bs6m%2Fuploads%2FKmuBoEn4yMO18AMmEgZd%2Fimage.png?alt=media&amp;token=cb4b85e6-bf2f-4e57-a61a-5eea9b711ead" alt=""><figcaption></figcaption></figure>

## Pipeline Preview

Pipeline Preview updates automatically after every pipeline or rule change. It displays the selected logs and changes in the `Diff` view.

#### Use Sample Logs:

Sample Logs allows you to provide custom logs to preview:

<figure><img src="https://2948796384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LmzGprckLqwd5v6bs6m%2Fuploads%2F3bebIyJgnfpnPLM1tlEM%2Fimage.png?alt=media&amp;token=89098921-79b3-4236-bf31-63ab5c566ab0" alt=""><figcaption><p>The dropdown helps select the sample logs for preview</p></figcaption></figure>

#### Use Data Flows:

Using Dataflows, you can select data that was previously ingested into the platform and run a preview.\
**Note:** If the data from the selected namespace and application has already passed through the current pipeline, the preview may not fully reflect the intended changes.

<figure><img src="https://2948796384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LmzGprckLqwd5v6bs6m%2Fuploads%2FtC8hX5KEU7IzdBN9fbHi%2Fimage.png?alt=media&amp;token=64da56f3-1ee2-49cc-99a5-cb5b49865269" alt=""><figcaption></figcaption></figure>

#### Use GenAI:

Using the GenAi option, you can interact with an AI Agent to curate the right set of logs for the pipeline preview.<br>

<figure><img src="https://2948796384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LmzGprckLqwd5v6bs6m%2Fuploads%2FBqtmpHblVdH43vmqqWbE%2Fimage.png?alt=media&amp;token=81f6038d-1aac-4260-98dc-71f4251b8287" alt=""><figcaption></figcaption></figure>

#### Use Captured Data:

With Captured Data, lookup files that contain logs can be used for running a pipeline preview.

<figure><img src="https://2948796384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LmzGprckLqwd5v6bs6m%2Fuploads%2FSxbPPd4SzbGt4webN2vy%2Fimage.png?alt=media&amp;token=2c36e781-ce7f-4437-8673-eeec3b1a12d3" alt=""><figcaption></figcaption></figure>

#### Live Tail

With Live tail, use the raw logs that are getting ingested in real time to run the pipeline preview.

<figure><img src="https://2948796384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LmzGprckLqwd5v6bs6m%2Fuploads%2FyXqlvyz8r0G2BpRnwgxl%2Fimage.png?alt=media&amp;token=11e2aa78-3be5-434f-ad7a-390a8cf19c76" alt=""><figcaption></figcaption></figure>

#### View Preview Changes:

To view the preview changes, click on the `Diff` tab in the Pipeline Preview Section:

<figure><img src="https://2948796384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LmzGprckLqwd5v6bs6m%2Fuploads%2FeXk7j0DV51VrNLhFMFDd%2FScreenshot%20from%202026-08-28%2019-22-32.png?alt=media&amp;token=94652be0-f742-4d55-a2fb-204798a8c5b7" alt=""><figcaption></figcaption></figure>

After configuring the pipeline and its rules and testing them, click on the Save button in the bottom right section of the page.

### Apply Pipeline

Using the `Apply Pipeline` option we will be able to apply the pipeline to multiple `Dataflow`.

<figure><img src="https://2948796384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LmzGprckLqwd5v6bs6m%2Fuploads%2Fk8QIh553ZWFTjAwMRKlM%2Fimage.png?alt=media&amp;token=cc3c8d05-fe41-455a-b43d-5032eaf8e389" alt=""><figcaption><p>Apply Pipeline to associate the Namespace and Application to it</p></figcaption></figure>

Select the time range and then select Namespace and Application (Dataflow) to which you want to apply the pipeline. When a namespace and application have other Pipelines linked to it they will be displayed as well, the new one we are trying to associate will be displayed at the bottom and outlined by Green. User will be able to reorder by dragging.

<figure><img src="https://2948796384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LmzGprckLqwd5v6bs6m%2Fuploads%2FbbFIwTAQIFYhUWpTaora%2Fimage.png?alt=media&amp;token=811a9de4-a86b-471a-bf07-a5077cda6f0a" alt=""><figcaption><p>New pipeline added outlined by green</p></figcaption></figure>

<figure><img src="https://2948796384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LmzGprckLqwd5v6bs6m%2Fuploads%2FLjNTydxvLBMHDWlbYwS3%2Fimage.png?alt=media&amp;token=652cf3d0-2525-46a6-a4fe-d399fb3e2e51" alt=""><figcaption><p>Oder can be set by dragging the pipelines.</p></figcaption></figure>

Once desired order has been set Click on `Apply` to apply it to the Dataflow. Post this the execution will be in the order of the Pipeline set.

### Pipeline View:

All the Dataflows linked are displayed under the Pipeline and can be accessed using the Arrow icon.

<figure><img src="https://2948796384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LmzGprckLqwd5v6bs6m%2Fuploads%2F3jpKMSK8M5nB9jUQYWVf%2Fimage.png?alt=media&amp;token=e61701e6-a485-426d-8189-cae4b1efce88" alt=""><figcaption><p>All the linked Dataflow are displayed under the Pipeline. Along with the stats.</p></figcaption></figure>

The Stats displays the Events Ingested, Events Processed and Saved Bytes:

* Green Indicates the total `Events Ingested`.
* Orange Indicates the `Events Processed`.
* Red Indicates the `Saved Bytes`.

Pipelines stats is the total amount of Events and Saved Bytes and the data for each of the associated Dataflow is displayed against the individual Dataflows.
