| I.3. Graph display options | ||
|---|---|---|
 | Appendix I. Constant Quality Monitoring - technical details |  |
| I.3. Graph display options | ||
|---|---|---|
| | Appendix I. Constant Quality Monitoring - technical details | |
The graphs can have a number of options which define the colours, text and layout. These are defined as http form get attributes on the URL, e.g. http://host:port/cqm/circuit.png?H=a+heading.
Note that they can also be included in the path before the graph name, e.g. http://host:port/cqm/H=a+heading/circuit.png in which case they can be separated by / rather than &.
The attributes are processed in order.
The data point controls can be included as either fieldname or fieldname=colour. To make a valid URL either escape the # prefix or omit it. If any of these are included, then only those that are included are shown. If just fieldname is specified then the default colour is applied. The text on the right shows what fields are included and their colour key.
Table I.2. Colours
| Key | Colour |
| M | Defines colour for minimum latency |
| A | Defines colour for average latency |
| X | Defines colour for max latency |
| U | Defines colour for upload rate |
| D | Defines colour for download rate |
| S | Defines colour for sent echos |
| J | Defines colour for rejected echos |
| F | Defines colour for failed (no response) echos |
| O | Defines colour for off-line |
Additional text is shown on the graph based on the values in the configuration if not specified. There are 4 lines on the top left in small text and two heading lines top right in large text.
Table I.3. Text
| Key | Text |
| z | Clean output, clears all additional text fields |
| Z | Clean and clear, as z but also sets inside background and off-line colours to transparent so graphs are easy to merge with those other LNSs |
| C | Line 1 top left text, default if not set in config is system name |
| c | Line 2 top left text |
| N | Line 3 top left text |
| n | Line 4 top left text |
| H | Main heading text, default if not set in config is graph name |
| h | Sub heading text |
Colours can be in the form of RGB, RRGGBB, RGBA, RRGGBBAA defining red/green/blue/alpha, or some simple colour names.
Table I.4. Text
| Key | Meaning |
| L | Defines a number of pixels to be provided on the left of the graph. Bandwidth and scale axis shown based on space provided left and right. |
| R | Defines a number of pixels to be provided on the right of the graph. Bandwidth and scale axis is shown based on space provided left and right. |
| T | Defines a number of pixels to be provided on the top of the graph. Time axes is show based on space at top and bottom. |
| B | Defines a number of pixels to be provided on the bottom of the graph. Time axes is show based on space at top and bottom. |
| Y | Defines Y bandwidth scale starting point (0 is lowest, 1 is next, etc). |
| y | Defines Y ms scale max level (in ms). |
| I | Defines colour for graticule |
| i | Defines colour for axis lines |
| g | Defines colour for background within axis |
| G | Defines colour for background outside axis |
| W | Defines colour for writing (text) |
| |  | |
| I.2. Access to graphs and csvs |  | I.4. Overnight archiving |