15 Vienuma 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
Tālāk norādītie parametri ir atbalstīti Item history logdaļai.
| 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 logdaļu (ar tās Reference parametru, kas iestatīts 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 logdaļu 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 logdaļa.Parametra darbī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 Vienuma vēstures sīkrī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 galveni | 0 | show_column_header | 0 - Izslēgts; 1 - Horizontāls; 2 - (noklusējums) Vertikāls. |
|
| Laika periods | 1 | time_period._reference | DASHBOARD._timeperiod - iestatīt Laika perioda atlasītāju kā datu avotu;ABCDE._timeperiod - iestatīt saderīgu sīkrīku (ar tā Reference parametru, kas iestatīts 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 darbī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 darbī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
}