16 Vienumu vēsture
Apraksts
Šie parametri un iespējamās īpašību vērtības attiecīgajiem paneļa logrīka lauku objektiem ļauj konfigurēt logrīku Vienuma vēsture metodēs dashboard.create un dashboard.update.
Logrīka fields īpašības netiek validētas paneļa izveides vai atjaunināšanas laikā.
Tas ļauj lietotājiem modificēt iebūvētos logrīkus un izveidot pielāgotus logrīkus, taču vienlaikus rada arī risku izveidot vai atjaunināt logrīkus nepareizi.
Lai nodrošinātu veiksmīgu logrīka Vienuma vēsture izveidi vai atjaunināšanu, lūdzu, skatiet parametru darbību, kas aprakstīta tālāk esošajās tabulās.
Parametri
Šie parametri ir atbalstīti Item history logrīkam.
| Parameter | type | name | value |
|---|---|---|---|
| Refresh interval | 0 | rf_rate | 0 - Nav atsvaidzināšanas; 10 - 10 sekundes; 30 - 30 sekundes; 60 - (noklusējums) 1 minūte; 120 - 2 minūtes; 600 - 10 minūtes; 900 - 15 minūtes. |
| Layout | 0 | layout | 0 - (noklusējums) Horizontāli; 1 - Vertikāli. |
| Columns (skat. zemāk) | |||
| Show lines | 0 | show_lines | Iespējamās vērtības ir diapazonā no 1 līdz 100. Noklusējums: 25. |
| Override host | 1 | override_hostid._reference | ABCDE._hostid - iestatiet saderīgu logrīku (ar tā Reference parametru iestatītu uz "ABCDE") kā datu avotu hosts;DASHBOARD._hostid - iestatiet paneļa Host atlasītāju kā datu avotu hosts.Šis parametrs netiek atbalstīts, konfigurējot logrīku veidnes panelī. |
| Advanced configuration (skat. zemāk) | |||
| Reference | 1 | reference | Jebkura virknes vērtība, kas sastāv no 5 rakstzīmēm (piem., ABCDE vai JBPNL). Šai vērtībai jābūt unikālai paneļa ietvaros, kuram pieder logrīks.Parametra uzvedība: - required |
Kolonnas
Kolonnām ir kopīgi parametri un papildu parametri atkarībā no parametra Vienums konfigurācijas.
Visiem ar kolonnām saistītajiem parametriem skaitlis īpašības nosaukumā (piemēram, columns.0.name) norāda kolonnu, kurai parametrs ir konfigurēts.
Visām kolonnām tiek atbalstīti šādi parametri.
| Parametrs | type | name | value |
|---|---|---|---|
| Nosaukums | 1 | columns.0.name | Jebkura virknes vērtība. Parametra darbība: - obligāts |
| Vienums | 4 | columns.0.itemid | Vienuma ID. Konfigurējot logrīku veidnes panelī, jānorāda tikai tie vienumi, kas konfigurēti veidnē. Parametra darbība: - obligāts |
| Pamatkrāsa | 1 | columns.0.base_color | Heksadecimāls krāsas kods (piemēram, FF0000).Noklusējums: "" (tukšs). |
Tālāk norādītie kolonnas parametri tiek atbalstīti, ja konfigurētais vienums ir skaitliska tipa vienums.
| Parametrs | type | name | value | |
|---|---|---|---|---|
| Attēlojums | 0 | columns.0.display | 1 - (noklusējums) Kā ir; 2 - Josla; 3 - Indikatori. |
|
| Min | 1 | columns.0.min | Jebkura skaitliska vērtība. Parametra darbība: - atbalstīts, ja Attēlojums ir iestatīts uz "Josla" vai "Indikatori" |
|
| Max | 1 | columns.0.max | Jebkura skaitliska vērtība. Parametra darbība: - atbalstīts, ja Attēlojums ir iestatīts uz "Josla" vai "Indikatori" |
|
| Sliekšņi | ||||
| Krāsa | 1 | columns.0.thresholds.0.color | Heksadecimāls krāsas kods (piemēram, FF0000). |
|
| Slieksnis | 1 | columns.0.thresholds.0.threshold | Jebkura skaitliska vērtība. Tiek atbalstīti sufiksi (piemēram, "1d", "2w", "4K", "8G"). | |
| Vēstures dati | 0 | columns.0.history | 0 - (noklusējums) Auto; 1 - Vēsture; 2 - Tendences. |
|
Tālāk norādītie kolonnas parametri tiek atbalstīti, ja konfigurētais vienums ir rakstzīmju, teksta vai žurnāla tipa vienums.
| Parametrs | type | name | value | |
|---|---|---|---|---|
| Izcēlumi | ||||
| Izcēlums | 1 | columns.0.highlights.0.color | Heksadecimāls krāsas kods (piemēram, FF0000). |
|
| Slieksnis | 1 | columns.0.highlights.0.pattern | Jebkura regulārā izteiksme. | |
| Attēlošana | 0 | columns.0.display | 1 - (noklusējums) Kā ir; 4 - HTML; 5 - Vienā rindā. |
|
| Viena rinda | 0 | columns.0.max_length | Iespējamās vērtības ir diapazonā no 1 līdz 500. Noklusējums: 100. Parametra darbība: - atbalstīts, ja Attēlošana ir iestatīta uz "Vienā rindā" |
|
| Izmantot vienplatuma fontu | 0 | columns.0.monospace_font | 0 - (noklusējums) Izmantot noklusējuma fontu; 1 - Izmantot vienplatuma fontu. |
|
| Rādīt vietējo laiku | 0 | columns.0.local_time | 0 - (noklusējums) Rādīt laikspiedolu; 1 - Rādīt vietējo laiku. Parametra darbība: - atbalstīts, ja vienums ir iestatīts kā žurnāla tipa vienums un Rādīt laikspiedolu ir iestatīts uz "Iespējots" |
|
Tālāk norādītie kolonnas parametri tiek atbalstīti, ja konfigurētais vienums ir binārā tipa vienums.
| Parametrs | type | nosaukums | vērtība |
|---|---|---|---|
| Rādīt sīktēlu | 1 | columns.0.show_thumbnail | 0 - (noklusējums) Atspējots; 1 - Iespējots. |
Papildu konfigurācija
Tālāk norādītie papildu konfigurācijas parametri ir atbalstīti Item history logrīkam.
| Parameter | type | name | value | |
|---|---|---|---|---|
| Jaunās vērtības | 0 | sortorder | 0 - (noklusējums) Augšā; 1 - Apakšā. |
|
| Rādīt laikspiedolu | 0 | show_timestamp | 0 - (noklusējums) Atspējots; 1 - Iespējots. |
|
| Rādīt kolonnas virsrakstu | 0 | show_column_header | 0 - Izslēgts; 1 - Horizontāli; 2 - (noklusējums) Vertikāli. |
|
| Laika periods | 1 | time_period._reference | DASHBOARD._timeperiod - iestatīt Laika perioda atlasītāju kā datu avotu;ABCDE._timeperiod - iestatīt saderīgu logrīku (ar tā Reference parametru iestatītu uz "ABCDE") kā datu avotu.Noklusējums: DASHBOARD._timeperiodAlternatīvi laika periodu var iestatīt tikai parametros No un Līdz. |
|
| No | 1 | time_period.from | Derīga laika virkne absolūtā (YYYY-MM-DD hh:mm:ss) vai relatīvā laika sintaksē (now, now/d, now/w-1w, u. c.).Parametra uzvedība: - atbalstīts, ja Laika periods nav iestatīts - obligāts, ja ir iestatīts time_period.to |
|
| Līdz | 1 | time_period.to | Derīga laika virkne absolūtā (YYYY-MM-DD hh:mm:ss) vai relatīvā laika sintaksē (now, now/d, now/w-1w, u. c.).Parametra uzvedība: - atbalstīts, ja Laika periods nav iestatīts - obligāts, ja ir iestatīts time_period.from |
|
Piemēri
Tālāk sniegto piemēru mērķis ir tikai aprakstīt paneļa logrīka lauku objektu konfigurāciju logrīkam Vienuma vēsture.
Plašāku informāciju par paneļa konfigurēšanu skatiet dashboard.create.
Vienuma vēstures logrīka konfigurēšana
Konfigurējiet Vienuma vēstures logrīku, kas attēlo jaunākos datus diviem skaitliskiem vienumiem "42269" un "42270". Papildus konfigurējiet vienumu kolonnas attēlošanai vertikāli, kolonnu nosaukumus attēlojot horizontāli; ierobežojiet attēlojumu līdz 15 datu rindām un iekļaujiet atsevišķu laikspiedola kolonnu.
{
"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
}Atbilde:
{
"jsonrpc": "2.0",
"result": {
"dashboardids": [
"3"
]
},
"id": 1
}