15 Historial d'elements

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 Historial d'elements als mètodes dashboard.create i dashboard.update.

Paràmetres

Els paràmetres següents són compatibles amb el giny Historial d'elements.

Columnes

Les columnes tenen paràmetres comuns i paràmetres addicionals en funció de la configuració del paràmetre Element.

Els paràmetres següents són compatibles amb totes les columnes.

Els paràmetres de columna següents s'admeten si l'Element configurat és un element de tipus numèric.

|Paràmetre|<|tipus|nom|valor| |-|--------|--|---------|---------------------------- -----| |Vista|<|0|columns.0.display|1 - (per defecte) Tal com és;
2 - Barra;
3 - Indicadors.| |Min|<|1|columns.0.min|Qualsevol valor numèric.

Comportament del paràmetre:
- admès si Vista és configurada a "Barra" o "Indicadors"| |Max|<|1|columns.0.max|Qualsevol valor numèric.

Comportament del paràmetre:
- admès si Vista és configurada a "Barra" o "Indicadors"| |Llindars|<|<|<|<| |<|Color|1|columns.0.thresholds.0.color|Codi de color hexadecimal (per exemple, FF0000).| |^|Llindar|1|columns.0.thresholds.0.threshold|Qualsevol valor numèric. Els sufixos (com ara "1d", "2w", "4K", "8G") són compatibles.| |Dades de l'historial|<|0|columns.0.history|0 - (per defecte) Automàtic;
1 - Historial;
2 - Tendències.|

Els paràmetres de columna següents s'admeten si l'Element configurat és un element de tipus caràcter, text o registre.

|Paràmetre|<|tipus|nom|valor| |-|--------|--|---------|---------------------------- -----| |Destacats|<|<|<|<| |<|Destacat|1|columns.0.highlights.0.color|Codi de color hexadecimal (p. ex., FF0000).| |^|Llindar|1|columns.0.highlights.0.pattern|Qualsevol expressió regular.| |Vista|<|0|columns.0.display|1 - (per defecte) Tal com és;
4 - HTML;
5 - Una línia.| |<|Línia simple|0|columns.0.max_length|Els valors possibles oscil·len entre 1 i 500.

Per defecte: 100.

Comportament del paràmetre:
- admès si Vista és establerta a Línia única"| |Emprar el tipus de lletra monoespai|<|0|columns.0.monospace_font|0 - (per defecte) Empra el tipus de lletra predeterminat;
1 - Empra el tipus de lletra monoespai.| |Veure l'hora local|<|0|columns.0.local_time|0 - (per defecte) Mostra la marca de temps;
1 - Mostra l'hora local.

Comportament del paràmetre:
- admès si Element és definit com a element de tipus de registre i Veure marca de temps és establerta a "Activada"|

Els paràmetres de columna següents s'admeten si lElement configurat és de tipus binari.

Configuració avançada

Els següents paràmetres de configuració avançada són compatibles amb el giny Historial d'elements.

|Paràmetre|<|tipus|nom|valor| |-|--------|--|---------|---------------------------- -----| |Valors nous|<|0|sortorder|0 - (per defecte) A dalt;
1 - A baix.| |Mostra la marca de temps|<|0|show_timestamp|0 - (per defecte) Desactivat;
1 - Activat.| |Mostra la capçalera de la columna|<|0|show_column_header|0 - Desactivat;
1 - Horitzontal;
2 - (per defecte) Vertical.| |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 - establiu un giny compatible (Gràfic, Grafic (clàssic) o Prototipus de gràfic amb el seu paràmetre Referència definit a "ABCDE") com a font de dades.

Per defecte: DASHBOARD._timeperiod

Alternativament, podeu establir el període de temps només als paràmetres Des de i Fins a.| |<|Des de|1|time_period.from|Cadena de temps vàlida en la sintaxi de temps absoluta (AAAA-MM-DD hh:mm:ss) o relativa sintaxi temporal (ara , now/d, now/w-1w, etc.).

Comportament del paràmetre:
- admès si El període de temps no és pas definit| |^|Fins a|1|time_period.to|Cadena de temps vàlida en la sintaxi temporal absoluta (AAAA-MM-DD hh:mm:ss) o relativa (ara) , now/d, now/w-1w, etc.).

Comportament del paràmetre:
- admès si El període de temps no és pas definit|

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 Historial d'elements. Per obtindre més informació sobre la configuració d'un tauler, veieu dashboard.create.

Configuració d'un giny Historial d'elements

Configureu un giny Historial d'elements que mostri les dades més recents de dos elements numèrics "42269" i "42270". A més, configureu les columnes d'elements perquè es mostrin verticalment, amb els noms de les columnes en horitzontal; limiteu la visualització a 15 línies de dades i inclou una columna de marca de temps independent.

Petició:

{
           "jsonrpc": "2.0",
           "method": "dashboard.create",
           "params": {
               "name": "My dashboard",
               "display_period": 30,
               "auto_start": 1,
               "pages": [
                   {
                       "widgets": [
                           {
                               "type": "itemhistory",
                               "name": "Item history",
                               "x": "0",
                               "y": "0",
                               "width": "18",
                               "height": "6",
                               "view_mode": "0",
                               "fields": [
                                   {
                                       "type": "0",
                                       "name": "layout",
                                       "value": "1"
                                   },
                                   {
                                       "type": "1",
                                       "name": "columns.0.name",
                                       "value": "CPU utilization"
                                   },
                                   {
                                       "type": "4",
                                       "name": "columns.0.itemid",
                                       "value": "42269"
                                   },
                                   {
                                       "type": "1",
                                       "name": "columns.1.name",
                                       "value": "Memory utilization"
                                   },
                                   {
                                       "type": "4",
                                       "name": "columns.1.itemid",
                                       "value": "42270"
                                   },
                                   {
                                       "type": "0",
                                       "name": "show_lines",
                                       "value": "15"
                                   },
                                   {
                                       "type": "0",
                                       "name": "show_timestamp",
                                       "value": "1"
                                   },
                                   {
                                       "type": "0",
                                       "name": "show_column_header",
                                       "value": "1"
                                   },
                                   {
                                       "type": "1",
                                       "name": "reference",
                                       "value": "KIVKD"
                                   }
                               ]
                           }
                       ]
                   }
               ],
               "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