Reference

show info

On this page

Display information about the load balancer process.

Description Jump to heading

The show info command displays information about the load balancer process, such as its software version, number of threads, uptime, and process ID.

You can format the data as:

  • Default format, one field and value per line
  • Typed
  • JSON

Version differences

  • Starting with version 2.4r1, you can append the optional float parameter to output certain fields, normally integers, as floats to improve accuracy.

  • Starting with version 3.1r1, the show info command displays the current and total number of streams with output variables CurrStreams and CumStreams, respectively. They can quickly help detect whether a slowdown is caused on the client side or server side and facilitate the export of activity metrics.

Examples Jump to heading

In the following examples, we call show info to see information about the load balancer process, with each example showing the different output formats.

Default format Jump to heading

The default format for the data shows one field and value per line. Fields and their values are separated by a colon:

nix
echo "show info" | \
  sudo socat stdio tcp4-connect:127.0.0.1:9999
nix
echo "show info" | \
  sudo socat stdio tcp4-connect:127.0.0.1:9999
output
text
Name: HAProxy
Version: 3.1.2-cda631a
Release_date: 2025/01/08
Nbthread: 22
Nbproc: 1
Process_num: 1
Pid: 8
Uptime: 0d 0h08m16s
Uptime_sec: 496
Memmax_MB: 0
PoolAlloc_MB: 1
PoolUsed_MB: 1
PoolFailed: 0
Ulimit-n: 1048575
Maxsock: 1048575
Maxconn: 524241
Hard_maxconn: 524241
CurrConns: 0
CumConns: 499
CumReq: 2
MaxSslConns: 0
CurrSslConns: 0
CumSslConns: 0
Maxpipes: 0
PipesUsed: 0
PipesFree: 0
ConnRate: 0
ConnRateLimit: 0
MaxConnRate: 0
SessRate: 0
SessRateLimit: 0
MaxSessRate: 0
SslRate: 0
SslRateLimit: 0
MaxSslRate: 0
SslFrontendKeyRate: 0
SslFrontendMaxKeyRate: 0
SslFrontendSessionReuse_pct: 0
SslBackendKeyRate: 0
SslBackendMaxKeyRate: 0
SslCacheLookups: 0
SslCacheMisses: 0
CompressBpsIn: 0
CompressBpsOut: 0
CompressBpsRateLim: 0
Tasks: 58
Run_queue: 1
Idle_pct: 100
node: 7de1a8dbdbbf
Stopping: 0
Jobs: 7
Unstoppable Jobs: 1
Listeners: 5
ActivePeers: 0
ConnectedPeers: 0
DroppedLogs: 0
BusyPolling: 0
FailedResolutions: 0
TotalBytesOut: 10260
TotalSplicedBytesOut: 0
BytesOutRate: 0
DebugCommandsIssued: 0
CumRecvLogs: 0
Build info: 3.1.2-cda631a
Memmax_bytes: 0
PoolAlloc_bytes: 1591664
PoolUsed_bytes: 1591664
Start_time_sec: 1737661886
Tainted: 0
TotalWarnings: 0
MaxconnReached: 0
BootTime_ms: 37
Niced_tasks: 0
CurrStreams: 1
CumStreams: 2
BlockedTrafficWarnings: 0
output
text
Name: HAProxy
Version: 3.1.2-cda631a
Release_date: 2025/01/08
Nbthread: 22
Nbproc: 1
Process_num: 1
Pid: 8
Uptime: 0d 0h08m16s
Uptime_sec: 496
Memmax_MB: 0
PoolAlloc_MB: 1
PoolUsed_MB: 1
PoolFailed: 0
Ulimit-n: 1048575
Maxsock: 1048575
Maxconn: 524241
Hard_maxconn: 524241
CurrConns: 0
CumConns: 499
CumReq: 2
MaxSslConns: 0
CurrSslConns: 0
CumSslConns: 0
Maxpipes: 0
PipesUsed: 0
PipesFree: 0
ConnRate: 0
ConnRateLimit: 0
MaxConnRate: 0
SessRate: 0
SessRateLimit: 0
MaxSessRate: 0
SslRate: 0
SslRateLimit: 0
MaxSslRate: 0
SslFrontendKeyRate: 0
SslFrontendMaxKeyRate: 0
SslFrontendSessionReuse_pct: 0
SslBackendKeyRate: 0
SslBackendMaxKeyRate: 0
SslCacheLookups: 0
SslCacheMisses: 0
CompressBpsIn: 0
CompressBpsOut: 0
CompressBpsRateLim: 0
Tasks: 58
Run_queue: 1
Idle_pct: 100
node: 7de1a8dbdbbf
Stopping: 0
Jobs: 7
Unstoppable Jobs: 1
Listeners: 5
ActivePeers: 0
ConnectedPeers: 0
DroppedLogs: 0
BusyPolling: 0
FailedResolutions: 0
TotalBytesOut: 10260
TotalSplicedBytesOut: 0
BytesOutRate: 0
DebugCommandsIssued: 0
CumRecvLogs: 0
Build info: 3.1.2-cda631a
Memmax_bytes: 0
PoolAlloc_bytes: 1591664
PoolUsed_bytes: 1591664
Start_time_sec: 1737661886
Tainted: 0
TotalWarnings: 0
MaxconnReached: 0
BootTime_ms: 37
Niced_tasks: 0
CurrStreams: 1
CumStreams: 2
BlockedTrafficWarnings: 0

Add the desc parameter to the command to append a description of each line:

nix
echo "show info desc" | \
  sudo socat stdio tcp4-connect:127.0.0.1:9999
nix
echo "show info desc" | \
  sudo socat stdio tcp4-connect:127.0.0.1:9999
output
text
Name: hapee-lb:"Product name"
Version: 2.2.0-1.0.0-235.192:"Product version"
Release_date: 2021/02/05:"Date of latest source code update"
Nbthread: 2:"Number of started threads (global.nbthread)"
Nbproc: 1:"Number of started worker processes (global.nbproc)"
Process_num: 1:"Relative worker process number (1..Nbproc)"
Pid: 12170:"This worker process identifier for the system"
...
output
text
Name: hapee-lb:"Product name"
Version: 2.2.0-1.0.0-235.192:"Product version"
Release_date: 2021/02/05:"Date of latest source code update"
Nbthread: 2:"Number of started threads (global.nbthread)"
Nbproc: 1:"Number of started worker processes (global.nbproc)"
Process_num: 1:"Relative worker process number (1..Nbproc)"
Pid: 12170:"This worker process identifier for the system"
...

Typed format Jump to heading

Specify the typed parameter to enable the typed format. Similar to the default format, each field is on its own line, but it uses a different way to categorize fields.

nix
echo "show info typed" | \
  sudo socat stdio tcp4-connect:127.0.0.1:9999
nix
echo "show info typed" | \
  sudo socat stdio tcp4-connect:127.0.0.1:9999
output
text
0.Name.1:POS:str:hapee-lb
1.Version.1:POS:str:2.2.0-1.0.0-235.192
2.Release_date.1:POS:str:2021/02/05
3.Nbthread.1:CGS:u32:2
4.Nbproc.1:CGS:u32:1
5.Process_num.1:KGP:u32:1
6.Pid.1:SGP:u32:12170
...
output
text
0.Name.1:POS:str:hapee-lb
1.Version.1:POS:str:2.2.0-1.0.0-235.192
2.Release_date.1:POS:str:2021/02/05
3.Nbthread.1:CGS:u32:2
4.Nbproc.1:CGS:u32:1
5.Process_num.1:KGP:u32:1
6.Pid.1:SGP:u32:12170
...

Each line begins with a dot-delimited value (e.g. 0.Name.1) that has these fields:

  • the numeric position of the field in the list starting at zero
  • the field name
  • the process number starting at 1

The rest of the values are separated by colons. They break down as follows:

  • three letters that correspond to the field’s origin, nature, and scope of the variable:
Parameter Letter Meaning
Origin M Metric
S Status
K Key
C Config
P Product
Nature G Gauge
L limit
m min
M max
R rate
C counter
D duration
A age
T time
N name
O output
a average
Scope P process
S service
s system
C cluster
  • the field’s type (e.g. str for string and u32 for unsigned 32-bit integer).
  • the value itself.

For example:

Field position Field name Process number Origin, nature, and scope Field type Field Value
3 Nbthread 1 CGS u32 2

Add the desc parameter to the command to append a description of each line:

nix
echo "show info typed desc" | \
  sudo socat stdio tcp4-connect:127.0.0.1:9999
nix
echo "show info typed desc" | \
  sudo socat stdio tcp4-connect:127.0.0.1:9999
output
text
0.Name.1:POS:str:hapee-lb:"Product name"
1.Version.1:POS:str:2.2.0-1.0.0-235.192:"Product version"
2.Release_date.1:POS:str:2021/02/05:"Date of latest source code update"
3.Nbthread.1:CGS:u32:2:"Number of started threads (global.nbthread)"
4.Nbproc.1:CGS:u32:1:"Number of started worker processes (global.nbproc)"
5.Process_num.1:KGP:u32:1:"Relative worker process number (1..Nbproc)"
6.Pid.1:SGP:u32:12170:"This worker process identifier for the system"
...
output
text
0.Name.1:POS:str:hapee-lb:"Product name"
1.Version.1:POS:str:2.2.0-1.0.0-235.192:"Product version"
2.Release_date.1:POS:str:2021/02/05:"Date of latest source code update"
3.Nbthread.1:CGS:u32:2:"Number of started threads (global.nbthread)"
4.Nbproc.1:CGS:u32:1:"Number of started worker processes (global.nbproc)"
5.Process_num.1:KGP:u32:1:"Relative worker process number (1..Nbproc)"
6.Pid.1:SGP:u32:12170:"This worker process identifier for the system"
...

JSON format Jump to heading

Specify the json parameter to enable the JSON format. To make it human-readable, pipe the result to a JSON formatting tool, such as Python’s json.tool.

nix
echo "show info json" | \
  sudo socat stdio tcp4-connect:127.0.0.1:9999 | \
python3 -m json.tool | \
less
nix
echo "show info json" | \
  sudo socat stdio tcp4-connect:127.0.0.1:9999 | \
python3 -m json.tool | \
less
output
json
[
   {
      "field": {
         "pos": 0,
         "name": "Name"
      },
      "processNum": 1,
      "tags": {
         "origin": "Product",
         "nature": "Output",
         "scope": "Service"
      },
      "value": {
         "type": "str",
         "value": "hapee-lb"
      }
   },
   {
      "field": {
         "pos": 1,
         "name": "Version"
      },
      "processNum": 1,
      "tags": {
         "origin": "Product",
         "nature": "Output",
         "scope": "Service"
      },
      "value": {
         "type": "str",
         "value": "2.2.0-1.0.0-235.192"
      }
   },
   ...
output
json
[
   {
      "field": {
         "pos": 0,
         "name": "Name"
      },
      "processNum": 1,
      "tags": {
         "origin": "Product",
         "nature": "Output",
         "scope": "Service"
      },
      "value": {
         "type": "str",
         "value": "hapee-lb"
      }
   },
   {
      "field": {
         "pos": 1,
         "name": "Version"
      },
      "processNum": 1,
      "tags": {
         "origin": "Product",
         "nature": "Output",
         "scope": "Service"
      },
      "value": {
         "type": "str",
         "value": "2.2.0-1.0.0-235.192"
      }
   },
   ...

The format of the JSON document is described in a schema, which you can get by calling show schema json.

See also Jump to heading

Do you have any suggestions on how we can improve the content of this page?

Previous page show events Next page show libs
© 2025 HAProxy Technologies, LLC. All Rights Reserved
Manage Cookie Preferences