Documentation
Table of Contents
26 Equips principals
¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®
Aquests par¨¤metres i els possibles valors de propietat per als objectes de camp del giny del tauler de control respectius permeten configurar el giny Equips principals als m¨¨todes dashboard.create i dashboard.update.
Les propietats dels camps del giny no es validen pas durant la creaci¨® o actualitzaci¨® d'un tauler. Aix¨° permet als usuaris modificarels ginys integrats i crear ginys personalitzats, per¨° tamb¨¦ afegeix el risc de creaci¨® o actualitzaci¨® incorrectes dels ginys. Per garantir la creaci¨® o actualitzaci¨® correcta del giny Equips principals, consulteu el comportament dels par¨¤metres que es descriuen a les taules seg¨¹ents.
±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð²õ
Els par¨¤metres seg¨¹ents s¨®n compatibles amb el giny Equips principals.
´¥±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð´¥&±ô³Ù;´¥tipus|nom|valor| |-|--------|--|---------|---------------------------- -----| |Interval d'actualitzaci¨®|<|0|rf_rate|0 - Sense actualitzaci¨®;
10 - 10 segons;
30 - 30 segons;
60 - (per defecte) 1 minut;
120 - 2 minuts;
600 - 10 minuts;
900 - 15 minuts.| |Grups d'equips|<|2|groupids.0|Grup d'equips ID.
Nota: per configurar diversos grups d'equips, creeu un giny de tauler objecte de camp per a cada grup d'equips amb un nombre incrementat al nom de la propietat.
Aquest par¨¤metre no s'admet si es configura el giny en una plantilla. tauler de control.| |<|Grups d'equips (Giny)|1|groupids._reference|En lloc de Grup d'equips ID:ABCDE._hostgroupids - establiu un giny compatible (amb el seu conjunt de par¨¤metres Reference a "ABCDE") com a font de dades per als grups d'equips.
Aquest par¨¤metre no s'admet si es configura el giny en un tauler de plantilla.| |Equips|<|3|hostids.0|Equip ID.
Nota: per configurar diversos equips, creeu un objecte de camp de giny de tauler per a cada equip amb un nombre incrementat al nom de la propietat. Per a diversos equips, el par¨¤metre Grups d'equips no s'ha de configurar en absolut o b¨¦ s'ha de configurar com a m¨ªnim amb un grup d'equips al qual pertanyen els equips configurats.
Aquest par¨¤metre no s'admet si es configura el giny en un tauler de plantilla.| |<|Equips (Giny/Tauler)|1|hostids._reference|En lloc d'Equip ID:DASHBOARD.hostids - establiu el Selector Equip com a font de dades per a equips;ABCDE._hostids - estableix un giny compatible (amb el seu par¨¤metre Reference establert a "ABCDE") com a font de dades per als equips.
Aquest par¨¤metre no s'admet si es configura el giny en una plantilla tauler de control.| |Etiquetes d'equips|<|<|<|<| |<|Tipus d'avaluaci¨®|0|evaltype|0 - (per defecte) I/O;
2 - O.
Aquest par¨¤metre no s'admet si es configura el giny en un tauler de control de plantilla.| |^|Nom de l'etiqueta|1|tags.0.tag|Qualsevol valor de cadena.
Nota: el nombre del nom de la propietat fa refer¨¨ncia a l'ordre de l'etiqueta a la llista d'avaluaci¨® d'etiquetes.
Comportament del par¨¤metre:
- obligatori si es configura etiquetes d'equips
Aquest par¨¤metre no s'admet si configurar el giny en un tauler de plantilla.| |^|Operador|0|tags.0.operator|0 - Cont¨¦;
1 - ?s igual;
2 - No cont¨¦;
3 - No ¨¦s igual;
4 - Existeix ;
5 - No existeix.
Nota: el nombre del nom de la propietat fa refer¨¨ncia a l'ordre de l'etiqueta a la llista d'avaluaci¨® de l'etiqueta.
±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð behavior:
- obligatori si es configura etiquetes d'equips
Aquest par¨¤metre no s'admet si es configura el giny en un tauler de plantilla.| |^|Valor de l'etiqueta|1|tags.0.value|Qualsevol valor de cadena.
Nota: el nombre del nom de la propietat fa refer¨¨ncia a l'ordre de l'etiqueta a la llista d'avaluaci¨® d'etiquetes.
Comportament del par¨¤metre:
- obligatori si es configura etiquetes d'equips
Aquest par¨¤metre no s'admet si configurar el giny en un tauler de plantilla.| |Mostra els equips en manteniment|<|0|manteniment|0 - (per defecte) Desactivat;
1 - Activat.| |Columnes (veieu m¨¦s avall)|<|<|<|<| |Ordena per|<|0|columna|Valor num¨¨ric de la columna de les columnes configurades.| |Ordre|<|0|ordre|2 - (per defecte) N superior;
3 - N. inferior| |L¨ªmit de l'equip|<|0|show_lines|Els valors possibles oscil¡¤len entre 1 i 1000.
Per defecte: 10.
Aquest par¨¤metre no s'admet si es configura el giny en un tauler de plantilla.|
Columnes
Les columnes tenen par¨¤metres comuns i par¨¤metres addicionals en funci¨® de la configuraci¨® del par¨¤metre Data.
Per a tots els par¨¤metres relacionats amb les columnes, el nombre del nom de la propietat (p. ex. columns.0.name) fa refer¨¨ncia a una columna per a la qual ¨¦s configurat el par¨¤metre.
Els par¨¤metres seg¨¹ents s¨®n compatibles amb totes les columnes.
| ±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð | tipus | nom | valor |
|---|---|---|---|
| Nom | 1 | columns.0.nom | Qualsevol valor de cadena. Comportament del par¨¤metre: - obligatori |
| Data | 0 | columns.0.data | 1 - Valor de l'element; 2 - Nom de l'equip; 3 - Text. Comportament del par¨¤metre: - obligatori |
| Color base | 1 | columns.0.base_color | Codi de color hexadecimal (p. ex., FF0000).Comportament del par¨¤metre: - obligatori |
Valor de l'article
Els par¨¤metres seg¨¹ents s¨®n compatibles si Data s'estableix a "Valor de l'element".
El primer nombre del nom de propietat Llindars (p. ex. columnsthresholds.0.color.0) fa refer¨¨ncia a la columna per a la qual es configuren els llindars, mentre que el segon nombre fa refer¨¨ncia al lloc llindar en una llista, ordenada en ordre ascendent. Tanmateix, si els llindars es configuren en un ordre diferent, els valors s'ordenaran en ordre ascendent despr¨¦s d'actualitzar la configuraci¨® del giny a la interf¨ªcie de Áú»¢¶Ä²© (p. ex., "threshold.0.threshold":"5" ¡ú "threshold.0.threshold":"1"; "threshold.1.threshold":"1" ¡ú "threshold.1. llindar": "5").
´¥±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð´¥&±ô³Ù;´¥tipus|nom|valor| |-|--------|--|---------|---------------------------- -----| |Item|<|1 |columns.0.item|Nom d'element v¨¤lid.
Quan es configura el giny en un tauler de plantilla, nom¨¦s els elements s'hauria de configurar a la plantilla.| |Mostra el valor de l'element com a|<|0|columns.0.display_value_as|0 - (per defecte) ±·³Ü³¾¨¨°ù¾±³¦;
1 - Text;
2 - Binari.| |Display|<|0|columns.0.display|1 - (per defecte) Tal com ¨¦s;
2 - Barra;
3 - Indicadors;
6 - Sparkline.
< br>Comportament del par¨¤metre:
- ²¹»å³¾¨¨²õ si Mostra el valor de l'element com a s'estableix en "Num¨¨ric"| |Min|<|1|columns.0.min|Qualsevol valor num¨¨ric.
Comportament del par¨¤metre:
- ²¹»å³¾¨¨²õ si Mostra el valor de l'element com a s'estableix en "Num¨¨ric" i Mostra s'estableix en "Barra" o "Indicadors" | |Max|<|1|columns.0.max|Qualsevol valor num¨¨ric.
Comportament del par¨¤metre:
- ²¹»å³¾¨¨²õ si Mostra el valor de l'element com a s'estableix en "Num¨¨ric" i Mostra s'estableix en "Barra" o "Indicadors" | |Llocs decimals|<|0|columns.0.decimal_places|Els valors possibles oscil¡¤len entre 0 i 10.
Per defecte: 2.
Comportament dels par¨¤metres:
- ²¹»å³¾¨¨²õ si Mostra el valor de l'element com a est¨¤ definit com a "Num¨¨ric"| |Sparkline|<|<|<|<| |<|Width|0|columns.0.sparkline.width|Els valors possibles oscil¡¤len entre 0 i 10.
Per defecte: 1.
Comportament del par¨¤metre:
- ²¹»å³¾¨¨²õ si Mostra el valor de l'element com a est¨¤ establert en "Num¨¨ric" i Mostra est¨¤ establert en "Sparkline"| |^|Fill|0|columns.0.sparkline.fill|Els valors possibles oscil¡¤len entre 0 i 10.
Per defecte: 3.
Comportament del par¨¤metre:
- ²¹»å³¾¨¨²õ si Mostra el valor de l'element com a est¨¤ establert en "Num¨¨ric" i Mostra est¨¤ establert en "Sparkline"| |^|Color|1|columns.0.sparkline.color|Codi de color hexadecimal (p. ex., FF0000).
Per defecte: 42A5F5.
Comportament del par¨¤metre:
- ²¹»å³¾¨¨²õ si Mostra el valor de l'element com a est¨¤ definit en "Num¨¨ric" i Display s'estableixen a "Sparkline"| |^|Per¨ªode de temps|1|columns.0.sparkline.time_period._reference|DASHBOARD._timeperiod - estableix el Time period selector com a font de dades;< br>ABCDE._timeperiod - estableix un compatible widget (amb el seu par¨¤metre reference igual a ABCDE) com a font de dades.
Per defecte: DASHBOARD._timeperiod< br>
Com alternativa, podeu establir el per¨ªode de temps nom¨¦s a De i A ±è²¹°ù¨¤³¾±ð³Ù°ù±ð²õ.
Comportament dels par¨¤metres:
- ²¹»å³¾¨¨²õ si Mostra el valor de l'element com a est¨¤ establert en "Num¨¨ric" i Mostra ¨¦s establert a "Sparkline"| |^|From|1|columns.0.sparkline.time_period.from|Cadena de temps v¨¤lida en absolut (AAAA-MM-DD hh:mm:ss) o relatiu sintaxi de temps ('ara', 'ara/d', 'ara/w-1w', etc.).
Comportament del par¨¤metre:
- ²¹»å³¾¨¨²õ si Mostra el valor de l'element com a est¨¤ establert en "Num¨¨ric" i Mostra est¨¤ establert en "Sparkline"| |^|To|1|columns.0.sparkline.time_period.to|Cadena de temps v¨¤lida en absolut (AAAA-MM-DD hh:mm:ss) o relatiu sintaxi de temps (ara, ara/d, ara/w-1w, etc.).
±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð behavior:
- supported si Mostra el valor de l'element com a est¨¤ establert en "Num¨¨ric" i Display est¨¤ establert en "Sparkline" | |^|Dades de l'historial|0|columns.0.sparkline.history|0 - (per defecte) ´¡³Ü³Ù´Ç³¾¨¤³Ù¾±³¦;
1 - Historial;
2 - Tend¨¨ncies.
Comportament del par¨¤metre:
- ²¹»å³¾¨¨²õ si Mostra el valor de l'element com a s'estableix en "Num¨¨ric" i Mostra est¨¤ establert a "Sparkline"| |Llindars|<|<|<|<| |<|Color|1|columnsthresholds.0.color.0|Codi de color hexadecimal (per exemple, FF0000).
Comportament del par¨¤metre:
- ²¹»å³¾¨¨²õ si Mostra el valor de l'element com a est¨¤ definit en "Num¨¨ric"| |^|Llindar|1|columnsthresholds.0.threshold.0|Qualsevol valor de cadena.
Comportament del par¨¤metre:
- ²¹»å³¾¨¨²õ si Mostra el valor de l'element com a est¨¤ establert en "Num¨¨ric "| |Destacats|<|<|<|<| |<|Color|1|columns.0.highlights.0.color|Codi de color hexadecimal (per exemple, FF0000).
Comportament del par¨¤metre:
- ²¹»å³¾¨¨²õ si Mostra el valor de l'element com a est¨¤ definit en "Text"| |^|±Ê²¹³Ù°ù¨®|1|columns.0.highlights.0.pattern|Qualsevol valor de cadena.
Comportament del par¨¤metre:
- ²¹»å³¾¨¨²õ si Mostra el valor de l'element com a s'estableix en "Text"| |Mostra la miniatura|<|0|columns.0.show_thumbnail|0 - (per defecte) Desactivat;
1 - Activat.
Comportament del par¨¤metre:
- ²¹»å³¾¨¨²õ si Mostra el valor de l'element com a est¨¤ establert en "Binari"| |Funci¨® d'agregaci¨®|<|0|columns.0.aggregate_function|0 - (per defecte) no utilitzat;
1 - m¨ªn;
2 - m¨¤xim;
3 - mitjana;
4 - comptar;
5 - suma;
6 - primer;
7 - darrer.| |Per¨ªode de temps|<|1|columns.0.time_period._reference|DASHBOARD._timeperiod - estableix el Time period selector com a font de dades;
ABCDE._timeperiod - estableix un compatible widget (amb el seu par¨¤metre reference igual a ABCDE) com a font de dades.
Per defecte: DASHBOARD._timeperiod< br>
Com alternativa, podeu establir el per¨ªode de temps nom¨¦s a De i A ±è²¹°ù¨¤³¾±ð³Ù°ù±ð²õ.
Comportament del par¨¤metre:
- ²¹»å³¾¨¨²õ si la funci¨® d'agregaci¨® s'estableix en "m¨ªnim", "m¨¤x", "mitjana". ", "compte", "suma", "primer", "¨²ltim"| |<|From|1|columns.0.time_period.from|Cadena de temps v¨¤lida en la sintaxi temporal absoluta (AAAA-MM-DD hh:mm:ss) o relativa (ara, ara/d, ara/w-1w, etc.).
±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð behavior:
- ²¹»å³¾¨¨²õ si no s'estableix Per¨ªode de temps i la Funci¨® d'agregaci¨® s'estableix en "m¨ªnim", "m¨¤x", "mitjana", "compte", "suma", "primer", "¨²ltim"| |^|To|1|columns.0.time_period.to|Cadena de temps v¨¤lida en sintaxi de temps absoluta (AAAA-MM-DD hh:mm:ss) o relativa (ara, ara/d, ara/w-1w, etc.).
±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð behavior:
- ²¹»å³¾¨¨²õ si no s'estableix Per¨ªode de temps i la Funci¨® d'agregaci¨® s'estableix en "m¨ªnim", "m¨¤x", "mitjana", "compte", "suma", "primer", "¨²ltim"| |Dades de l'historial|<|0|columns.0.history|0 - (per defecte) ´¡³Ü³Ù´Ç³¾¨¤³Ù¾±³¦;
1 - Historial;
2 - Tend¨¨ncies.
Comportament dels par¨¤metres:
- supported si Mostra el valor de l'element com a est¨¤ establert en "Num¨¨ric"| |¸é±ð´Ú±ð°ù¨¨²Ô³¦¾±²¹|<|1|refer¨¨ncia|Qualsevol valor de cadena que consta de 5 car¨¤cters (p. ex., ABCDE o JBPNL). Aquest valor ha de ser ¨²nic dins del tauler de control al qual pertany el giny.
Comportament del par¨¤metre:
- obligatori|
Text
Els par¨¤metres seg¨¹ents s'admeten si Data s'ha establert a "Text".
| ±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð | tipus | nom | valor |
|---|---|---|---|
| Text | 1 | columns.0.text | Qualsevol valor de cadena, incloses les macros. Macros admeses: {HOST.*}, {INVENTORY.*}. Comportament del par¨¤metre: - obligatori si Data ¨¦s establert a "Text" |
Exemples
Els exemples seg¨¹ents nom¨¦s tenen com a objectiu descriure la configuraci¨® dels objectes de camp del giny del tauler de control per al giny Equips top. Per obtindre m¨¦s informaci¨® sobre la configuraci¨® d'un tauler, veieu dashboard.create.
Configurar el giny d'Equips principals
Configurar un giny d'Equips principals que ensenya els principals equips per ¨²s de CPU del grup d'equips "4". A m¨¦s, configura les seg¨¹ents columnes a mida: "Nom d'equip", "?s de CPU, en %", "1m avg", "5m avg", "15m avg", "Processos".
{
"jsonrpc": "2.0",
"method": "dashboard.create",
"params": {
"name": "My dashboard",
"display_period": 30,
"auto_start": 1,
"pages": [
{
"widgets": [
{
"type": "tophosts",
"name": "Top hosts",
"x": 0,
"y": 0,
"width": 12,
"height": 5,
"view_mode": 0,
"fields": [
{
"type": 2,
"name": "groupids.0",
"value": 4
},
{
"type": 1,
"name": "columns.0.name",
"value": "Host"
},
{
"type": 0,
"name": "columns.0.data",
"value": 2
},
{
"type": 1,
"name": "columns.0.base_color",
"value": "FFFFFF"
},
{
"type": 1,
"name": "columns.1.name",
"value": "CPU utilization in %"
},
{
"type": 0,
"name": "columns.1.data",
"value": 1
},
{
"type": 1,
"name": "columns.1.base_color",
"value": "4CAF50"
},
{
"type": 1,
"name": "columns.1.item",
"value": "CPU utilization"
},
{
"type": 0,
"name": "columns.1.display",
"value": 3
},
{
"type": 1,
"name": "columns.1.min",
"value": "0"
},
{
"type": 1,
"name": "columns.1.max",
"value": "100"
},
{
"type": 1,
"name": "columnsthresholds.1.color.0",
"value": "FFFF00"
},
{
"type": 1,
"name": "columnsthresholds.1.threshold.0",
"value": "50"
},
{
"type": 1,
"name": "columnsthresholds.1.color.1",
"value": "FF8000"
},
{
"type": 1,
"name": "columnsthresholds.1.threshold.1",
"value": "80"
},
{
"type": 1,
"name": "columnsthresholds.1.color.2",
"value": "FF4000"
},
{
"type": 1,
"name": "columnsthresholds.1.threshold.2",
"value": "90"
},
{
"type": 1,
"name": "columns.2.name",
"value": "1m avg"
},
{
"type": 0,
"name": "columns.2.data",
"value": 1
},
{
"type": 1,
"name": "columns.2.base_color",
"value": "FFFFFF"
},
{
"type": 1,
"name": "columns.2.item",
"value": "Load average (1m avg)"
},
{
"type": 1,
"name": "columns.3.name",
"value": "5m avg"
},
{
"type": 0,
"name": "columns.3.data",
"value": 1
},
{
"type": 1,
"name": "columns.3.base_color",
"value": "FFFFFF"
},
{
"type": 1,
"name": "columns.3.item",
"value": "Load average (5m avg)"
},
{
"type": 1,
"name": "columns.4.name",
"value": "15m avg"
},
{
"type": 0,
"name": "columns.4.data",
"value": 1
},
{
"type": 1,
"name": "columns.4.base_color",
"value": "FFFFFF"
},
{
"type": 1,
"name": "columns.4.item",
"value": "Load average (15m avg)"
},
{
"type": 1,
"name": "columns.5.name",
"value": "Processes"
},
{
"type": 0,
"name": "columns.5.data",
"value": 1
},
{
"type": 1,
"name": "columns.5.base_color",
"value": "FFFFFF"
},
{
"type": 1,
"name": "columns.5.item",
"value": "Number of processes"
},
{
"type": 0,
"name": "columns.5.decimal_places",
"value": 0
},
{
"type": 0,
"name": "column",
"value": 1
}
]
}
]
}
],
"userGroups": [
{
"usrgrpid": 7,
"permission": 2
}
],
"users": [
{
"userid": 1,
"permission": 3
}
]
},
"id": 1
}Resposta: