J.7. Ping

J.7. Ping
	Appendix J. Constant Quality Monitoring - technical details

Ping graphs can be created in 5 main ways.

Defining <ping.../> elements in the config for each graph
Specifying a <ping-url='...'/> attribute in the cqm config to read a bulk list of pings
Using the web interface's ping form (Graphs/Ping) to specify individual addresses to ping
Using the web interface's ping form to read a bulk list of pings from a specified URL
Making automated HTTP/HTTPS requests to specify individual addresses to ping

Note

Only graphs defined in the configuration will be automatically recreated after a reboot, graphs created by other means, e.g. the ping form, will have to be re-added manually.

J.7.1. Automated ping control

To 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.

J.7.2. Bulk ping configuration via a URL

There is also a means to define a bulk ping list for the FB9000. 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].

J.7.3. Stopping Ping Graphs

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.


J.6. Creating graphs, and graph names		Appendix K. Hashed passwords