# Send data using TCP

{% hint style="info" %}
See the changelog of this Data sink type [here](/data-sinks/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. 

## 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**](/the-workspace/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](/administration/global-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](/administration/global-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](/administration/global-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](/administration/global-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](/administration/global-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](/the-workspace/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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.onum.com/the-workspace/data-sinks/data-sink-integrations/send-data-using-tcp.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.