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 |
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).|
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")|
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 |
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. |
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" |
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. |
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
.
Configura un giny ³Ò°ù¨¤´Ú¾±³¦ de la manera seg¨¹ent:
{
"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: