> 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/data-sink-integrations/send-data-using-tcp.md).

# Send data using TCP

{% hint style="info" %}
See the changelog of this Data sink type [here](/data-sinks-changelog/tcp-data-sink.md).
{% endhint %}

## Overview

Onum supports integration with [TCP](https://en.wikipedia.org/wiki/Transmission_Control_Protocol).

TCP (Transmission Control Protocol) is a core protocol of the Internet Protocol Suite. It ensures reliable, ordered, and error-checked data delivery between applications running on hosts in a network.&#x20;

## Onum Setup

{% stepper %}
{% step %}
Log in to your Onum tenant and click **Data Sinks> New Data sink**.
{% endstep %}

{% step %}
Double-click the **TCP** Sink.
{% endstep %}

{% step %}
Enter a **Name** for the new Data Sink. Optionally, add a **Description** and some **Tags** to identify the Sink.
{% endstep %}

{% step %}
Decide whether or not to include this Data sink info in the metrics and graphs of the [**Home**](/home.md) area.

<figure><picture><source srcset="/files/Y7MGj4BnH2htMdfOsrmA" media="(prefers-color-scheme: dark)"><img src="/files/xubgqAglLbu2xqoCyK19" alt=""></picture><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Enter the **Host**<mark style="color:red;">**\***</mark> IP address or hostname. Use `0.0.0.0` to indicate all and the IP **Port**<mark style="color:red;">**\***</mark> number.
{% endstep %}

{% step %}
Choose **Gzip** if you need to compress your events using this method or **None** to send them as they come.
{% endstep %}

{% step %}
Activate the **TLS configuration** toggle if you want to set a TLS connection. Configure the following parameters:

* **Minimum TLS version**<mark style="color:red;">**\***</mark> - Choose the minimum TLS version required for incoming connections.
* **Certificate**<mark style="color:red;">**\***</mark> - Select your CA certificate from the list of your tenant's [Secrets](/settings/organization-settings/secrets-management.md) or create a new one.
* **Private key**<mark style="color:red;">**\***</mark> - Select your private key from the list of your tenant's [Secrets](/settings/organization-settings/secrets-management.md) or create a new one.

By default, the **Skip TLS validations** toggle is activated. Deactivate it to configure the following:

* **CA chain**<mark style="color:red;">**\***</mark> - CA chain used by the Data sink to verify client certificates. Choose it from the list of your tenant's [Secrets](/settings/organization-settings/secrets-management.md) or create a new one.
* **Subject Alternative Name** - Optionally, enter a Subject Alternative Name (SAN) for your TLS connection.
  {% endstep %}

{% step %}
In the [Secrets](/settings/organization-settings/secrets-management.md) area, **New secret** to create a new one:

* Give the secret a **Name**.
* Turn off the **Expiration date** option.
* Click **Add new value** and paste the corresponding value.
* Click **Save**.

<figure><picture><source srcset="/files/NeeWsSQzoChVxRIY76Nt" media="(prefers-color-scheme: dark)"><img src="/files/1oTccyPmgZJ1laY7IhZH" alt=""></picture><figcaption></figcaption></figure>

{% hint style="info" %}
Learn more about secrets in Onum in [this article](/settings/organization-settings/secrets-management.md).
{% endhint %}

You can now select the created secrets in the configuration.
{% endstep %}
{% endstepper %}

Click **Finish** when complete. Your new Data sink will appear in the **Data sinks** area list.

## Pipeline configuration <a href="#pipeline-configuration" id="pipeline-configuration"></a>

When it comes to using this Data sink in a [Pipeline](/pipelines.md), you must configure the following output parameters. To do it, simply click the Data sink on the canvas and select **Configuration**.

### Output configuration <a href="#output-configuration" id="output-configuration"></a>

<table><thead><tr><th width="169.796875">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Event field</strong><mark style="color:red;"><strong>*</strong></mark></td><td>Select the incoming field containing the message to send on.</td></tr></tbody></table>

Click **Save** to save your configuration.
