stork-agent - Stork agent that monitors BIND 9 and Kea services¶
Synopsis¶
stork-agent [–host] [–port]
Description¶
The stork-agent
is a small tool that is being run on the systems
that are running BIND 9 and Kea services. Stork server connects to
the Stork Agent and uses it to monitor services remotely.
Arguments¶
Stork does not use explicit configuration file. Instead, its behavior can be controlled with command line switches and/or variables. The Stork Agent takes the following command line switches. Equivalent environment variables are listed in square brackets, where applicable.
--listen-stork-only
- listen for commands from the Stork Server only, but not for Prometheus requests. [$STORK_AGENT_LISTEN_STORK_ONLY]
--listen-prometheus-only
- listen for Prometheus requests only, but not for commands from the Stork Server. [$STORK_AGENT_LISTEN_PROMETHEUS_ONLY]
-v
or--version
- show software version.
Stork Server flags:
--host=
- the IP or hostname to listen on for incoming Stork server connection. [$STORK_AGENT_ADDRESS]
--port=
- the TCP port to listen on for incoming Stork server connection. (default: 8080) [$STORK_AGENT_PORT]
Prometheus Kea Exporter flags:
--prometheus-kea-exporter-host=
- the IP or hostname to listen on for incoming Prometheus connection (default: 0.0.0.0) [$STORK_AGENT_PROMETHEUS_KEA_EXPORTER_ADDRESS]
--prometheus-kea-exporter-port=
- the port to listen on for incoming Prometheus connection (default: 9547) [$STORK_AGENT_PROMETHEUS_KEA_EXPORTER_PORT]
--prometheus-kea-exporter-interval=
- specifies how often the agent collects stats from Kea, in seconds (default: 10) [$STORK_AGENT_PROMETHEUS_KEA_EXPORTER_INTERVAL]
Prometheus BIND 9 Exporter flags:
--prometheus-bind9-exporter-host=
- the IP or hostname to listen on for incoming Prometheus connection (default: 0.0.0.0) [$STORK_AGENT_PROMETHEUS_BIND9_EXPORTER_ADDRESS]
--prometheus-bind9-exporter-port=
- the port to listen on for incoming Prometheus connection (default: 9119) [$STORK_AGENT_PROMETHEUS_BIND9_EXPORTER_PORT]
--prometheus-bind9-exporter-interval=
- specifies how often the agent collects stats from BIND 9, in seconds (default: 10) [$STORK_AGENT_PROMETHEUS_BIND9_EXPORTER_INTERVAL]
-h
or--help
- displays list of available parameters.
Mailing Lists and Support¶
There are public mailing lists available for the Stork project. stork-users (stork-users at lists.isc.org) is intended for Stork users. stork-dev (stork-dev at lists.isc.org) is intended for Stork developers, prospective contributors, and other advanced users. The lists are available at https://lists.isc.org. The community provides best-effort support on both of those lists.
Once stork will become more mature, ISC will be providing professional support for Stork services.
History¶
The stork-agent
was first coded in November 2019 by Michal Nowikowski.
See Also¶
stork-server(8)