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 Vienumu vēstures logrīkā.
| Parametrs | tips | nosaukums | vērtība |
|---|---|---|---|
| Atsvaidzināšanas intervāls | 0 | rf_rate | 0 - Neatsvaidzināt; 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 (skatiet tālāk) | |||
| Rādīt rindas | 0 | show_lines | Iespējamās vērtības ir no 1 līdz 100. Noklusējums: 25. |
| Ignorēt hostu | 1 | override_hostid._reference | ABCDE._hostid - iestatīt saderīgu logrīku (kura Atsauce parametram iestatīta vērtība "ABCDE") kā datu avotu hostiem;DASHBOARD._hostid - iestatīt informācijas paneļa hostu atlasītāju kā datu avotu hostiem.Šis parametrs netiek atbalstīts, ja logrīks tiek konfigurēts veidnes informācijas panelī. |
| Papildu konfigurācija (skatiet tālā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 ir jābūt unikālai informācijas panelī, kuram pieder logrīks.Parametra darbība: - obligāts |
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. |
|
Ja konfigurētais vienums ir rakstzīmju, teksta vai žurnāla tipa vienums, tiek atbalstīti tālāk norādītie kolonnu parametri.
| Parameter | 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. | |
| Rādīšana | 0 | columns.0.display | 1 - (noklusējums) Kā ir; 4 - HTML; 5 - Viena rinda. |
|
| Viena rinda | 0 | columns.0.max_length | Iespējamās vērtības ir no 1 līdz 500. Noklusējums: 100. Parametra darbība: - atbalstīts, ja Rādīšana ir iestatīta uz “Viena rinda” |
|
| 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 laika zīmogu; 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 laika zīmogu 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
}