HAProxy load balancer discovery using probes
concept australia Updated Nov 1, 2026 2 min read c_LoadBalancerHAProxy.md
Discovery of HAProxy Community edition load balancers is performed by SSH.
Note: 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 about enabling probe-based discovery, see Enable HAProxy load balancer discovery with probes.
- For information about the HA Proxy pattern, see HAProxy load balancer discovery with patterns.
- For information about Probe to Pattern migration see the knowledge article KB0694477.
HAProxy is an open-source load balancer that can manage any TCP service. It is particularly suited for HTTP load balancing because it supports session persistence and Layer 7 processing. Discovery supports HAProxy for HTTP load balancing. TCP load-balancing is not supported.
Consider the following requirements for discovering the HAProxy:
- The HAProxy software is installed and running on a Linux server.
- The MID Server is deployed to explore the server and the MID Server has access to the server HAProxy configuration file.
- The configuration probe checks for the
haproxy.cfgfile using one of the following methods:- Using the f parameter for the HAProxy process output.
- Using the default
/etc/haproxy/haproxy.cfgpath.
- The HAProxy probes require credentials and execute privileges to run commands.
Discovery uses the Unix - Active Processes probe to identify an HAProxy load balancer when the name of the process is haproxy. If this criterion matches, a record is created in the HAProxy Load Balancers [cmdb_ci_lb_haproxy] table if one does not already exist for that running process.
The following probes are triggered after classification:
| Probe | Description | Commands |
|---|---|---|
| HAProxy – Version | The sensor of this probe populates the HAProxy version in the HAProxy Load Balancers [cmdb_ci_lb_haproxy] table. | haproxy |
| HAProxy – Get Configuration | The probe sensor populates additional information in the HAProxy Load Balancers [cmdb_ci_lb_haproxy] table. It also populates the following tables: Load Balancer Service [cmdb_ci_lb_service], Load Balancer Pool [cmdb_ci_lb_pool], Load Balancer Pool Member [cmdb_ci_lb_pool_member], Load Balancer Interface [cmdb_ci_lb_interface], and Load Balancer Application [cmdb_ci_lb_appl]. | echo, sed, cut, grep, egrep (within the Borne shell script) |
In addition to populating the data, the following relationships records are created in CI Relationships [cmdb_rel_ci] table:
- The records in the cmdb_ci_lb_appl table run on the cmdb_ci_web_server table records.
- The records in the cmdb_ci_lb_service table use the cmdb_ci_lb_pool table records.
- The records in the cmdb_ci_pool table are used by the cmdb_ci_service table records.
- The records in the cmdb_ci_pool table are members of the cmdb_ci_pool_member table records.
- The records in the cmdb_ci_pool_member table are members of the cmdb_ci_pool table records.
53 lines · 4.0 KB
---
title: HAProxy load balancer discovery using probes
description: Discovery of HAProxy Community edition load balancers is performed by SSH.
locale: en-US
canonical_url: https://www.servicenow.com/docs/r/australia/it-operations-management/itom-visibility/c\_LoadBalancerHAProxy.html
release: australia
product: ITOM Visibility
classification: itom-visibility
topic_type: concept
last_updated: "2026-11-01"
reading_time_minutes: 2
breadcrumb: [Load balancers, Network device discovery, Data collected by ITOM Visibility, ITOM Visibility reference, ITOM Visibility, IT Operations Management]
---
# HAProxy load balancer discovery using probes
Discovery of HAProxy Community edition load balancers is performed by SSH.
**Note:** 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 about enabling probe-based discovery, see [Enable HAProxy load balancer discovery with probes](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-operations-management/itom-visibility/enable-haproxy-lb-discovery-probe.md).
- For information about the HA Proxy pattern, see [HAProxy load balancer discovery with patterns](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-operations-management/discovery-and-service-mapping-patterns/haproxy-lb-discovery-pattern.md).
- For information about Probe to Pattern migration see the knowledge article [KB0694477](https://support.servicenow.com/kb_view.do?sysparm_article=KB0694477).
HAProxy is an open-source load balancer that can manage any TCP service. It is particularly suited for HTTP load balancing because it supports session persistence and Layer 7 processing. Discovery supports HAProxy for HTTP load balancing. TCP load-balancing is not supported.
Consider the following requirements for discovering the HAProxy:
- The HAProxy software is installed and running on a Linux server.
- The MID Server is deployed to explore the server and the MID Server has access to the server HAProxy configuration file.
- The configuration probe checks for the `haproxy.cfg` file using one of the following methods:
- Using the **f** parameter for the HAProxy process output.
- Using the default `/etc/haproxy/haproxy.cfg` path.
- The HAProxy probes require credentials and execute privileges to run commands.
Discovery uses the **Unix - Active Processes** probe to identify an HAProxy load balancer when the name of the process is haproxy. If this criterion matches, a record is created in the HAProxy Load Balancers \[cmdb\_ci\_lb\_haproxy\] table if one does not already exist for that running process.
The following probes are triggered after classification:
|Probe|Description|Commands|
|-----|-----------|--------|
|HAProxy – Version|The sensor of this probe populates the HAProxy version in the HAProxy Load Balancers \[cmdb\_ci\_lb\_haproxy\] table.|haproxy|
|HAProxy – Get Configuration|The probe sensor populates additional information in the HAProxy Load Balancers \[cmdb\_ci\_lb\_haproxy\] table. It also populates the following tables: Load Balancer Service \[cmdb\_ci\_lb\_service\], Load Balancer Pool \[cmdb\_ci\_lb\_pool\], Load Balancer Pool Member \[cmdb\_ci\_lb\_pool\_member\], Load Balancer Interface \[cmdb\_ci\_lb\_interface\], and Load Balancer Application \[cmdb\_ci\_lb\_appl\].|echo, sed, cut, grep, egrep \(within the Borne shell script\)|
In addition to populating the data, the following relationships records are created in CI Relationships \[cmdb\_rel\_ci\] table:
- The records in the cmdb\_ci\_lb\_appl table run on the cmdb\_ci\_web\_server table records.
- The records in the cmdb\_ci\_lb\_service table use the cmdb\_ci\_lb\_pool table records.
- The records in the cmdb\_ci\_pool table are used by the cmdb\_ci\_service table records.
- The records in the cmdb\_ci\_pool table are members of the cmdb\_ci\_pool\_member table records.
- The records in the cmdb\_ci\_pool\_member table are members of the cmdb\_ci\_pool table records.
| title | HAProxy load balancer discovery using probes |
| description | Discovery of HAProxy Community edition load balancers is performed by SSH. |
| locale | en-US |
| canonical_url | https://www.servicenow.com/docs/r/australia/it-operations-management/itom-visibility/c\_LoadBalancerHAProxy.html |
| release | australia |
| product | ITOM Visibility |
| classification | itom-visibility |
| topic_type | concept |
| last_updated | 2026-11-01 |
| reading_time_minutes | 2 |
| breadcrumb | Load balancersNetwork device discoveryData collected by ITOM VisibilityITOM Visibility referenceITOM VisibilityIT Operations Management |