Áú»¢¶Ä²©

8 ³Ò°ù¨¤´Ú¾±³¦

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

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 ³Ò°ù¨¤´Ú¾±³¦ 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 ³Ò°ù¨¤´Ú¾±³¦, consulteu el comportament dels par¨¤metres que es descriuen a les taules seg¨¹ents.

±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð²õ

Els par¨¤metres seg¨¹ents s'admeten al giny de ³Ò°ù¨¤´Ú¾±³¦.

±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð tipus nom valor
Interval de refresc 0 rf_rate 0 - Sense refresc;
10 - 10 segonds;
30 - 30 segonds;
60 - (per defecte) 1 minut;
120 - 2 minuts;
600 - 10 minuts;
900 - 15 minuts.
¸é±ð´Ú±ð°ù¨¨²Ô³¦¾±²¹ 1 reference Qualsevol valor de cadena que tingui 5 caracters (com ara ABCDE o JBPNL). Aquest valor ha d'¨¦sser ¨²nic al tauler al que pertany el giny.

Comportament de la propietat:
- obligatori

Conjunt de dades

Els par¨¤metres seg¨¹ents s¨®n compatibles per configurar un conjunt de dades.

El primer nombre del nom de la propietat (p. ex., ds.hosts.0.0, ds.items.0.0) representa el conjunt de dades concret; mentre que el segon nombre, si est¨¤ present, representa l'equip o l'element configurat.

|±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð|<|tipus|nom|valor| |-|--------|--|---------|---------------------------- -----| |Tipus de conjunt de dades|<|0|ds.dataset_type.0|0 - Llista d'elements;
1 - (per defecte) Patr¨® d'element.| |±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð²õ si Tipus de conjunt de dades s'estableix a "Llista d'elements"|<|<|<|<| |<|Elements|4|ds.itemids.0.0|Identificador de Item.

Nota: per configurar diversos elements, creeu un camp de giny de tauler objecte per a cada element.

Comportament del par¨¤metre:
- obligatori| |^|Elements (Giny)|1|ds.0.itemids.0._reference|En lloc d'Elements ID:
ABCDE._itemid - estableix un giny compatible (amb el seu par¨¤metre Reference definit en "ABCDE") com a font de dades per als elements.
<br >Nota: per configurar diversos ginys, creeu un objecte de camp de giny del tauler de control per a cada giny amb un nombre incrementat al nom de la propietat.

Aquest par¨¤metre s'admet des de Áú»¢¶Ä²© 7.0.1.

Comportament del par¨¤metre:
- obligatori si Tipus de conjunt de dades ¨¦s establert a "Llistat d'elements" i Elements no ¨¦s pas definit | |^|Color|1|ds.color.0.0|Codi de color hexadecimal (p. ex., FF0000).

Comportament del par¨¤metre:<br >- obligatori| |±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð²õ si Tipus de conjunt de dades s'estableix en "Patr¨® d'element"|<|<|<|<| |<|Patr¨® d'equip|1|ds.hosts.0.0|Equip nom o patr¨® (p. ex., "Áú»¢¶Ä²©*").

Comportament del par¨¤metre:
- obligatori| |^|Patr¨® d'element|1|ds.items.0.0|Item nom o patr¨® (p. ex., "*: Nombre de *valors per segon" processats) ).

Comportament del par¨¤metre:
- obligatori| |^|Color|1|ds.color.0|Codi de color hexadecimal (p. ex., FF0000).

Per defecte: FF465C.| |Dibuix|<|0|ds.type.0|0 - (per defecte) ³¢¨ª²Ô¾±²¹;
1 - Punts;
2 - Escala;
3 - Barra.| |Stacked|<|0|ds.stacked.0|0 - (per defecte) Desactivat;
1 - Activat.

El par¨¤metre Stacked no ¨¦s disponible si Dibuix s'ha establert a "Punts".| |Amplada|<|0|ds.width.0|Els valors v¨¤lids oscil¡¤len entre 1 i 10.

Per defecte: 1.

El par¨¤metre Amplada no ¨¦s disponible si Dibuix s'ha establert a "Punts" o "Barra".| |Mida del punt|<|0|ds.pointsize.0|Els valors v¨¤lids oscil¡¤len entre 1 i 10.

Per defecte: 3.

±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð Mida del punt no disponible si Dibuix s'estableix a "L¨ªnia", "Escala" o "Barra".| |°Õ°ù²¹²Ô²õ±è²¹°ù¨¨²Ô³¦¾±²¹|<|0|ds.transparency.0|Els valors v¨¤lids oscil¡¤len entre 1 i 10.

Per defecte: 5.| |Emplenat|<|0|ds.fill.0|Els valors v¨¤lids van d'1 a 10.

Per defecte: 3.

El par¨¤metre Emplenat no ¨¦s disponible si Dibuix s'ha establert a "Punts" o "Barra".| |Manquen dades|<|0|ds.missingdatafunc.0|0 - (per defecte) Cap;
1 - Connectat;
2 - Tracta com a 0;
3 - Darrer conegut.< br>
El par¨¤metre Manquen dades no ¨¦s disponible si Dibuix s'estableix a "Punts" o "Barra".| |Eix Y|<|0|ds.axisy.0|0 - (per defecte) Esquerra;
1 - Dreta.| |Despla?ament de temps|<|1|ds.timeshift.0|Cadena de temps v¨¤lida (p. ex., 3600, 1h, etc.).
Podeu emprar sufixos de temps. Tamb¨¦ es permeten valors negatius.

Per defecte: "" (buida).| |Funci¨® d'afegit|<|0|ds.aggregate_function.0|0 - (per defecte) cap;
1 - m¨ªn;
2 - m¨¤xim;
3 - mitjana;
4 - recompte;
5 - suma;
6 - primer;
7 - darrer.| |Interval d'afegit|<|1|ds.aggregate_interval.0|Cadena de temps v¨¤lida (per exemple, 3600, 1h, etc.).
Podeu emprar sufixos de temps.

Per defecte: 1h.| |Afegit|<|0|ds.aggregate_grouping.0|0 - (per defecte) Cada element;
1 - Conjunt de dades.

±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð Afegit no disponible si Funci¨® d'afegit s'estableix a "cap".| |´¡±è°ù´Ç³æ¾±³¾²¹³¦¾±¨®|<|0|ds.approximation.0|1 - m¨ªn;
2 - (per defecte) mitjana;
4 - m¨¤xim;
7 - tot.| |Etiqueta del conjunt de dades|<|1|ds.data_set_label.0|Qualsevol valor de cadena.

Per defecte: "" (buida).|

Opcions de visualitzaci¨®

S'admeten els par¨¤metres seg¨¹ents per configurar les Opcions de visualitzaci¨®.

|±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð|<|tipus|nom|valor| |-|--------|--|---------|---------------------------- -----| |Tria de dades de l'historial|<|0|font|0 - (per defecte) ´¡³Ü³Ù´Ç³¾¨¤³Ù¾±³¦;
1 - Historial;
2 - Tend¨¨ncies.| |Triggers simples|<|0|activadors_simples|0 - (per defecte) Desactivat;
1 - Activat.| |Temps de treball|<|0|working_time|0 - (per defecte) Inhabilitat;
1 - Activat.| |L¨ªnia percentil (esquerra)|<|<|<|<| |<|Estat|0|percentile_left|0 - (per defecte) Inhabilitat;
1 - Activat.

Comportament de la propietat:
- ²¹»å³¾¨¨²õ si Eix Y (a la configuraci¨® del Conjunt de dades) s'ha establert a "Esquerra")| |^|Valor|0|valor_percentil_esquerra|Els valors v¨¤lids oscil¡¤len entre 1 i 100.

Comportament de la propietat:
- ²¹»å³¾¨¨²õ si Eix Y (a la configuraci¨® del Conjunt de dades) s'ha establert a "Esquerra")| |L¨ªnia percentil (dreta)|<|<|<|<| |<|Estat|0|percentile_right|0 - (per defecte) Inhabilitat;
1 - Activat.

Comportament de la propietat:
- ²¹»å³¾¨¨²õ si Eix Y (a la configuraci¨® del Conjunt de dades) s'ha establert a "Dreta")| |^|Valor|0|valor_percentil_dret|Els valors v¨¤lids oscil¡¤len entre 1 i 100.

Comportament de la propietat:
- ²¹»å³¾¨¨²õ si Eix Y (a la configuraci¨® del Conjunt de dades) s'ha establert a "Dreta")|

Per¨ªode de temps

S'admeten els par¨¤metres seg¨¹ents per configurar el Per¨ªode de temps.

±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð< tipus nom
Per¨ªode de temps 1 time_period._reference
Des de 1 time_from
Fins a 1 time_to

Eixos

S'admeten els par¨¤metres seg¨¹ents per configurar els Eixos.

±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð tipus nom valor
Left Y 0 lefty 0 - Desactivat;
1 - (per defecte) Habilitat.

Comportament del par¨¤metre:
- ²¹»å³¾¨¨²õ si l'eix Y (a la configuraci¨® del Conjunt de dades) s'ha establert a "Esquerra"
Right Y 0 righty 0 - (per defecte) Desactivat;
1 - Activat.

Comportament del par¨¤metre:
- ²¹»å³¾¨¨²õ si s'estableix Eix Y (a la configuraci¨® del Conjunt de dades) a "Dreta"
Min 1 lefty_min Qualsevol valor num¨¨ric.

Per defecte: "" (buit).
righty_min
Max 1 lefty_max Qualsevol valor num¨¨ric.

Per defecte: "" (buit).
righty_max
Units (tipus) 0 unitats_esquerra 0 - (per defecte) ´¡³Ü³Ù´Ç³¾¨¤³Ù¾±³¦;
1 - Est¨¤tic.
unitats_dretes
Units (valor) 1 lefty_static_units Qualsevol valor de cadena.

Per defecte: "" (buida).
³Ü²Ô¾±³Ù²¹³Ù²õ³å±ð²õ³Ù¨¤³Ù¾±±ç³Ü±ð²õ³å»å°ù±ð³Ù±ð²õ
X-Axis 0 xaxis 0 - Inhabilitat;
1 - (per defecte) Habilitat.

Llegenda

Els par¨¤metres seg¨¹ents s¨®n compatibles per configurar la Llegenda.

±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð tipus nom valor
Veure la llegenda 0 legend 0 - Desactivat;
1 - (per defecte) Habilitat.

Comportament del par¨¤metre:< br>- ²¹»å³¾¨¨²õ si Veure la llegenda ¨¦s establert a "Habilitat"
Veure min/avg/max 0 legend_statistic 0 - (per defecte) Desactivat;
1 - Activat.

Comportament del par¨¤metre:
- ²¹»å³¾¨¨²õ si Veure la llegenda ¨¦s establert a "Habilitat"
Veure la funci¨® d'agregaci¨® 0 legend_aggregation 0 - (per defecte) Desactivat;
1 - Activat.

Comportament del par¨¤metre:
- ²¹»å³¾¨¨²õ si Veure la llegenda ¨¦s establert a "Habilitat"
Fileres 0 legend_lines_mode 0 - (per defecte) Corregit;
1 - Variable.

Comportament del par¨¤metre:<br >- ²¹»å³¾¨¨²õ si Veure la llegenda ¨¦s establert a "Activat"
Nombre de fileres/
Nombre m¨¤xim de fileres
0 legend_lines Els valors possibles oscil¡¤len entre 1 i 10.

Per defecte: 1.

Comportament del par¨¤metre:
- ²¹»å³¾¨¨²õ si Veure la llegenda ¨¦s establert a "Habilitat"
Nombre de columnes 0 legend_columns Els valors possibles oscil¡¤len entre 1 i 4.

Per defecte: 4.

Comportament del par¨¤metre:
- ²¹»å³¾¨¨²õ si Veure la llegenda ¨¦s establert a "Activat" i Veure min/avg/m¨¤x ¨¦s establert a "Desactivat"

Problemes

S'admeten els par¨¤metres seg¨¹ents per configurar els Problemes.

|±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð|<|tipus|nom|valor| |-|--------|--|---------|---------------------------- -----| |Veure problemes|<|0|mostra_problemes|0 - (per defecte) Desactivat;
1 - Activat.| |Nom¨¦s elements seleccionats|<|0|graph_item_problems|0 - Inhabilitat;
1 - (per defecte) Activat.| |Equips amb problemes|<|1|problemhosts.0|Nom d'Equip.

Nota: el nombre del nom de la propietat fa refer¨¨ncia a l'equip configurat.
Per configurar diversos equips, creeu un objecte de camp de giny de tauler per a cada equip.| |Gravetat|<|0|graveses|0 - No classificat;
1 - Informaci¨®;
2 - Av¨ªs;
3 - Mitjana;
4 - Alta;
5 - Desastre.

Per defecte: buit (tots activats).

Nota: per configurar diversos valors, creeu un objecte de camp de giny de tauler per a cada valor.| |Problema|<|1|nom_problema|Problema nom de l'esdeveniment (no distingeix entre maj¨²scules i min¨²scules, nom complet o part d'aquest).| |Etiquetes (el nombre del nom de la propietat (per exemple, tags.tag.0) fa refer¨¨ncia a l'ordre de l'etiqueta a la llista d'avaluaci¨® d'etiquetes)|<|<|<|<| |<|Tipus d'avaluaci¨®|0|evaltype|0 - (per defecte) I/O;
2 - O.| |^|Nom de l'etiqueta|1|tags.tag.0|Qualsevol valor de cadena.

Comportament del par¨¤metre:
- obligatori si es s¨®n configurant Etiquetes| |^|Operador|0|tags.operator.0|0 - Cont¨¦;
1 - ?s igual;
2 - No cont¨¦;
3 - No ¨¦s igual;
4 - Existeix ;
5 - No existeix.

Comportament del par¨¤metre:
- obligatori si es s¨®n configurant Etiquetes| |^|Valor de l'etiqueta|1|tags.value.0|Qualsevol valor de cadena.

Comportament del par¨¤metre:
- obligatori si es s¨®n configurant Etiquetes|

´¡²Ô³Ü±ô¡¤±ô²¹³¦¾±´Ç²Ô²õ

Els par¨¤metres seg¨¹ents s'admeten per configurar ´¡²Ô³Ü±ô¡¤±ô²¹³¦¾±´Ç²Ô²õ.

El primer nombre del nom de la propietat (p. ex. or.0.hosts.0 or.0.items.0) representa el conjunt de dades concret; mentre que el segon nombre, si ¨¦s present, representa l'equip o element configurat.

±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð tipus nom valor
Patr¨® d'equip 1 or.0.hosts.0 Host nom o patr¨® (p. ex., Áú»¢¶Ä²©*).
Aquest par¨¤metre no s'admet si es configura el giny a un tauler de plantilla.

[Comportament del par¨¤metre] (/manual/api/reference_commentary#parameter-behavior):
- obligatori
Patr¨® d'element 1 or.0.items.0 element nom o patr¨® (p. ex. *: Nombre de *valors per segon processats).
Quan es configura el giny a un tauler de plantilles, nom¨¦s es poden establir els patrons per als elements configurats a la plantilla.

Comportament del par¨¤metre:
- obligatori
Color base 1 or.0.color Codi de color hexadecimal (per exemple, FF0000).
Amplada 0 or.0.width Els valors v¨¤lids oscil¡¤len entre 1 i 10.
Dibuix 0 or.0.tipus 0 - ³¢¨ª²Ô¾±²¹;
1 - Punts;
2 - Escala;
3 - Barra.
°Õ°ù²¹²Ô²õ±è²¹°ù¨¨²Ô³¦¾±²¹ 0 ´Ç°ù.0.³Ù°ù²¹²Ô²õ±è²¹°ù¨¨²Ô³¦¾±²¹ Els valors v¨¤lids van d'1 a 10.
Emplenat 0 or.0.fill Els valors v¨¤lids oscil¡¤len entre 1 i 10.
Mida del punt 0 or.0.pointsize Els valors v¨¤lids oscil¡¤len entre 1 i 10.
Manquen dades 0 or.0.missingdatafunc 0 - Cap;
1 - Connectat;
2 - Tracta com a 0;
3 - Darrer conegut.
Eix Y 0 or.0.axisy 0 - Esquerra;
1 - Dreta.
Despla?ament de temps 1 or.0.timeshift Cadena de temps v¨¤lida (per exemple, 3600, 1h, etc.).
Podeu emprar sufixos de temps. Es permeten valors negatius.

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 ³Ò°ù¨¤´Ú¾±³¦. Per obtindre m¨¦s informaci¨® sobre la configuraci¨® d'un tauler, veieu dashboard.create.

Configurar un giny ³Ò°ù¨¤´Ú¾±³¦

Configura un giny ³Ò°ù¨¤´Ú¾±³¦ de la manera seg¨¹ent:

  • 2 conjunts de dades per a un total de 9 elements en 1 equip.
  • El primer conjunt de dades ¨¦s de tipus "Llista d'elements" i consta de 3 elements que es representen per l¨ªnies amb un color diferent, per¨° amb la mateixa amplada, transpar¨¨ncia i farciment.
  • El segon conjunt de dades ¨¦s de tipus "Patr¨® d'elements", consta de 6 elements, t¨¦ una agregaci¨® configurada i es representa amb una l¨ªnia amb un color, amplada, transpar¨¨ncia i farciment personalitzats.
  • El segon conjunt de dades tamb¨¦ t¨¦ una etiqueta de conjunt de dades personalitzada.
  • Les dades del gr¨¤fic es mostren durant un per¨ªode de temps de les ¨²ltimes 3 hores.
  • Els problemes del gr¨¤fic nom¨¦s es mostren per als elements configurats.
  • El gr¨¤fic t¨¦ dos eixos Y dels quals l'eix Y dret nom¨¦s mostra valors per al segon conjunt de dades.
  • La llegenda del gr¨¤fic mostra els elements configurats en 4 files, aix¨ª com els valors m¨ªnims, m¨¤xims i mitjans dels conjunts de dades.

±Ê±ð³Ù¾±³¦¾±¨®:

{
           "jsonrpc": "2.0",
           "method": "dashboard.create",
           "params": {
               "name": "My dashboard",
               "display_period": 30,
               "auto_start": 1,
               "pages": [
                   {
                       "widgets": [
                           {
                               "type": "svggraph",
                               "name": "Graph",
                               "x": 0,
                               "y": 0,
                               "width": 12,
                               "height": 5,
                               "view_mode": 0,
                               "fields": [
                                   {
                                       "type": 0,
                                       "name": "ds.0.dataset_type",
                                       "value": 0
                                   },
                                   {
                                       "type": 4,
                                       "name": "ds.0.itemids.1",
                                       "value": 23264
                                   },
                                   {
                                       "type": 1,
                                       "name": "ds.0.color.1",
                                       "value": "FF0000"
                                   },
                                   {
                                       "type": 4,
                                       "name": "ds.0.itemids.2",
                                       "value": 23269
                                   },
                                   {
                                       "type": 1,
                                       "name": "ds.0.color.2",
                                       "value": "BF00FF"
                                   },
                                   {
                                       "type": 4,
                                       "name": "ds.0.itemids.3",
                                       "value": 23257
                                   },
                                   {
                                       "type": 1,
                                       "name": "ds.0.color.3",
                                       "value": "0040FF"
                                   },
                                   {
                                       "type": 0,
                                       "name": "ds.0.width",
                                       "value": 3
                                   },
                                   {
                                       "type": 0,
                                       "name": "ds.0.transparency",
                                       "value": 3
                                   },
                                   {
                                       "type": 0,
                                       "name": "ds.0.fill",
                                       "value": 1
                                   },
                                   {
                                       "type": 1,
                                       "name": "ds.1.hosts.0",
                                       "value": "Áú»¢¶Ä²© server"
                                   },
                                   {
                                       "type": 1,
                                       "name": "ds.1.items.0",
                                       "value": "*: Number of processed *values per second"
                                   },
                                   {
                                       "type": 1,
                                       "name": "ds.1.color",
                                       "value": "000000"
                                   },
                                   {
                                       "type": 0,
                                       "name": "ds.1.transparency",
                                       "value": 0
                                   },
                                   {
                                       "type": 0,
                                       "name": "ds.1.fill",
                                       "value": 0
                                   },
                                   {
                                       "type": 0,
                                       "name": "ds.1.axisy",
                                       "value": 1
                                   },
                                   {
                                       "type": 0,
                                       "name": "ds.1.aggregate_function",
                                       "value": 3
                                   },
                                   {
                                       "type": 1,
                                       "name": "ds.1.aggregate_interval",
                                       "value": "1m"
                                   },
                                   {
                                       "type": 0,
                                       "name": "ds.1.aggregate_grouping",
                                       "value": 1
                                   },
                                   {
                                       "type": 1,
                                       "name": "ds.1.data_set_label",
                                       "value": "Number of processed values per second"
                                   },
                                   {
                                       "type": 0,
                                       "name": "graph_time",
                                       "value": 1
                                   },
                                   {
                                       "type": 1,
                                       "name": "time_period.from",
                                       "value": "now-3h"
                                   },
                                   {
                                       "type": 0,
                                       "name": "legend_statistic",
                                       "value": 1
                                   },
                                   {
                                       "type": 0,
                                       "name": "legend_lines",
                                       "value": 4
                                   },
                                   {
                                       "type": 0,
                                       "name": "show_problems",
                                       "value": 1
                                   },
                                   {
                                       "type": 1,
                                       "name": "reference",
                                       "value": "YZABC"
                                   }
                               ]
                           }
                       ]
                   }
               ],
               "userGroups": [
                   {
                       "usrgrpid": 7,
                       "permission": 2
                   }
               ],
               "users": [
                   {
                       "userid": 1,
                       "permission": 3
                   }
               ]
           },
           "id": 1
       }

Resposta:

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

Veieu tamb¨¦