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 Elements 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 Elements 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 Elements 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'amfitri¨®|<|2|groupids.0|Grup d'amfitri¨® ID.
Nota: per configurar diversos grups d'amfitri¨®, creeu un widget 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'amfitri¨® 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 a un tauler de plantilla.| |Hosts|<|3|hostids.0|Host ID.
Nota: per configurar diversos amfitrions, creeu un objecte de camp de giny de tauler per a cada host amb un n¨²mero incrementat al nom de la propietat. Per a diversos amfitrions, 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 a un tauler de plantilla.| |<|Equips (Giny/Tauler)|1|hostids._reference|En lloc de Host ID:DASHBOARD.hostids
- establiu la Tria d'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 amfitrions.
Aquest par¨¤metre no s'admet si es configura el giny a una plantilla tauler de control.| |Etiquetes d'equips|<|<|<|<| |<|Tipus d'avaluaci¨®|0|host_tags_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|host_tags.0.tag|Qualsevol valor de cadena.
Nota: el n¨²mero 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'amfitri¨®
Aquest par¨¤metre no ¨¦s suportat si es configura el widget en un tauler de plantilla.| |^|Operador|0|host_tags.0.operator|0 - Cont¨¦;
1 - ?s igual;
2 - No cont¨¦;
3 - No ¨¦s igual;
4 - Existeix ;
5 - No existeix.
Nota: el n¨²mero del nom de la propietat fa refer¨¨ncia a l'ordre de l'etiqueta a la llista d'avaluaci¨® de l'etiqueta.
Par¨¤metre behavior:
- obligatori si es configura etiquetes d'equips
Aquest par¨¤metre no s'admet si es configura el giny a un tauler de plantilla.| |^|Valor de l'etiqueta|1|host_tags.0.value|Qualsevol valor de cadena.
Nota: el n¨²mero 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 compatible si es configura el giny en un tauler de plantilla.| |¶Ù¾±²õ±è´Ç²õ¾±³¦¾±¨®|<|0|disposici¨®|0 - (per defecte) Horitzontal;
1 - Vertical.| |Veure els problemes|<|0|mostra els_problemes|0 - Tots;
1 - (per defecte) No esborrat;
2 - Cap.| |Items (vegeu m¨¦s avall)|<|<|<|<|
Els seg¨¹ents par¨¤metres de configuraci¨® avan?ada s¨®n compatibles amb el giny Elements principals.
´¥±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð´¥&±ô³Ù;´¥tipus|nom|valor| |-|--------|--|---------|---------------------------- -----| |Comandes d'equips|<|<|<|<| |Ordenar per|<|0|host_ordering_order_by|0 - (per defecte) Nom de l'amfitri¨®;
3 - Valor de l'element.| |<|Patrons d'elements|1|host_ordering_item.0|Item nom o patr¨® (p. ex., "*: Nombre de *valors per segon").
Nota: per configurar diversos patrons d'element, creeu un objecte de camp de giny de tauler per a cada patr¨® d'element amb un nombre incrementat al nom de la propietat.
Quan configureu el giny al tauler de control de plantilla, nom¨¦s s'han d'establir els patrons dels elements configurats a la plantilla.
Comportament del par¨¤metre:
- obligatori si Ordena per s'estableix a "Valor de l'element"| |Ordre|<|0|host_ordering_order|2 - (per defecte) N superior;
3 - N. inferior| |³¢¨ª³¾¾±³Ù|<|0|host_ordering_limit|Els valors possibles oscil¡¤len entre 1 i 100.
Per defecte: 10.| |Ordena d'articles|<|<|<|<| |Ordenar per|<|0|item_ordering_order_by|1 - Amfitri¨®;
2 - Nom de l'element;
3 - (per defecte) Valor de l'element.| |<|Patrons d'equips|1|item_ordering_host.0|Nom o patr¨® d'Equip.
Nota: per configurar diversos patrons d'equips, creeu un tauler objecte camp de giny per a cada patr¨® d'equip amb un nombre incrementat al nom de la propietat.
Comportament del par¨¤metre:
- obligatori si Ordenar per ¨¦s establert a "Equip"| |Ordre|<|0|item_ordering_order|2 - (per defecte) N superior;
3 - N. inferior| |³¢¨ª³¾¾±³Ù|<|0|item_ordering_limit|Els valors possibles oscil¡¤len entre 1 i 100.
Per defecte: 10.|
El primer nombre del nom de la propietat (p. ex. columns.0.items.0, columns.0.item_tags_evaltype) representa la columna concreta, mentre que el segon nombre, si ¨¦s present, representa l'entitat configurada (p. ex., patr¨® d'element, etiqueta).
´¥±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð´¥&±ô³Ù;´¥tipus|nom|valor| |-|--------|--|---------|---------------------------- -----| |Patrons d'element|<|1|columns.0.items.0|Item nom o patr¨® (p. ex., "*: Nombre de *valors processats per segon").
Nota: per configurar diversos patrons d'elements, creeu un objecte de camp de widget de tauler per a cada patr¨® d'element amb un segon nombre incrementat al nom de la propietat.
Quan configurant el widget en un tauler de control de plantilla, nom¨¦s s'han d'establir els patrons dels elements configurats a la plantilla.
Comportament dels par¨¤metres:
- obligatori| |Etiquetes d'element|<|<|<|<| |<|Tipus d'avaluaci¨®|0|columns.0.item_tags_evaltype|0 - (per defecte) I/O;
2 - Or.| |^|Nom de l'etiqueta|1|columns.0.item_tags.0.tag|Qualsevol valor de cadena.
Nota: el segon nombre del nom de propietat fa refer¨¨ncia a l'ordre de l'etiqueta a la llista d'avaluaci¨® d'etiquetes.<br >
Comportament del par¨¤metre:
- obligatori si es configura Etiquetes d'element| |^|Operador|0|columns.0.item_tags.0.operator|0 - Cont¨¦;
1 - ?s igual;
2 - No cont¨¦;
3 - No ¨¦s igual;<br >4 - Existeix;
5 - No existeix.
Nota: el segon nombre del nom de la propietat fa refer¨¨ncia a l'ordre de l'etiqueta a l'avaluaci¨® de l'etiqueta llista.
Comportament del par¨¤metre:
- obligatori si s'est¨¤ configurant Etiquetes d'element| |^|Valor de l'etiqueta|1|columns.0.item_tags.0.value|Qualsevol valor de cadena.
Nota: el segon nombre del nom de la propietat fa refer¨¨ncia a l'ordre de l'etiqueta a la llista d'avaluaci¨® d'etiquetes.<br >
Comportament del par¨¤metre:
- obligatori si es configura Etiquetes d'element| |Color base|<|1|columns.0.color_base|Codi de color hexadecimal (p. ex., FF0000
).| |Mostra el valor com a|<|0|columns.0.display_value_as|1 - (per defecte) ±·³Ü³¾¨¨°ù¾±³¦;
2 - Text.| |Display|<|0|columns.0.display|1 - (per defecte) Tal com ¨¦s;
2 - Barra;
3 - Indicadors;
6 - Sparkline.| |Min|<|1|columns.0.min|Qualsevol valor num¨¨ric. S'admeten Sufixos (p. ex., "1d", "2w", "4K", "8G").
Comportament dels par¨¤metres:
- ²¹»å³¾¨¨²õ si Mostra el valor com a s'estableix en "Num¨¨ric" i Display s'estableix en "Barra" o "Indicadors" | |Max|<|1|columns.0.max|Qualsevol valor num¨¨ric. S'admeten Sufixos (p. ex., "1d", "2w", "4K", "8G").
Comportament dels par¨¤metres:
- ²¹»å³¾¨¨²õ si Mostra el valor com a s'estableix en "Num¨¨ric" i Display s'estableix en "Barra" o "Indicadors" | |Sparkline|<|<|<|<| |<|Width|0|columns.0.sparkline.width|Els valors possibles oscil¡¤len entre 0 i 10.
Per defecte: 1.
Comportament del par¨¤metre:
- supported si Display ¨¦s 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:
- supported si Display ¨¦s establert en "Sparkline"| |^|Color|1|columns.0.sparkline.color|Codi de color hexadecimal (p. ex., FF0000
).
Per defecte: 42A5F5
.
Comportament del par¨¤metre:
- supported si Display ¨¦s establert en "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 Display ¨¦s establert en "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 dels par¨¤metres:
- ²¹»å³¾¨¨²õ si Display s'estableix 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.).
Par¨¤metre behavior:
- admesa si Display ¨¦s definit en "Sparkline"| |^|Dades de l'historial|0|columns.0.sparkline.history|0 - (per defecte) ´¡³Ü³Ù´Ç³¾¨¤³Ù¾±³¦;
1 - Historial;
2 - Tend¨¨ncies.
Comportament del par¨¤metre:
- supported si Display ¨¦s establert en "Sparkline"| |Llindars|<|<|<|<| |<|Color|1|columns.0.thresholds.0.color|Codi de color hexadecimal (per exemple, FF0000
).
Comportament del par¨¤metre:
- ²¹»å³¾¨¨²õ si Mostra el valor com a est¨¤ definit en "Num¨¨ric"| |^|Llindar|1|columns.0.thresholds.0.threshold|Qualsevol valor num¨¨ric. S'admeten Sufixos (p. ex., "1d", "2w", "4K", "8G").
Comportament dels par¨¤metres:
- ²¹»å³¾¨¨²õ si Mostra el valor com a s'estableix en "Num¨¨ric"| |Destacats|<|<|<|<| |<|Highlight|1|columns.0.highlights.0.color|Codi de color hexadecimal (per exemple, FF0000
).
Comportament del par¨¤metre:
- admesa si Mostra el valor com a s'estableix en "Text"| |^|Llindar|1|columns.0.highlights.0.pattern|Qualsevol expressi¨® regular.
Comportament del par¨¤metre:
- ²¹»å³¾¨¨²õ si Mostra el valor com a s'estableix en "Text"| |Llocs decimals|<|0|columns.0.llocs_decimals|Els valors possibles oscil¡¤len entre 0 i 10.
Per defecte: 2.| |°ä´Ç²Ô´Ú¾±²µ³Ü°ù²¹³¦¾±¨® avan?ada|<|<|<|<| |Funci¨® d'agregaci¨®|<|0|columns.0.aggregate_function|Si Mostra el valor com a s'estableix en "Num¨¨ric":
0 - (per defecte) no utilitzat;
1 - min;< br>2 - m¨¤xim;
3 - mitjana;
4 - recompte;
5 - suma;
6 - primer;
7 - ¨²ltim.
Si Mostra el valor com a est¨¤ definit com a "Text":
0 - (per defecte) no utilitzat;
4 - recompte;
6 - primer;<br >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.).
Par¨¤metre 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.).
Par¨¤metre 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 com a ¨¦s establert en "Num¨¨ric"|
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 Elements principals. Per obtindre m¨¦s informaci¨® sobre la configuraci¨® d'un tauler, veieu dashboard.create
.
Configureu un giny Elements principals que ensenyi dades per a l'equip "10084" i nom¨¦s per als elements per als quals l'etiqueta amb el nom "component" cont¨¦ el valor "cpu". A m¨¦s, mostreu les dades amb els equips situats a la part superior i empreu una barra de color per a la representaci¨® de les cel¡¤les.
{
"jsonrpc": "2.0",
"method": "dashboard.create",
"params": {
"name": "My dashboard",
"display_period": 30,
"auto_start": 1,
"pages": [
{
"widgets": [
{
"type": "topitems",
"name": "Top items",
"x": 0,
"y": 0,
"width": 36,
"height": 5,
"view_mode": 0,
"fields": [
{
"type": 3,
"name": "hostids.0",
"value": 10084
},
{
"type": 1,
"name": "columns.0.items.0",
"value": "*"
},
{
"type": 1,
"name": "columns.0.item_tags.0.tag",
"value": "component"
},
{
"type": 0,
"name": "columns.0.item_tags.0.operator",
"value": 0
},
{
"type": 1,
"name": "columns.0.item_tags.0.value",
"value": "cpu"
},
{
"type": 0,
"name": "columns.0.display",
"value": 2
},
{
"type": 0,
"name": "layout",
"value": 1
}
]
}
]
}
],
"userGroups": [
{
"usrgrpid": 7,
"permission": 2
}
],
"users": [
{
"userid": 1,
"permission": 3
}
]
},
"id": 1
}
Resposta: