URL
| Name: | URL |
| Identifier (ID): | core.workspace.widget.datasource.url |
| Plugin: | cerberusweb.core |
| File: | api/uri/internal/dashboards/widget_datasources.php |
| Class: | WorkspaceWidgetDatasource_URL |
This is a legacy workspace widget datasource. New widgets should use the data query datasource instead. Datasource-based widgets are being phased out.
Configuration
The URL datasource fetches a given URL on a configurable refresh interval and parses the response to extract one or more label/value pairs for display in a workspace widget.
The expected shape depends on the widget type and the response's content type (or the url_format override).
Single value (Counter, Gauge)
Counter and gauge widgets read a single value (and optional label).
JSON
(application/json, text/json)
{"label":"metric","value":1234}XML
(text/xml)
The root element wraps <value> and <label> children:
<metric><label>Metric</label><value>54321</value></metric>Plain text
(text/plain, default)
A bare numeric value with no label:
9876Series (Chart, Pie Chart, Scatterplot)
Chart widgets read multiple value/label rows.
CSV
(text/csv)
One row per data point, value,label:
123,1
456,2JSON
(application/json, text/json)
An array of {value, label} objects:
[
{"label":"A","value":123},
{"label":"B","value":456}
]XML
(text/xml)
A root element with repeated children, each containing <value> and <label>:
<metrics>
<metric><label>A</label><value>123</value></metric>
<metric><label>B</label><value>456</value></metric>
</metrics>