Skip to content

zabbix-tools/zabbix-module-sockets

master
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
m4
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

zabbix-module-sockets

zabbix-module-sockets is a loadable Zabbix module and templates that enables Zabbix to query the state of sockets - including tcp, udp, unix, raw, etc.

Screenshot - TCP Sockets screen

Install

The following packages are available for download:

To install from source:

$ ./configure --with-zabbix=/usr/src/zabbix-3.2.5
$ make
$ sudo make install

If you are using a packaged version of Zabbix, you may with to redirect the installation directories as follows:

$ sudo make prefix=/usr sysconfdir=/etc libdir=/usr/lib64 install

The templates will be installed to /usr/share/doc/zabbix-module-sockets-1.1.0 and can be imported into Zabbix from Configuration > Templates > Import.

Keys

sockets.count[protocol,<state>] returns the number of sockets for the given
                                protocol

sockets.sendq[protocol,<state>] returns the sum of all buffers in the send queue
                                for sockets of the given protocol

sockets.recvq[protocol,<state>] returns the sum of all buffers in the receive
                                queue for sockets of the given protocol

sockets.modver                  version of the loaded module

Supported protocols

The following protocols are supported:

  • tcp
  • tcp6
  • udp
  • udp6
  • unix

TCP 4/6 states

You may use the <state> parameter to filter for sockets in the following valid TCP session states:

  • ESTABLISHED
  • SYN_SENT
  • SYN_RECV
  • FIN_WAIT1
  • FIN_WAIT2
  • TIME_WAIT
  • CLOSE
  • CLOSE_WAIT
  • LAST_ACK
  • LISTEN
  • CLOSING

If the state parameter is empty, the total number of sockets in any state is returned.

E.g.

$ zabbix_agentd -t sockets.count[tcp,listen]
sockets.count[tcp,listen]                     [u|2]

$ netstat -tl4
Active Internet connections (only servers)
Proto Recv-Q Send-Q Local Address           Foreign Address         State
tcp        0      0 0.0.0.0:ssh             0.0.0.0:*               LISTEN
tcp        0      0 0.0.0.0:zabbix-agent    0.0.0.0:*               LISTEN

For greater understanding, see the TCP/IP State Transition Diagram by Gordon McKinney, 2002.

Unix socket states

You may use the <state> parameter to filter for Unix sockets in the following valid states:

  • FREE
  • UNCONNECTED
  • CONNECTING
  • CONNECTED
  • DISCONNECTING
  • LISTEN

E.g.

$ zabbix_agentd -t sockets.count[unix,listen]
sockets.count[unix,listen]                    [u|33]

$ netstat -xl
Active UNIX domain sockets (only servers)
Proto RefCnt Flags       Type       State         I-Node   Path
unix  2      [ ACC ]     STREAM     LISTENING     17910    private/tlsmgr
unix  2      [ ACC ]     STREAM     LISTENING     17914    private/rewrite
unix  2      [ ACC ]     STREAM     LISTENING     17917    private/bounce
...

About

A Zabbix loadable module to monitor Linux Sockets

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published