Ping graphs can be created in 5 main ways.
<ping.../>
elements in the config for each graph<ping-url='...'/>
attribute in the cqm
config
to read a bulk list of pingsTo start a ping, send a GET or POST to the /ping
URL with form fields. HTTP Basic auth can be used instead of a normal session tracked login. The field graph
must be specified with the graph name for the pinging. To start a ping also specify ip
and optionally table
. This can be used on an existing graph to change the ping target.
There is also a means to define a bulk ping list for the FB2500. The config allows an HTTP(S) URL to be specified, which is fetched at startup. The web interface (Graphs/Ping) also allows for the URL to be fetched manually if needed.
This URL is then polled at the rate specified by ping-update
. The file served at that URL
is expected to contain plain text with details of a ping target on each line in the format:
GraphName,IP/Hostname[#table][+size][?options]
. Where options
is 's' for slow pings, or 'a' for auto-slow pings (becoming slow if no response for 2 mins).
Ping graphs defined in the config can be stopped simply by removing them from the config. The graphs will still be retained for a time, but no further pings will be sent.
For pings defined in the web form (or via automated HTTP(S) requests), specify the graph
name but omit the ip
field. This will stop the ping.
For bulk pings, remove any unwanted pings from the file. Then, either wait for the next reload or fetch the URL manually via the web interface. Any pings included in a previous version of the file that are no longer present are automatically stopped.