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

Paràmetres

Els paràmetres següents s'admeten al giny de Gràfic.

Conjunt de dades

Els paràmetres següents són compatibles per configurar un conjunt de dades.

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

Eixos

S'admeten els paràmetres següents per configurar els Eixos.

Llegenda

Els paràmetres següents són compatibles per configurar la Llegenda.

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.

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.

Petició:

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

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

Veieu també

• Camp de giny de tauler
• dashboard.create
• dashboard.update