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 Bresca 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 Bresca, 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 Bresca.
´¥±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð´¥&±ô³Ù;´¥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|ID del Grup d'equips.
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 un tauler de plantilla.| |<|Grups d'equips (Giny)|1|groupids._reference|En lloc de l'ID del Grup d'equips ID:ABCDE._hostgroupids
- establiu un giny compatible (amb el seu par¨¤metre ¸é±ð´Ú±ð°ù¨¨²Ô³¦¾±²¹ establert a "ABCDE
") com a font de dades per als grups d'equips.
Aquest par¨¤metre no ¨¦s compatible 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 pas, 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'ID d'Equip:DASHBOARD.hostids
- establiu la Tria d'Equip com a font de dades per als equips;ABCDE._hostids
- establiu un giny compatible (amb el seu par¨¤metre ¸é±ð´Ú±ð°ù¨¨²Ô³¦¾±²¹ establert a "ABCDE
") com a font de dades per als equips.
Aquest par¨¤metre no s'admet si es configura el giny a una plantilla tauler de control.| |Etiquetes d'equips|<|<|<|<| |<|Tipus d'avaluaci¨®|0|evaltype_host|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 tipus 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 es configura el giny en un [tauler de plantilla] (/manual/api/reference/templatedashboard/object).| |^|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 nombre del nom de la propietat fa refer¨¨ncia a l'ordre de l'etiqueta a la llista d'avaluaci¨® de l'etiqueta.
Comportament del par¨¤metre:
- 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|host_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 es configura el giny en un [tauler de plantilla] (/manual/api/reference/templatedashboard/object).| |Patrons d'element|<|1|items.0|Item nom o patr¨®.
Nota: per configurar diversos patrons d'element, creeu un tauler de control objecte camp de giny per a cada patr¨® d'element amb un nombre incrementat al nom de la propietat.
Comportament del par¨¤metre:
- obligatori| |Etiquetes d'element|<|<|<|<| |<|Tipus d'avaluaci¨®|0|evaltype_item|0 - (per defecte) I/O;
2 - O.| |^|Nom de l'etiqueta|1|item_tags.0.tag|Qualsevol valor de tipus 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 s'est¨¤ configurant Etiquetes d'element| |^|Operador|0|item_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.
Comportament del par¨¤metre:
- obligatori si es configura etiquetes d'element| |^|Valor de l'etiqueta|1|item_tags.0.value|Qualsevol valor de tipus 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 s'est¨¤ configurant Etiquetes d'element| |Mostra els equips en manteniment|<|0|manteniment|0 - (per defecte) Desactivat;
1 - Activat.| |Vista|<|0|show.0|1 - Etiqueta principal;
2 - Etiqueta secund¨¤ria.
Nota: per configurar diversos valors, creeu un objecte de camp de giny de tauler per a cada valor amb un nombre incrementat al nom de la propietat.
Per defecte: 1, 2.| |¸é±ð´Ú±ð°ù¨¨²Ô³¦¾±²¹|<|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|
Els seg¨¹ents par¨¤metres de configuraci¨® avan?ada s¨®n compatibles amb el giny Bresca.
El nombre del nom de propietat Llindars (p. ex. thresholds.0.color) fa refer¨¨ncia al lloc del llindar en una llista, 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 Áú»¢¶Ä²© (com ara "thresholds.0.threshold":"5"
¡ú "thresholds.0.threshold":"1"
; "thresholds.1.threshold":"1"
¡ú "thresholds.1.threshold": "5"
).
±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð | tipus | nom | valor |
---|---|---|---|
Etiqueta principal | |||
Tipus | 0 | primary_label_type | 0 - (per defecte) Text; 1 - Valor. |
Text | 1 | primary_label | Qualsevol valor de cadena, incloses les macros. Macros admeses: {HOST.*}, {ITEM.*}, {INVENTORY.*}, macros d'usuari. Valor predeterminat: {HOST.NAME} Comportament del par¨¤metre: - ²¹»å³¾¨¨²õ si Tipus s'estableix a "Text" |
Nombre de decimals | 0 | primary_label_decimal_places | Els valors possibles oscil¡¤len entre 0 i 6. Per defecte: 2. Comportament dels par¨¤metres : - ²¹»å³¾¨¨²õ si Tipus s'estableix a "Valor" |
Mida (tipus) | 0 | ³Ù¾±±è³Ü²õ³å³¾¾±»å²¹³å±ð³Ù¾±±ç³Ü±ð³Ù²¹³å±è°ù¾±³¾¨¤°ù¾±²¹ | 0 - (per defecte) ´¡³Ü³Ù´Ç³¾¨¤³Ù¾±³¦; 1 - Personalitzat. |
Size | 0 | primary_label_size | Els valors possibles oscil¡¤len entre 1 i 100. Per defecte: 20. Comportament del par¨¤metre: - ²¹»å³¾¨¨²õ si Mida (tipus) ¨¦s establert a "Personalitzat" |
Negreta | 0 | primary_label_bold | 0 - (per defecte) Desactivat; 1 - Activat. |
Color | 1 | primary_label_color | Codi de color hexadecimal (per exemple, FF0000 ).Per defecte: basat en el tema d'Objecte de configuraci¨® i Objecte d'usuari:1F2C33 per a "tema blau" o "hc-light";EEEEEE per a "fosc tema" o "hc-fosc". |
Unitats (casella de selecci¨®) | 0 | primary_label_units_show | 0 - Desactivat; 1 - (per defecte) Activat. Comportament del par¨¤metre : - ²¹»å³¾¨¨²õ si Tipus s'estableix a "Valor" |
Unitats (valor) | 1 | primary_label_units | Qualsevol valor de cadena."" (buida)Comportament del par¨¤metre: - ²¹»å³¾¨¨²õ si Tipus s'estableix a "Valor" i Unitats (casella de selecci¨®) s'estableix a "Activat" |
±Ê´Ç²õ¾±³¦¾±¨® | 0 | primary_label_units_pos | 0 - Abans del valor; 1 - (per defecte) Despr¨¦s del valor. Comportament del par¨¤metre: - ²¹»å³¾¨¨²õ si Tipus s'estableix a "Valor" i Unitats (casella de selecci¨®) s'estableix a "Actiu" Aquest par¨¤metre s'ignora si s'estableix a una de les seg¨¹ents unitats de temps relatiu: unixtime, uptime, s. |
Etiqueta secund¨¤ria | |||
Tipus | 0 | secondary_label_type | 0 - Text; 1 - (per defecte) Valor. |
Text | 1 | secondary_label | Qualsevol valor de cadena, incloses les macros. Macros admeses: {HOST.*}, {ITEM.*}, {INVENTORY.*}, macros d'usuari. Valor per defecte: {{ITEM.LASTVALUE}.fmtnum(2)} Comportament del par¨¤metre: - ²¹»å³¾¨¨²õ si Tipus ¨¦s establert a "Text" |
Llocs decimals | 0 | secondary_label_decimal_places | Els valors possibles oscil¡¤len entre 0 i 6. Per defecte: 2. Comportament del par¨¤metre : - ²¹»å³¾¨¨²õ si Tipus s'estableix a "Valor" |
Mida (tipus) | 0 | secondary_label_size_type | 0 - (per defecte) ´¡³Ü³Ù´Ç³¾¨¤³Ù¾±³¦; 1 - Personalitzat. |
Size | 0 | secondary_label_size | Els valors possibles oscil¡¤len entre 1 i 100. Per defecte: 30. Comportament del par¨¤metre: - ²¹»å³¾¨¨²õ si Mida (tipus) ¨¦s establerta a "Personalitzat" |
Negreta | 0 | secondary_label_bold | 0 - Desactivat; 1 - (per defecte) Activat. |
Color | 1 | secondary_label_color | Codi de color hexadecimal (per exemple, FF0000 ).Per defecte: basat en el tema d'objecte de configuraci¨® i Objecte d'usuari:1F2C33 per a "tema blau" o "hc-light";EEEEEE per a "fosc tema" o "hc-fosc". |
Unitats (casella de selecci¨®) | 0 | secondary_label_units_show | 0 - Desactivat; 1 - (per defecte) Activat. Comportament del par¨¤metre : - ²¹»å³¾¨¨²õ si Tipus s'estableix a "Valor" |
Unitats (valor) | 1 | secondary_label_units | Qualsevol valor de cadena."" (buida)Comportament del par¨¤metre: - ²¹»å³¾¨¨²õ si Tipus s'estableix a "Valor" i Unitats (casella de selecci¨®) s'estableix a "Activat" |
±Ê´Ç²õ¾±³¦¾±¨® | 0 | secondary_label_position | 0 - Abans del valor; 1 - (per defecte) Despr¨¦s del valor. Comportament del par¨¤metre: - ²¹»å³¾¨¨²õ si Tipus s'estableix a "Valor" i Unitats (casella de selecci¨®) s'estableix a "Actiu" Aquest par¨¤metre s'ignora si s'estableix a una de les seg¨¹ents unitats relacionades amb el temps: unixtime, uptime, s. |
Color de fons | |||
Color de fons | 1 | bg_color | Codi de color hexadecimal (p. ex., FF0000 ).Per defecte: basat en el tema d'Objecte de configuraci¨® i Objecte d'usuari:D9E7ED per a "tema blau";3D5059 per a "tema fosc";<br >AAD7E9 per a "hc-light";335463 per a "hc-dark". |
Llindars | |||
Interpolaci¨® de colors | 0 | interpolation | 0 - Inhabilitat; 1 - (per defecte)?Activat. |
Color | 1 | thresholds.0.color | Codi de color hexadecimal (p. ex., FF0000 ). |
Llindar | 1 | thresholds.0.threshold | Qualsevol valor num¨¨ric. Els sufixos (p. ex., "1d", "2w", "4K", "8G") s¨®n compatibles. |
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 Bresca. Per obtindre m¨¦s informaci¨® sobre la configuraci¨® d'un tauler, veieu dashboard.create
.
Configureu un giny Bresca que ensenyi l'¨²s dels processos del servidor Áú»¢¶Ä²©. A m¨¦s, canvieu l'etiqueta principal de les cel¡¤les de bresca i ajusteu visualment el giny amb llindars.
{
"jsonrpc": "2.0",
"method": "dashboard.create",
"params": {
"name": "My dashboard",
"display_period": "30",
"auto_start": "1",
"pages": [
{
"widgets": [
{
"type": "honeycomb",
"name": "Honeycomb",
"x": "0",
"y": "0",
"width": "8",
"height": "5",
"view_mode": "0",
"fields": [
{
"type": 2,
"name": "groupids.0",
"value": 4
},
{
"type": 3,
"name": "hostids.0",
"value": 10084
},
{
"type": 1,
"name": "items.0",
"value": "Áú»¢¶Ä²© server: Utilization*"
},
{
"type": 1,
"name": "primary_label",
"value": "{ITEM.NAME}"
},
{
"type": 1,
"name": "thresholds.0.color",
"value": "0EC9AC"
},
{
"type": 1,
"name": "thresholds.0.threshold",
"value": "0"
},
{
"type": 1,
"name": "thresholds.1.color",
"value": "FFD54F"
},
{
"type": 1,
"name": "thresholds.1.threshold",
"value": "70"
},
{
"type": 1,
"name": "thresholds.2.color",
"value": "FF465C"
},
{
"type": 1,
"name": "thresholds.2.threshold",
"value": "90"
},
{
"type": 1,
"name": "reference",
"value": "KSTMQ"
}
]
}
]
}
],
"userGroups": [
{
"usrgrpid": 7,
"permission": 2
}
],
"users": [
{
"userid": 1,
"permission": 3
}
]
},
"id": 1
}
Resposta: