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ā.
| Parameter | 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 (skatiet tālāk) | |||
| Rādīt līnijas | 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 (ar tā Atsauces parametru iestatītu uz "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. |
|
Tiek atbalstīti tālāk norādītie kolonnu parametri, ja konfigurētais vienums ir rakstzīmju, teksta vai žurnāla tipa vienums.
| 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. | |
| Attēlojums | 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 Attēlojums ir iestatīts uz “Viena rinda” |
|
| Izmantot vienplatuma fontu | 0 | columns.0.monospace_font | 0 - (noklusējums) Izmantot noklusējuma fontu; 1 - Izmantot vienplatuma fontu. |
|
| Attēlot vietējo laiku | 0 | columns.0.local_time | 0 - (noklusējums) Attēlot laika zīmogu; 1 - Attēlot vietējo laiku. Parametra darbība: - atbalstīts, ja vienums ir iestatīts uz žurnāla tipa vienumu 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. |
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
}