> For the complete documentation index, see [llms.txt](https://docs.onum.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.onum.com/data-sinks.md).

# Data Sinks

## Overview

Onum outputs data via **Data Sinks**. Use them to define where and how to forward the results of your streamlined data.

Click the **Data sinks** tab for a general overview of the Data Sinks configured in your Tenant and the events sent. 

<figure><img src="/files/qzqd19BWTOJBvSkquU5B" alt=""><figcaption></figcaption></figure>

* The orange graph at the top plots the volume ingested by your Data Sinks. Use the buttons above the graph to switch between **Events**/**Bytes**, and the **Frequency** slider bar to choose how frequently you want to plot the events/bytes in the chart. Use the **Stack data sinks** toggle to view each individual Data Sink on your graph and its metrics. Learn more about this graph [in this article](/understanding-the-essentials/graph-calculations.md).
* Hover over a point on the chart to show a tooltip containing the events/bytes coming in for the selected time, as well as a percentage of how much increase/decrease has occurred between the previous lapse of time and the one currently selected.

At the bottom, you have a list of all the Data Sinks in your Tenant. You can switch between the **Cards** view, which shows each Listener in a card, and the **Table** view, which displays Listeners listed in a table. Learn more about the cards and table views [in this article](/understanding-the-essentials/cards-and-table-views.md).

## Narrow down your data

There are various ways to narrow down what you see in this view:

### **Add Filters**

Add filters to narrow down the Sinks you see in the list. Click the **+ Filter** button and select the required filter type(s). You can filter by:

* **Name** - Select a **Condition** (**Contains**, **Equals**, or **Matches**) and a **Value** to filter Data Sinks by their names.
* **Version** - Filter Data Sinks by their version.&#x20;
* **Type** - Choose the Data Sinks type(s) you want to see in the list.
* **Created by** - Selecting this option opens a **User** drop-down where you can filter by creator.
* **Updated by** - Selecting this option opens a **User** drop-down where you can filter by the last user to update a Pipeline.

The filters applied will appear as tags at the top of the view.

{% hint style="warning" %}
Note that you can only add one filter of each type.
{% endhint %}

### **Select a Time Range** <a href="#select-a-time-range" id="select-a-time-range"></a>

If you wish to see data for a specific time period, this is the place to click. Go to [this article](https://app.gitbook.com/o/9sm794iTBacZSmhxRER6/s/kxZeV4nlXcIAjMGZxzLI/~/changes/2144/getting-started/understanding-the-essentials/the-time-range-selector) to dive into the specifics of how the time range works.

### **Select Tags**

You can choose to view only those Sinks that have been assigned the desired tags. You can create these tags in the Data Sinks settings or from the cards view. Press the `Enter` key to confirm the tag, then **Save**.

To filter by tags, click the **Tags** button, select the required tag(s) and click **Save**.

## Create a Data Sink

Depending on your permissions, you can create a new Data Sink from this view. There are several ways to create a new Data Sink:

* From the **Data sinks** view, clicking the **New data sink** button.
* From[ the Home page](https://docs.onum.com/the-workspace/home), clicking **Create new > Data sink** or clicking the **+** button in the **Data sinks** column of the Sankey diagram.
* Hover over the **Data sinks** section in the left pane and click the **Createdata sink** button that appears in the search window.
* Within a [Pipeline](https://docs.onum.com/the-workspace/pipelines).

Configuring your Data Sink involves various steps:

{% stepper %}
{% step %}

### Choose your Data Sink type

The first step is to define the Data Sink **Type**. Select the desired type in this window and select **Configuration**, or double-click it.

Check the list of available Data Sink types in [this article](https://docs.onum.com/the-workspace/listeners/listener-integrations).
{% endstep %}

{% step %}

### Configure your Data Sink

The configuration is different for each Data Sink type. Check the different Data Sink types and how to configure them [in this section](/data-sinks/data-sink-integrations.md).
{% endstep %}

{% step %}

### Add Labels

Use Onum's labels to cut out the noise with filters and search criteria based on specific metadata. This way, you can categorize events sent on and processed in your [Pipelines](https://docs.onum.com/the-workspace/pipelines).

Learn more about labels [in this article](https://docs.onum.com/the-workspace/listeners/labels).
{% endstep %}
{% endstepper %}

## Edit a Data Sink

You can edit an existing Data Sink by double-clicking it in the **Data Sinks** view. You'll be directly taken to its configuration form, where you can edit any required values.

Alternatively, click the ellipses in the card or table view in the **Data sinks** area and select **Edit**, or click a Data Sink to access its details view and select **Edit data sink**.

<br>