# TCP/IP Probe-based Monitoring

TCP/IP probe-based monitoring has become essential for maintaining reliable, high-performing application environments in today's complex IT landscapes. This monitoring approach works by actively sending test packets (probes) to network endpoints and services to verify connectivity, measure response times, and detect failures in real-time.

The importance of this monitoring strategy stems from several critical factors. Modern applications are increasingly distributed across hybrid cloud environments, microservices architectures, and global networks, making passive observation insufficient. TCP/IP probes provide proactive verification that services are not just running, but actually reachable and responsive from the user's perspective.

IT-Conductor TCP/IP Probes are organized into “Servers” that are defined to run on selected Gateways. When configured, the probes associated with the Server are executed by attempting to establish a TCP/IP connection from the Gateway host to the probe target host/port. The availability and connection time metrics are collected and monitored.

### How to Configure TCP/IP Probes in IT-Conductor <a href="#how-to-configure-tcp-ip-probes-in-it-conductor" id="how-to-configure-tcp-ip-probes-in-it-conductor"></a>

To configure TCP/IP probe monitoring in IT-Conductor, follow the instructions below.

#### Add New TCP/IP Probe  <a href="#add-new-tcp-ip-probe" id="add-new-tcp-ip-probe"></a>

1. Visit [service.itconductor.com](https://service.itconductor.com/) and enter your login credentials.
2. Navigate to **Dashboards → Administrator** to access the **Administrator's Dashboard**.
3. Locate the TCP Probe Servers actions panel and click the title to access the complete list.

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2F7wceFYo6ASBDpyhEi14j%2Ftcpip-001.png?alt=media&#x26;token=363bbcae-c657-45db-af60-def75b4887e0" alt=""><figcaption><p>Figure 1: TCP Probe Servers Panel in the Administrator's Dashboard</p></figcaption></figure>

4. Click <img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2Fgit-blob-7f816831472c5030e6dfbcb513035d87da645a67%2Fadd.png?alt=media" alt="" data-size="line"> to create a new Server Probe

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2FvGd0OOZaQ0bCm5J5CLpA%2Ftcpip-002.png?alt=media&#x26;token=10b31ddb-90f6-425d-ba65-4445fee13296" alt=""><figcaption><p>Figure 2: Add a new TCP Probe Servers </p></figcaption></figure>

5. Fill out all the necessary information in the **Create TCP/IP Probe Server** wizard.

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2FmzdBwexbvzUkG4u2Wfoy%2Ftcpip-003.png?alt=media&#x26;token=c262fb52-a22c-4adb-ad11-b910802e5859" alt=""><figcaption><p>Figure 3: Create TCP/IP Probe Server wizard</p></figcaption></figure>

* **Description** - refers to any relevant information about the server probe being added.
* **Organization (Optional)** - refers to an administrative structure that defines objects with a common goal or purpose. If you previously created an organization, please select it.
* **Owner** - refers to the owner of the server probe that’s being created. It automatically takes the username of the person in charge of the configuration.
* **Role -** refers to the environment where the server probe will be used.
* **Site (Optional)** - refers to a logical object that describes a particular area or location, depending on the context in which it is used.
* **Gateway** - allows communication between the customer's site network and the IT-Conductor cloud platform. See [Gateway Setup](https://docs.itconductor.com/user-guide/setup/gateway-setup) for more details.
* **Shared account** - if checked, it uses a centrally stored credential set so multiple probes or monitors can reuse the same connection account instead of defining one locally.
* **Network interface -** refers to the local adapter/IP on the monitoring host, which is used to initiate the probe’s network connection.
* **Connect timeout** - The maximum time the probe waits for a TCP connection to be established before marking the check as failed. By default, it is set to 2000 ms.

6. Once completed, click <img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2Fgit-blob-7f816831472c5030e6dfbcb513035d87da645a67%2Fadd.png?alt=media" alt="" data-size="line"> to save. After a few minutes, the new server probe will show up on the list.

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2Fj7rNDIP5uvju84d7FeC9%2Ftcpip-004.png?alt=media&#x26;token=86009459-d491-44e5-8ae3-6d1bdfe58200" alt=""><figcaption><p>Figure 4: New TCP/IP Probe Servers</p></figcaption></figure>

7. To administer the new probe, click on the grid icon <img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2FA8B5mnBPn826fjDBheIX%2Fgrid%20icon.gif?alt=media&#x26;token=7f6f9b00-8cb1-4efb-b5c2-aea856ba3065" alt="" data-size="line">. This will redirect you to the grid location of the probe server.
8. Click **Probes.**

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2Fp8YtiIxsiNNDH4wF6fQ3%2Ftcpip-005.png?alt=media&#x26;token=14282c80-a44e-4547-a84a-fd5a717ffb17" alt=""><figcaption><p>Figure 5: Probe Server View in the Service Grid</p></figcaption></figure>

9. Click <img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2Fgit-blob-7f816831472c5030e6dfbcb513035d87da645a67%2Fadd.png?alt=media" alt="" data-size="line"> to create a new probe.

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2FQiHhMi1K5JCLmLVMbrgq%2Ftcpip-006.png?alt=media&#x26;token=0c46fbb2-0a1d-4e3b-9a25-1c5d636cd917" alt=""><figcaption><p>Figure 6: Create a new TCP/IP Port Probe</p></figcaption></figure>

10. Fill out all the necessary information in the **Create TCP/IP Port Probe** wizard.

* **Name** - refers to an identifier for the probe being added.
* **Description** - refers to any relevant information about the probe being added.
* **Owner** - refers to the owner of the server probe that’s being created. It automatically takes the username of the person in charge of the configuration.
* **Schedule (optional)** - refers to the assign scheduled. For probe schedules, please use the options below.
* **Time Windows Begin** - defines the start of the allowed time range for probe execution (Optional if you’re already assigning a schedule to the probe). Click on the clock icon to select a start time.
* **Time Windows End** - defines the end of the allowed time range for probe execution (Optional if you’re already assigning a schedule to the probe). Click on the clock icon to select an end time.
* **Repeat interval** - refers to the interval between consecutive executions when repeat is enabled. By default, this is set to 5 minutes.
* **Host** - refers to the host of the probe being added.
* **Port** - refers to the port number used to access the probe being added.
* **Timeout** - refers to the maximum time allowed to establish a connection before timing out. By default, this is set to 5000 msecs.
* **Actual host** - refers to the resolved hostname the probe ultimately connected to.
* **Actual IPv4** - refers to the final IPv4 address used for the connection after DNS resolution.

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2Fn85nqbwISpdnZiWMKBXI%2Ftcpip-007.png?alt=media&#x26;token=1dec2944-35d3-4765-b479-e63b93522c6a" alt=""><figcaption><p>Figure 7: Create TCP/IP Port Probe Wizard</p></figcaption></figure>

11. Click <img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2Fgit-blob-7f816831472c5030e6dfbcb513035d87da645a67%2Fadd.png?alt=media" alt="" data-size="line"> to save.

The probe will be automatically added to the probe server grid.

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2FKVdd0xqfwTl8mNngAmt3%2Ftcpip-008.png?alt=media&#x26;token=28f32d4d-2b54-486f-86ca-6ba5bdde4df8" alt=""><figcaption><p>Figure 8: TCP/IP Port Probe in the Service Grid</p></figcaption></figure>

### Monitor Server Probes in IT-Conductor <a href="#monitor-server-probes-in-it-conductor" id="monitor-server-probes-in-it-conductor"></a>

The availability monitor is created automatically when the probe is added. Expand the chart to view the metric in more detail and define or adjust the override for more specific probe monitoring.

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2FzJ4Tb5Mq293ifXFeB4L2%2Ftcpip-009.png?alt=media&#x26;token=27825259-0adf-4684-a786-66370b6268de" alt=""><figcaption><p>Figure 9: Availability Metric of a TCP/IP Probe </p></figcaption></figure>

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2FMRL5SxrGHRjKBrWGsNSz%2Ftcpip-010.png?alt=media&#x26;token=ffb6e3fc-188d-4ffd-a26e-922a23926739" alt=""><figcaption><p>Figure 10: Threshold Overrides and Alerts </p></figcaption></figure>

When the availability threshold is breached, alerts are generated automatically. To learn more about configuring overrides and alerts in IT-Conductor, check our [Threshold Overrides](https://docs.itconductor.com/user-guide/notifications/threshold-overrides) and [Alerts ](https://docs.itconductor.com/user-guide/notifications/alerts#configure-alerts-in-it-conductor)wiki. To notify specific people or teams, add [subscriptions ](https://docs.itconductor.com/user-guide/notifications/subscriptions)at the appropriate level.
