15 Datenpunkt-Karte
Beschreibung
Diese Parameter und die möglichen Eigenschaftswerte für die jeweiligen Dashboard-Widget-Feldobjekte ermöglichen die Konfiguration des Widgets Datenpunktkarte in den Methoden dashboard.create und dashboard.update.
Die Eigenschaften von Widget-fields werden bei der Erstellung oder Aktualisierung eines Dashboards nicht validiert.
Dies ermöglicht Benutzern, integrierte Widgets zu ändern und benutzerdefinierte Widgets zu erstellen, birgt jedoch auch das Risiko, Widgets fehlerhaft zu erstellen oder zu aktualisieren.
Um die erfolgreiche Erstellung oder Aktualisierung des Widgets Datenpunktkarte sicherzustellen, beachten Sie bitte das in den folgenden Tabellen beschriebene Verhalten der Parameter.
Parameter
Die folgenden Parameter werden für das Widget Datenpunkt-Karte unterstützt.
| Parameter | type | name | value | |
|---|---|---|---|---|
| Aktualisierungsintervall | 0 | rf_rate | 0 - Keine Aktualisierung; 10 - 10 Sekunden; 30 - 30 Sekunden; 60 - (Standard) 1 Minute; 120 - 2 Minuten; 600 - 10 Minuten; 900 - 15 Minuten. |
|
| Datenpunkt | 4 | itemid.0 | Datenpunkt-ID. Parameterverhalten: - erforderlich, wenn Datenpunkt (Widget) nicht gesetzt ist |
|
| Datenpunkt (Widget) | 1 | itemid._reference | Anstelle der Datenpunkt-ID:ABCDE._itemid - legt ein kompatibles Widget (mit dem auf "ABCDE" gesetzten Parameter Referenz) als Datenquelle für den Datenpunkt fest.Parameterverhalten: - erforderlich, wenn Datenpunkt nicht gesetzt ist |
|
| Anzeigen | 0 | sections.0 | 0 - Beschreibung; 1 - Fehlertext; 2 - Metriken; 3 - Letzte Daten; 4 - Informationstyp; 5 - Auslöser; 6 - Host-Schnittstelle; 7 - Typ; 8 - Host-Inventar; 9 - Tags. Hinweis: Die Zahl im Eigenschaftsnamen verweist auf die Reihenfolge des Abschnitts in der Abschnittsliste. Um mehrere Abschnitte zu konfigurieren, erstellen Sie für jeden Abschnitt ein Dashboard-Widget-Feldobjekt mit einer inkrementierten Zahl im Eigenschaftsnamen. |
|
| Host überschreiben | 1 | override_hostid._reference | ABCDE._hostid - legt ein kompatibles Widget (mit dem auf "ABCDE" gesetzten Parameter Referenz) als Datenquelle für Hosts fest;DASHBOARD._hostid - legt die Host-Auswahl des Dashboards als Datenquelle für Hosts fest.Standard: "" (leer)Dieser Parameter wird nicht unterstützt, wenn das Widget in einem Vorlagen-Dashboard konfiguriert wird. |
|
Sparkline
Die folgenden Parameter werden unterstützt, wenn Anzeigen auf „Letzte Daten“ gesetzt ist.
| Parameter | type | name | value | |
|---|---|---|---|---|
| Breite | 0 | sparkline.width | Mögliche Werte liegen zwischen 0 und 10. Standard: 1. |
|
| Füllung | 0 | sparkline.fill | Mögliche Werte liegen zwischen 0 und 10. Standard: 3. |
|
| Farbe | 1 | sparkline.color | Hexadezimaler Farbcode (z. B. FF0000).Standard: 42A5F5. |
|
| Zeitraum | 1 | sparkline.time_period._reference | DASHBOARD._timeperiod – den Zeitraumauswahlschalter des Dashboards als Datenquelle festlegen;ABCDE._timeperiod – ein kompatibles Widget (mit dem Parameter reference, der auf ABCDE gesetzt ist) als Datenquelle festlegen.Standard: "" (leer)Alternativ können Sie den Zeitraum nur in den Parametern Von und Bis festlegen. |
|
| Von | 1 | sparkline.time_period.from | Gültige Zeitangabe im absoluten (YYYY-MM-DD hh:mm:ss) oder relativen Zeitformat (now, now/d, now/w-1w usw.).Standard: now-1h. Parameterverhalten: - unterstützt, wenn Zeitraum nicht festgelegt ist - erforderlich, wenn sparkline.time_period.to festgelegt ist |
|
| Bis | 1 | sparkline.time_period.from | Gültige Zeitangabe im absoluten (YYYY-MM-DD hh:mm:ss) oder relativen Zeitformat (now, now/d, now/w-1w usw.).Standard: now. Parameterverhalten: - unterstützt, wenn Zeitraum nicht festgelegt ist - erforderlich, wenn time_period.to festgelegt ist |
|
| Verlaufsdaten | 0 | sparkline.history | 0 - (Standard) Automatisch; 1 - Verlauf; 2 - Trends. |
|
Beispiele
Die folgenden Beispiele sollen ausschließlich die Konfiguration der Dashboard-Widget-Feldobjekte für das Widget Datenpunktkarte beschreiben.
Weitere Informationen zur Konfiguration eines Dashboards finden Sie unter dashboard.create.
Konfiguration eines Datenpunkt-Karten-Widgets
Konfigurieren Sie ein Datenpunkt-Karten-Widget, das diese Abschnitte anzeigt: „Beschreibung“, „Neueste Daten“, „Auslöser“ und „Tags“.
{
"jsonrpc": "2.0",
"method": "dashboard.create",
"params": {
"name": "My dashboard",
"display_period": 30,
"auto_start": 1,
"pages": [
{
"widgets": [
{
"type": "itemcard",
"name": "Item card",
"x": 0,
"y": 0,
"width": 14,
"height": 7,
"view_mode": 0,
"fields": [
{
"type": 4,
"name": "itemid.0",
"value": 42257
},
{
"type": 0,
"name": "sections.0",
"value": 0
},
{
"type": 0,
"name": "sections.1",
"value": 3
},
{
"type": 0,
"name": "sections.2",
"value": 5
},
{
"type": 0,
"name": "sections.3",
"value": 9
}
]
}
]
}
],
"userGroups": [
{
"usrgrpid": 7,
"permission": 2
}
],
"users": [
{
"userid": 1,
"permission": 3
}
]
},
"id": 1
}Antwort:
{
"jsonrpc": "2.0",
"result": {
"dashboardids": [
"3"
]
},
"id": 1
}