Áú»¢¶Ä²©

11 Bresca

¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®

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|

°ä´Ç²Ô´Ú¾±²µ³Ü°ù²¹³¦¾±¨® avan?ada

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.

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 Bresca. Per obtindre m¨¦s informaci¨® sobre la configuraci¨® d'un tauler, veieu dashboard.create.

°ä´Ç²Ô´Ú¾±²µ³Ü°ù²¹³¦¾±¨® d'un giny Bresca

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:

{
           "jsonrpc": "2.0",
           "result": {
               "dashboardids": [
                   "3"
               ]
           },
           "id": 1
       }

Veieu tamb¨¦