# Data Sinks

Essentially, Onum outputs data via Sinks. Use them to define where and how to forward the results of your streamlined data.&#x20;

{% embed url="<https://youtu.be/EW8jnciyBEY>" %}

{% hint style="info" %}
To learn more about the **types** of Data sinks, go to [Configure a Data sink ](https://docs.onum.com/the-workspace/pipelines/data-sinks)or go to the article for the specific Data sink you are interested in.
{% endhint %}

## Overview

Click the **Data sinks** tab for a general overview of the Data sinks configured in your Tenant and the events sent.&#x20;

<div data-full-width="false"><figure><img src="https://965373739-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkxZeV4nlXcIAjMGZxzLI%2Fuploads%2Fbc9BQZ2nSQ2C309FBCav%2Flistener%20(2d.png?alt=media&#x26;token=44625363-fdd5-44d9-a71e-703069cbc9ff" alt=""><figcaption></figcaption></figure></div>

The graph at the top plots the volume ingested by your sinks. Click **Events** to see the events in for all your sinks, or **Bytes** to see a bar graph representing the bytes in. Learn more about this graph [in this article](https://docs.onum.com/getting-started/understanding-the-essentials/graph-calculations).

* Use the **Stack Data sinks** toggle to view each individual Sink on your graph and its metrics.

Hover over a point on the chart to show a tooltip containing the Events and Bytes OUT 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.

<figure><img src="https://965373739-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkxZeV4nlXcIAjMGZxzLI%2Fuploads%2ForoYExC87KVmnfYtV2Ev%2Fdark-medium%20(13).png?alt=media&#x26;token=d43faec0-05e6-4ea2-862b-58cf0a7f7e0a" alt=""><figcaption></figcaption></figure>

At the bottom, you have a list of all the 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](https://docs.onum.com/getting-started/understanding-the-essentials/cards-and-table-views).

<figure><picture><source srcset="https://965373739-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkxZeV4nlXcIAjMGZxzLI%2Fuploads%2FwKsuf4lDgEmMI5f1L0sB%2Fsink-visualize-all-sinks-dark.png?alt=media&#x26;token=b095f699-64bd-4ade-b8ec-9aea2379cc93" media="(prefers-color-scheme: dark)"><img src="https://965373739-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkxZeV4nlXcIAjMGZxzLI%2Fuploads%2Fo5GZ10aSRlL0cmnBg4Fn%2Fsink-visualize-all-sinks-light.png?alt=media&#x26;token=a9263dee-617d-4be4-85c5-25da90930443" alt=""></picture><figcaption></figcaption></figure>

Depending on your Permissions, click the ellipses in the right-hand corner of the Data sink card to reveal the options to **Edit, Copy ID,** or **Remove** it.

Click a sink to open its configuration in the right-hand pane. Click the ellipses in the top right to **Copy ID** or **Remove** it.

{% hint style="info" %}
If your data sink is in use, you can see where it is being used and specify which pipeline to remove it from.
{% endhint %}

## 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 **+ Add 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 Sinks by their names.
* **Type**: Choose the Sinks type(s) you want to see in the list.
* **Version**: Filter Sinks by their version.&#x20;
* **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 %}

<figure><picture><source srcset="https://965373739-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkxZeV4nlXcIAjMGZxzLI%2Fuploads%2FQ6xhLfe637PEzZX72a9m%2Fsink-add-filter-dark.png?alt=media&#x26;token=fa4562f7-695f-46f9-8650-5c72b9fc0107" media="(prefers-color-scheme: dark)"><img src="https://965373739-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkxZeV4nlXcIAjMGZxzLI%2Fuploads%2Fhoh5bqO6Q3QRLUQrxG35%2Fsink-add-filter-light.png?alt=media&#x26;token=21b2a2ad-8245-4ff7-8002-9850c5d88d55" alt=""></picture><figcaption></figcaption></figure>

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

<figure><picture><source srcset="https://965373739-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkxZeV4nlXcIAjMGZxzLI%2Fuploads%2FSrsW5f5VnUdbMauNiNsj%2Fsink-tag-dark.png?alt=media&#x26;token=33d24d68-61d7-4b64-b83b-318d7e2fff22" media="(prefers-color-scheme: dark)"><img src="https://965373739-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkxZeV4nlXcIAjMGZxzLI%2Fuploads%2F7pave5vOCPC3EocOHs2e%2Fsink-tag-light.png?alt=media&#x26;token=47a59faa-bff3-42dd-89e5-acd5015fdfdf" alt=""></picture><figcaption></figcaption></figure>

***

## Create a Data Sink

Depending on your permissions, you can create a new sink from this view.&#x20;

There are several ways to create a new Data sink:

***

**From the** [**Data sinks**](https://docs.onum.com/the-workspace/pipelines/data-sinks) **view**

<div data-full-width="false"><figure><picture><source srcset="https://965373739-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkxZeV4nlXcIAjMGZxzLI%2Fuploads%2FHNgEZF6rqjykZD7RP5eB%2Fdark-medium%20(19).png?alt=media&#x26;token=a02edf61-bec6-4eaa-8205-6824ad542867" media="(prefers-color-scheme: dark)"><img src="https://965373739-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkxZeV4nlXcIAjMGZxzLI%2Fuploads%2F3nqiRQP2ievaBj3cE0jA%2Flight-medium%20(20).png?alt=media&#x26;token=08922370-1f24-4de0-9e86-d743712f89e3" alt=""></picture><figcaption></figcaption></figure></div>

***

**Within a** [**Pipeline**](https://docs.onum.com/the-workspace/pipelines)

<figure><picture><source srcset="https://965373739-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkxZeV4nlXcIAjMGZxzLI%2Fuploads%2FePrWewks471V7g2vrxd3%2Fsink-creation-pipeline-dark.png?alt=media&#x26;token=c046257b-57f4-4dfa-ad90-2b0a7a1f82c1" media="(prefers-color-scheme: dark)"><img src="https://965373739-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkxZeV4nlXcIAjMGZxzLI%2Fuploads%2FoouGja3E5rimGihZ8VSN%2Fsink-creation-pipeline-light.png?alt=media&#x26;token=15310cbd-c304-4ed1-a170-65d61be812fa" alt=""></picture><figcaption></figcaption></figure>

***

**From the** [**Home**](https://docs.onum.com/the-workspace/home) **page**

<figure><picture><source srcset="https://965373739-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkxZeV4nlXcIAjMGZxzLI%2Fuploads%2FYMBPbyXuiDhth9BlXQ1v%2Fsink-creation-homepage-dark.png?alt=media&#x26;token=3c224c2c-4415-478d-b60b-82ecfdb8553b" media="(prefers-color-scheme: dark)"><img src="https://965373739-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkxZeV4nlXcIAjMGZxzLI%2Fuploads%2FYxWZ8bqYDGGwR3cLuomr%2Fsink-creation-homepage-light.png?alt=media&#x26;token=42544582-8b19-476d-9d80-943ba90c3b98" alt=""></picture><figcaption></figcaption></figure>

***

This will open the Data sink creation flow.

## Configure a Data Sink

There are various steps to configuring your Data sink. You can open the Configuration by Creating a new Data sink, or by clicking one in the Data sinks tab or the Pipeline view and selecting **Edit Data sink** in the pane that opens.

Alternatively, click the ellipses in the **card** view and select **Edit.**

### 01. Type

The first step is to define the **Type.** Choose the desired Type from the List and select **Configuration.**

<figure><picture><source srcset="https://965373739-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkxZeV4nlXcIAjMGZxzLI%2Fuploads%2F188v39VjDx52Iquz0ioF%2Fselect%20type-dark.png?alt=media&#x26;token=c7895de1-faeb-465a-958c-0c803b911d82" media="(prefers-color-scheme: dark)"><img src="https://965373739-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkxZeV4nlXcIAjMGZxzLI%2Fuploads%2FvxCTDsaUd9cthfcm5Cre%2Fselect%20type-light.png?alt=media&#x26;token=bda053ba-9d74-401b-901a-66ed2cbdba69" alt=""></picture><figcaption></figcaption></figure>
