Supervisor daemon is a client/server system that allows its users to monitor and control a number of processes on UNIX-like operating systems., The Supervisor check monitors the uptime, status, and number of processes running under Supervisord.
No default configuration is provided for the Supervisor check; you must
provide the configuration in the
dragent.yaml file for the Sysdig
agent to collect the data provided by Supervisor.
This page describes the setup steps required on Supervisor, how to edit the Sysdig agent configuration to collect additional information, the metrics available for integration, and a sample result in the Sysdig Monitor UI.
The Sysdig agent can collect data from Supervisor via HTTP server or UNIX socket. The agent collects the same data regardless of the configured collection method.
Un-comment the following or add them if they are not present in
[inet_http_server] port=localhost:9001 username=user # optional password=pass # optional ... [supervisorctl] serverurl=unix:///tmp/supervisor.sock ... [unix_http_server] file=/tmp/supervisor.sock chmod=777 # make sure chmod is set so that non-root users can read the socket. ... [program:foo] command=/bin/cat
The programs controlled by Supervisor are given by different
sections in the configuration. Each program you want to manage by
Supervisor must be specified in the Supervisor configuration file, with
its supported options in the
[program] section. See Supervisor’s
file for details.
Sysdig Agent Configuration
Review how to Edit dragent.yaml to Integrate or Modify Application Checks.
By default, Sysdig’s
dragent.default.yaml does not have any
configuration to connect the agent with Supervisor. Edit
following the Examples given to connect with Supervisor and collect
Remember! Never edit
dragent.default.yaml directly; always edit
Example 1: Connect by UNIX Socket
- name: supervisord pattern: comm: supervisord conf: socket: "unix:///tmp/supervisor.sock"
Example 2: Connect by Host Name and Port, Optional Authentication
- name: supervisord pattern: comm: supervisord conf: host: localhost port: 9001 # user: user # Optional. Required only if a username is configured. # pass: pass # Optional. Required only if a password is configured.
The number of supervisord monitored processes
shown as process
The process uptime
shown as second
See also Supervisord Metrics.
CRITICAL if the Sysdig agent cannot connect to the HTTP server
or UNIX socket configured, otherwise OK.