Áú»¢¶Ä²©

27 Elements 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 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)|<|<|<|<|

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

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.|

Columnes

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"|

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

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

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:

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

Veieu tamb¨¦