Documentation
Table of Contents
9 Gràfic
Descripció
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 Gràfic 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 Gràfic, consulteu el comportament dels paràmetres que es descriuen a les taules següents.
Paràmetres
Els paràmetres següents s'admeten al giny de Gràfic.
| Paràmetre | 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. |
| Referència | 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.
|Paràmetre|<|tipus|nom|valor| |-|--------|--|---------|---------------------------- -----| |Tipus de conjunt de dades|<|0|ds.dataset_type.0|0 - Llista d'elements;
1 - (per defecte) Patró d'element.| |Paràmetres si Tipus de conjunt de dades s'estableix a "Llista d'elements"|<|<|<|<| |<|Items|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| |^|Color|1|ds.color.0.0|Codi de color hexadecimal (p. ex., FF0000).
Comportament del paràmetre:<br >- obligatori| |Paràmetres 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., "Zabbix*").
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) Línia;
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.
Paràmetre Mida del punt no disponible si Dibuix s'estableix a "Línia", "Escala" o "Barra".| |Transparència|<|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.
Paràmetre Afegit no disponible si Funció d'afegit s'estableix a "cap".| |Aproximació|<|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ó.
|Paràmetre|<|tipus|nom|valor| |-|--------|--|---------|---------------------------- -----| |Tria de dades de l'historial|<|0|font|0 - (per defecte) Automàtic;
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:
- admès 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:
- admès 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:
- admès 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:
- admès 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.
| Paràmetre | tipus | nom | valor |
|---|---|---|---|
| Període de temps | 1 | time_period._reference | DASHBOARD._timeperiod - estableix la tria de Període de temps com a font de dades.ABCDE._timeperiod - defineix un giny compatible (Gràfic, Gràfic (clàssic) o prototip de gràfic amb el seu paràmetre Referència definit a "ABCDE") com a font de dades.Per defecte: DASHBOARD._timeperiodAltrament, podeu definir el període de temps només als paràmetres Des de i Fins a. |
| Des de | 1 | time_from | Cadena d'hora vàlida en format AAAA-MM-DD hh:mm:ss.Període de temps relatiu també són compatibles ( now, now/d, now/w-1w, etc.) també són compatibles.Comportament de la propietat: - admès si no s'ha definit el Període de temps |
| Fins a | 1 | time_to | Valor de cadena de temps vàlid en format absolut (AAAA-MM-DD hh:mm:ss) o relatiu també s'admeten valors (now, now/d, ara/w-1w, etc.).Comportament de la propietat: - admès si no s'ha definit el Període de temps |
Eixos
S'admeten els paràmetres següents per configurar els Eixos.
| Paràmetre | tipus | nom | valor |
|---|---|---|---|
| Left Y | 0 | lefty | 0 - Desactivat; 1 - (per defecte) Habilitat. Comportament del paràmetre: - admès 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: - admès 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) Automàtic; 1 - Estàtic. |
| unitats_dretes | |||
| Units (valor) | 1 | lefty_static_units | Qualsevol valor de cadena. Per defecte: "" (buida). |
| unitats_estàtiques_dretes | |||
| X-Axis | 0 | xaxis | 0 - Inhabilitat; 1 - (per defecte) Habilitat. |
Llegenda
Els paràmetres següents són compatibles per configurar la Llegenda.
| Paràmetre | tipus | nom | valor |
|---|---|---|---|
| Veure la llegenda | 0 | legend | 0 - Desactivat; 1 - (per defecte) Habilitat. Comportament del paràmetre:< br>- admès 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: - admès 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: - admès si Veure la llegenda és establert a "Habilitat" |
| Fileres | 0 | legend_lines_mode | 0 - (per defecte) Corregit; 1 - Variable. Comportament del paràmetre:<br >- admès 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: - admès 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: - admès 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.
|Paràmetre|<|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|
Anul·lacions
Els paràmetres següents s'admeten per configurar Anul·lacions.
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.
| Paràmetre | tipus | nom | valor |
|---|---|---|---|
| Patró d'equip | 1 | or.hosts.0.0 | Host nom o patró (p. ex., Zabbix*).[Comportament del paràmetre] (/manual/api/reference_commentary#parameter-behavior): - obligatori |
| Patró d'element | 1 | or.items.0.0 | Item nom o patró (p. ex. *: Nombre de *valors per segon processats).Comportament del paràmetre: - obligatori |
| Color base | 1 | o.color.0 | Codi de color hexadecimal (per exemple, FF0000). |
| Amplada | 0 | o.amplada.0 | Els valors vàlids oscil·len entre 1 i 10. |
| Dibuix | 0 | o.tipus.0 | 0 - Línia; 1 - Punts; 2 - Escala; 3 - Barra. |
| Transparència | 0 | o.transparència.0 | Els valors vàlids van d'1 a 10. |
| Emplenat | 0 | or.fill.0 | Els valors vàlids oscil·len entre 1 i 10. |
| Mida del punt | 0 | o.mida del punt.0 | Els valors vàlids oscil·len entre 1 i 10. |
| Manquen dades | 0 | o.missingdatafunc.0 | 0 - Cap; 1 - Connectat; 2 - Tracta com a 0; 3 - Darrer conegut. |
| Eix Y | 0 | o.eix.0 | 0 - Esquerra; 1 - Dreta. |
| Desplaçament de temps | 1 | o.timeshift.0 | 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 Gràfic. Per obtindre més informació sobre la configuració d'un tauler, veieu dashboard.create.
Configurar un giny Gràfic
Configura un giny Gràfic 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": "Zabbix 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: