---
sourceDocument: Zurich IT Operations Management
sourceDocumentLink: https://www.servicenow.com/docs/r/zurich/it-operations-management

 Release :

    - zurich

ft:locale :

    - en-US

ft:publication_title :

    - Zurich IT Operations Management

ft:clusterId :

    - itom

bundleId :

    - itom

workflow :

    - Technology


---

# HAProxy load balancer

# HAProxy load balancer discovery with patterns {#ariaid-title1}

Release version: Zurich  
Updated July 31, 2025  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 minutes to read
Summarize  
![AI sparkle icon](https://servicenow.com/docs/portal-asset/ai-sparkle-icon) Summarized using AI  
This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete.  

## Summary of HAProxy load balancer discovery with patterns

The Discovery and Service Mapping Patterns application in ServiceNow uses the HAProxy pattern to discover HAProxy Community load balancers running on Linux servers.
This open-source load balancer operates in TCP or HTTP mode, but ServiceNow discovery supports only HTTP mode.
Starting with version 1.15.0 of the Patterns application, pattern-based discovery is the default method for identifying HAProxy load balancers.
Show full answer Show less  
The discovery process maps one-to-one relationships between front-end and back-end ports, mapping only the lowest front-end port when multiple front-ends connect to the same back-end.

## Prerequisites

* Ensure the Discovery and Service Mapping Patterns application and Visibility content are up to date.
* Verify HAProxy is installed and running on the target Linux server.
* Confirm permission to execute the HAProxy version command (`haproxy -v`) and read access to the `haproxy.cfg` configuration file.
* Create appropriate SSH credentials for discovery access.
* Schedule a horizontal discovery to run the HAProxy pattern against target servers.

## Data Collected and CMDB Integration

During discovery, key configuration and status data is collected and populated into the ServiceNow CMDB across several tables:

* **HAProxy Load Balancer \[cmdbcilbhaproxy\]:** Contains the load balancer's name, version, and description obtained from the HAProxy version command.
* **Load Balancer Service \[cmdbcilbservice\]:** Captures services by name (including port), listening port, IP address, highest port number used, and references the HAProxy load balancer.
* **Load Balancer Pool \[cmdbcilbpool\]:** Records pool name, associated load balancer, load balancing method (e.g., Round Robin), last discovery timestamp, and install status.
* **Load Balancer Pool Member \[cmdbcilbpoolmember\]:** Details pool member name, service port, IP address, and references to the load balancer pool and HAProxy load balancer.

## CI Relationships Created

The discovery process builds relationships between configuration items (CIs) to accurately represent the HAProxy load balancer topology, including:

* Associations between Load Balancer Pools and Load Balancer Services.
* Ownership links from Load Balancer Pools to Pool Members.
* References linking Pools, Pool Members, and Services back to the HAProxy Load Balancer.
* Connections showing Load Balancer Services running on specific hardware.

## Practical Benefits for ServiceNow Customers

By leveraging pattern-based HAProxy discovery, customers can automate the identification and modeling of HAProxy load balancers within their CMDB. This enhances visibility into load balancing infrastructure, supports accurate service mapping, and improves operational management. Up-to-date discovery data enables better troubleshooting and impact analysis related to HAProxy load balancers.  
The Discovery and Service Mapping Patterns application uses the HA Proxy pattern to find HAProxy Community load balancers running on a Linux server. Discovering some of these resources might require updating to the latest version of the Discovery and Service Mapping Patterns application from the ServiceNow Store.
HAProxy Community edition is an open-source load balancer that can run in either TCP or HTTP mode. Note that although Discovery supports HAProxy for HTTP load balancing, TCP load balancing isn't supported.

Starting with Discovery and Service Mapping Patterns 1.15.0 version, pattern-based discovery is the default method for discovering HAProxy load balancers. For information on probe-based HAProxy discovery, see [HAProxy load balancer discovery using probes](https://www.servicenow.com/docs/gv4MbHdpZXIvIi8eKQPGPg "Discovery of HAProxy Community edition load balancers is performed by SSH.").  
Note:  
HAProxy discovery supports one-to-one relationship mapping between a front-end port and a back-end port. If multiple front-ends are connected to the same back-end, the discovery process will only map the relationship from the lowest front-end port number in a defined range to the back-end port.

## Request apps on the Store {#haproxy-lb-discovery-pattern__id_z4l_ysx_rcc}

Visit the [ServiceNow Store](https://store.servicenow.com/sn_appstore_store.do#!/store/home) website to view all the available apps and for information about submitting requests to the store. For cumulative release notes information for all released apps, see the [ServiceNow Store version history release notes](https://www.servicenow.com/docs/r/store-release-notes/sn-store-release-notes.html).{#haproxy-lb-discovery-pattern__inline-send-to-store}
To learn about HAProxy load balancers and their versions that you can discover, refer to [Detailed information on products discovered by ITOM Visibility](https://www.servicenow.com/docs/S66sWF9s4Hk7SiksIasElg "Discovery and Service Mapping can discover a wide range of operating systems and applications.").

## Prerequisites {#haproxy-lb-discovery-pattern__section_efx_xtx_rcc}

Verify that the applications are up to date
:
    * Discovery and Service Mapping Patterns
    * Visibility Content
    {#haproxy-lb-discovery-pattern__ul_a1l_d5x_rcc}

Verify HAProxy is installed on the Linux server
:   Verify the HAProxy software is installed and running on a Linux server.

Verify permission to run HAProxy command
:   Verify you have permission to run the following command: \<HAproxy Installation Path\>/haproxy -v.

Verify read access to HAProxy configuration file
:   Verify you have read access to the haproxy.cfg file.

Create SSH credentials
:   For more information, see [SSH credentials](https://www.servicenow.com/docs/access?context=r_SSHCredentialsForm&version=zurich&pubname=zurich-platform-security&ft:locale=en-US).

Schedule a horizontal discovery
:   For more information, see [Schedule a horizontal discovery](https://www.servicenow.com/docs/vg_tjjTTOcl2~Xl7Iri~Rw#t_CreateADiscoverySchedule "A discovery schedule determines what horizontal discovery runs, when it runs, and which MID Servers to use. Create a discovery schedule for your local environment or for discovering the resources in your cloud service account.").

## Data collected by Discovery during horizontal discovery {#haproxy-lb-discovery-pattern__section_nj3_cxx_rcc}

Discovery populates the data in the CMDB when running the HA Proxy Pattern.  
{#haproxy-lb-discovery-pattern__table_k4j_wxx_rcc__entry__2}

| Field | Description |
|-|-|
| Name \[name\] | Name of the HAProxy load balancer. |
| Version \[version\] | Version of the HAProxy load balancer. |
| Description \[short_description\] | Description of the HAProxy process, which is obtained by running the command: `haproxy -version`. |
[Table 1. HAProxy Load Balancer \[cmdb_ci_lb_haproxy\]]

{#haproxy-lb-discovery-pattern__table_k4j_wxx_rcc}  
{#haproxy-lb-discovery-pattern__table_rrg_xxx_rcc__entry__2}

| Field | Description |
|-|-|
| Name \[name\] | Name of the load balancer in the following format: <kbd class="ph userinput">&lt;LB name&gt;:&lt;LB port&gt;</kbd>. |
| Port \[port\] | Port on which the load balancer is listening. |
| IP Address \[ip_address\] | IP address of the load balancer service. |
| Last port \[last_port\] | Highest port number used by the load balancer service. |
| Load balancer \[load_balancer\] | References the HAProxy Load Balancer \[cmdb_ci_lb_haproxy\] table. |
[Table 2. Load Balancer Service \[cmdb_ci_lb_service\]]

{#haproxy-lb-discovery-pattern__table_rrg_xxx_rcc}  
{#haproxy-lb-discovery-pattern__table_cwh_xxx_rcc__entry__2}

| Field | Description |
|-|-|
| Name \[name\] | Name of the load balancer pool. |
| Load balancer \[load_balancer\] | References the HAProxy Load Balancer \[cmdb_ci_lb_haproxy\] table. |
| Load balancing method \[load_balancing_method\] | Method used to load balance the pool, for example: Round Robin. |
| Most recent discovery \[last_discovered\] | Timestamp of the most recent discovery. |
| Install Status \[install_status\] | Install status of the load balancer pool, for example: Installed. |
[Table 3. Load Balancer Pool \[cmdb_ci_lb_pool\]]

{#haproxy-lb-discovery-pattern__table_cwh_xxx_rcc}  
{#haproxy-lb-discovery-pattern__table_pt3_xxx_rcc__entry__2}

| Field | Description |
|-|-|
| Name \[name\] | Name of the load balancer pool member. |
| Service port \[service_port\] | Port used by the pool member. |
| IP Address \[ip_address\] | IP address of the pool member host. |
| Pool \[pool\] | References the Load Balancer Pool \[cmdb_ci_lb_pool\] table. |
| Load balancer \[load_balancer\] | References the HAProxy Load Balancer \[cmdb_ci_lb_haproxy\] table. |
[Table 4. Load Balancer Pool Member \[cmdb_ci_lb_pool_member\]]

{#haproxy-lb-discovery-pattern__table_pt3_xxx_rcc}

## CI relationships {#haproxy-lb-discovery-pattern__section_lnz_wyx_rcc}

Discovery creates these relationships to support the HAProxy load balancer discovery.  
{#haproxy-lb-discovery-pattern__table_b1m_zyx_rcc__entry__3}

| CI | Relationship | CI |
|-|-|-|
| Load Balancer Pool \[cmdb_ci_lb_pool\] | Allocated to::Allocated from | Load Balancer Service \[cmdb_ci_lb_service\] |
| Load Balancer Pool \[cmdb_ci_lb_pool\] | Owns::Owned by | Load Balancer Pool Member \[cmdb_ci_lb_pool_member\] |
| Load Balancer Pool \[cmdb_ci_lb_pool\] | References | HAProxy Load Balancer \[cmdb_ci_lb_haproxy\] |
| Load Balancer Pool \[cmdb_ci_lb_pool\] | References | Load Balancer Pool Member \[cmdb_ci_lb_pool_member\] |
| Load Balancer Pool Member \[cmdb_ci_lb_pool_member\] | References | HAProxy Load Balancer \[cmdb_ci_lb_haproxy\] |
| Load Balancer Service \[cmdb_ci_lb_service\] | References | HAProxy Load Balancer \[cmdb_ci_lb_haproxy\] |
| Load Balancer Service \[cmdb_ci_lb_service\] | Runs on::Runs | Hardware \[cmdb_ci_hardware\] |
[ ]

{#haproxy-lb-discovery-pattern__table_b1m_zyx_rcc}

