---
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 enables ServiceNow customers to discover HAProxy Community edition load balancers running on Linux servers using pattern-based discovery.
This method became the default starting with version 1.15.0 of the Discovery and Service Mapping Patterns application.
HAProxy operates in TCP or HTTP modes; however, ServiceNow currently supports discovery only for HTTP load balancing.
Show full answer Show less  
This discovery approach maps one-to-one relationships between front-end and back-end ports, with a limitation that if multiple front-ends connect to the same back-end, only the relationship from the lowest front-end port is mapped.

## Prerequisites

* Ensure Discovery and Service Mapping Patterns and Visibility Content applications are up to date.
* Verify HAProxy is installed and running on the target Linux server.
* Confirm permission to run the HAProxy version command and read access to the `haproxy.cfg` configuration file.
* Create appropriate SSH credentials to enable Discovery to connect to servers.
* Schedule a horizontal discovery to initiate the HAProxy pattern-based discovery process.

## Data Collected and CMDB Updates

During discovery, the following configuration items (CIs) and their attributes are populated into the CMDB:

* **HAProxy Load Balancer \[cmdbcilbhaproxy\]**: Captures the load balancer name, version, and description obtained from the HAProxy version command.
* **Load Balancer Service \[cmdbcilbservice\]**: Records the service name (formatted as \<LB name\>:\<LB port\>), port, IP address, and highest port number used.
* **Load Balancer Pool \[cmdbcilbpool\]**: Includes pool name, associated load balancer, load balancing method (e.g., Round Robin), installation status, and timestamp of the most recent discovery.
* **Load Balancer Pool Member \[cmdbcilbpoolmember\]**: Details member name, service port, IP address, and references to the pool and load balancer.

## CI Relationships Created

Discovery establishes relationships among these CIs to accurately represent the HAProxy configuration in the CMDB:

* Load Balancer Pool is allocated to Load Balancer Service.
* Load Balancer Pool owns Load Balancer Pool Members.
* Load Balancer Pool and Pool Members reference the HAProxy Load Balancer.
* Load Balancer Service references the HAProxy Load Balancer and runs on Hardware.

## Practical Benefits for ServiceNow Customers

Using pattern-based discovery for HAProxy load balancers allows you to automatically and accurately populate and maintain HAProxy-related configuration items and their relationships in your CMDB. This improves visibility into your load balancing infrastructure, supports service mapping, and enhances operational insights. Ensuring prerequisites and correct permissions are in place facilitates a smooth discovery process.  
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 may 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 searches for, when it runs, and which MID Servers are used. Create a discovery schedule for your local environment or a schedule 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}