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
Tālāk norādītie parametri tiek atbalstīti logrīkam Vienumu vēsture.
| Parametrs | type | name | value |
|---|---|---|---|
| Atsvaidzināšanas intervāls | 0 | rf_rate | 0 - Bez 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. |
| Izkārtojums | 0 | layout | 0 - (noklusējums) Horizontāls; 1 - Vertikāls. |
| Kolonnas (skatīt zemāk) | |||
| Rādīt rindas | 0 | show_lines | Iespējamās vērtības ir diapazonā no 1 līdz 100. Noklusējums: 25. |
| Pārrakstīt hostu | 1 | override_hostid._reference | ABCDE._hostid - iestatīt saderīgu logrīku (ar tā parametru Atsauce, kas iestatīts uz "ABCDE") kā datu avotu hostiem;DASHBOARD._hostid - iestatīt paneļa hostu atlasītāju kā datu avotu hostiem.Šis parametrs netiek atbalstīts, ja logrīks tiek konfigurēts veidnes panelī. |
| Paplašinātā konfigurācija (skatīt zemāk) | |||
| Atsauce | 1 | reference | Jebkura virknes vērtība, kas sastāv no 5 rakstzīmēm (piemēram, ABCDE vai JBPNL). Šai vērtībai jābūt unikālai panelī, kuram pieder logrīks.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. |
Paplašinātā konfigurācija
Tālāk norādītie paplašinātās konfigurācijas parametri tiek atbalstīti logrīkam Vienuma vēsture.
| Parametrs | 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āli; 2 - (noklusējums) Vertikāli. |
|
| Laika periods | 1 | time_period._reference | DASHBOARD._timeperiod - iestatīt paneļa laika perioda atlasītāju kā datu avotu;ABCDE._timeperiod - iestatīt saderīgu logrīku (ar tā parametru Atsauce, 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 utt.).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 utt.).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
}