You are viewing documentation for the development version, it may be incomplete.
Join our translation project and help translate Zabbix documentation into your native language.

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

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

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é