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

 Release :

    - australia

ft:locale :

    - en-US

ft:publication_title :

    - Australia IT Operations Management

ft:clusterId :

    - itom

bundleId :

    - itom

workflow :

    - Technology


---

# HAProxy load balancer

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

Release version: Australia  
Updated March 12, 2026  
![](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 load balancers running on Linux servers using a pattern-based approach.
This method is the default starting with version 1.15.0 of the Discovery and Service Mapping Patterns application.
It supports discovery of HAProxy load balancers operating in HTTP mode but does not support TCP load balancing.
Show full answer Show less  
HAProxy is an open-source load balancer capable of TCP or HTTP mode, but ServiceNow discovery focuses on HTTP mode only. The discovery process maps one-to-one relationships between front-end and back-end ports, choosing the lowest front-end port in cases where multiple front-ends connect to the same back-end.

## Prerequisites

* Ensure the Discovery and Service Mapping Patterns application and Visibility content are updated to the latest versions.
* Verify that HAProxy software is installed and running on the Linux server.
* Confirm permission to execute the HAProxy version command (`haproxy -v`) and read access to the HAProxy configuration file (`haproxy.cfg`).
* Create SSH credentials to allow Discovery to access the Linux server for horizontal discovery.
* Schedule and run a horizontal discovery to detect HAProxy load balancers.

## Data Collected and Configuration Items (CIs)

During discovery, the following key configuration items and attributes are populated in the CMDB:

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

## CI Relationships

Discovery establishes meaningful relationships between CIs to represent the HAProxy infrastructure accurately:

* 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 CI.
* Load Balancer Services reference the HAProxy Load Balancer and run on hardware CIs.

## Practical Benefits for ServiceNow Customers

By leveraging the pattern-based HAProxy discovery, customers can automatically detect and map HAProxy load balancers and their components within their IT infrastructure. This improves CMDB accuracy, supports service mapping, and enhances visibility into load balancing services. The detailed data and relationships enable effective management of load balancer configurations and dependencies, supporting IT operations and service assurance.  
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/jKVwuMJHXFzBXWBFbOx3_Q "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) 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/mNB7NqS~kRULRDp~CJup5g "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=australia&pubname=australia-platform-security&ft:locale=en-US).

Schedule a horizontal discovery
:   For more information, see [Schedule a horizontal discovery](https://www.servicenow.com/docs/VO0owNull6HAfXGFWMKxhg#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}