Documentation
Table of Contents
1 Foreach funkci¨®k
?³Ù³Ù±ð°ì¾±²Ô³Ù¨¦²õ
A foreach f¨¹ggv¨¦nyek az [?sszes¨ªtett sz¨¢m¨ªt¨¢sokban] (/manual/config/items/itemtypes/calculated/aggregate) egy ?sszes¨ªtett ¨¦rt¨¦ket adnak vissza minden kiv¨¢lasztott elemhez. a haszn¨¢lt cikksz?r? ²õ±ð²µ¨ª³Ù²õ¨¦²µ¨¦±¹±ð±ô.
P¨¦ld¨¢ul az avg_foreach f¨¹ggv¨¦ny az ¨¢³Ù±ô²¹²µ´Ç²õ ¨¦rt¨¦ket adja vissza az egyes kiv¨¢lasztott elemek el?zm¨¦nyeib?l a megadott id?intervallumban.
Az item filter a foreach f¨¹ggv¨¦nyek ¨¢ltal haszn¨¢lt szintaxis r¨¦sze. A helyettes¨ªt? karakterek haszn¨¢lata az elemsz?r?ben t¨¢mogatott, ¨ªgy a sz¨¹ks¨¦ges elemek meglehet?sen rugalmasan kiv¨¢laszthat¨®k.
T¨¢mogatott funkci¨®k
| ¹ó³Ü²Ô°ì³¦¾±¨® | ³¢±ð¨ª°ù¨¢²õ |
|---|---|
| avg_foreach | Az egyes elemek ¨¢³Ù±ô²¹²µ´Ç²õ ¨¦rt¨¦k¨¦t adja vissza. |
| A a <±è²¹°ù²¹³¾¨¦³Ù±ð°ùsz¨¢m> ±è²¹°ù²¹³¾¨¦³Ù±ð°ù. | |
| count_foreach | Az egyes elemekhez tartoz¨® ¨¦rt¨¦kek sz¨¢m¨¢t adja vissza. |
| exists_foreach | A jelenleg enged¨¦lyezett elemek sz¨¢m¨¢t adja vissza. |
| last_foreach | Az egyes elemek utols¨® ¨¦rt¨¦k¨¦t adja vissza. |
| max_foreach | Az egyes elemek maxim¨¢lis ¨¦rt¨¦k¨¦t adja vissza. |
| min_foreach | Az egyes elemek minim¨¢lis ¨¦rt¨¦k¨¦t adja vissza. |
| sum_foreach | Az egyes elemek ¨¦rt¨¦keinek ?sszeg¨¦t adja vissza. |
F¨¹ggv¨¦ny szintaxis
A Foreach f¨¹ggv¨¦nyek k¨¦t ¨¢ltal¨¢nos ±è²¹°ù²¹³¾¨¦³Ù±ð°ùt t¨¢mogatnak: az "elemsz?r?" (r¨¦szleteket l¨¢sd al¨¢bb) ¨¦s az "id?szak":
±Ê¨¦±ô»å¨¢³Ü±ô:
avg_foreach(/*/mysql.qps?[group="MySQL Servers"],5m)
visszaadja a MySQL szervercsoport minden egyes 'mysql.qps' elem¨¦nek ?tperces ¨¢tlag¨¢t.
Vegye figyelembe, hogy egyes f¨¹ggv¨¦nyek tov¨¢bbi [±è²¹°ù²¹³¾¨¦³Ù±ð°ùeket] (#additional_parameters) t¨¢mogatnak.
Elemsz?r? szintaxis
Az elemsz?r?:
n¨¦gy r¨¦szb?l ¨¢ll, ahol:
- host - gazdag¨¦p neve
- kulcs - elemkulcs (±è²¹°ù²¹³¾¨¦³Ù±ð°ùek n¨¦lk¨¹l)
- ±è²¹°ù²¹³¾¨¦³Ù±ð°ùek - elem kulcs±è²¹°ù²¹³¾¨¦³Ù±ð°ùei
- felt¨¦telek ¨C gazdag¨¦pcsoport ¨¦s/vagy elemc¨ªmke alap¨² felt¨¦telek (kifejez¨¦sk¨¦nt)
Sz¨®k?z?k csak a felt¨¦telek kifejez¨¦sen bel¨¹l megengedettek.
Jelent?s karakter haszn¨¢lat
- Helyettes¨ªt? karakterrel helyettes¨ªthet? a gazdag¨¦p neve, az elemkulcs vagy egy egyedi elemkulcs ±è²¹°ù²¹³¾¨¦³Ù±ð°ù.
- A gazdag¨¦p vagy az elem kulcs¨¢t helyettes¨ªt? karakter n¨¦lk¨¹l kell megadni. Teh¨¢t a
/host/*¨¦s a/*/key¨¦rv¨¦nyes sz?r?k, de a/*/*¨¦°ù±¹¨¦²Ô²â³Ù±ð±ô±ð²Ô. - A helyettes¨ªt? karakter nem haszn¨¢lhat¨® a gazdag¨¦pn¨¦v, az elemkulcs, az elemkulcs ±è²¹°ù²¹³¾¨¦³Ù±ð°ù °ù¨¦²õ³ú¨¦³ó±ð³ú.
- A helyettes¨ªt? karakter nem felel meg t?bb mint egyetlen elem kulcs±è²¹°ù²¹³¾¨¦³Ù±ð°ù¨¦nek. Teh¨¢t minden elv¨¢laszt¨¢si ±è²¹°ù²¹³¾¨¦³Ù±ð°ùhez meg kell adni egy helyettes¨ªt? karaktert (azaz
kulcs[abc,*,*]).
Felt¨¦telek kifejez¨¦se
A felt¨¦telek kifejez¨¦s t¨¢mogatja:
- operandusok:
- csoport - fogad¨® csoport
- tag - elemc¨ªmke
"<sz?veg>"- karakterl¨¢nc-¨¢lland¨®, az\escape karakterrel a"¨¦s a\escape karakterrel
- kis- ¨¦s nagybet?k karakterl¨¢nc-?sszehasonl¨ªt¨® oper¨¢torai:
=,<> - logikai oper¨¢torok: "¨¦s", "vagy", "nem".
- csoportos¨ªt¨¢s z¨¢r¨®jelekkel:
()
A karakterl¨¢nc-konstansok id¨¦z¨¦se k?telez?. Csak a kis- ¨¦s nagybet?k k?z?tti teljes karakterl¨¢nc-?sszehasonl¨ªt¨¢s t¨¢mogatott.
±Ê¨¦±ô»å¨¢°ì
?sszetett sz?r? haszn¨¢lhat¨®, amely hivatkozik az elemkulcsra, a gazdag¨¦pcsoportra ¨¦s c¨ªmk¨¦k, amint azt a p¨¦ld¨¢k illusztr¨¢lj¨¢k:
| Szintaxis p¨¦lda | ³¢±ð¨ª°ù¨¢²õ |
|---|---|
/host/key[abc,*] |
Hasonl¨® elemekkel egyezik meg ezen a gazdag¨¦pen. |
/*/key |
B¨¢rmely gazdag¨¦p ugyanazon elem¨¦nek felel meg. |
/*/key?[group="ABC" and tag="tagname:value"] |
Megegyezik az ABC csoport b¨¢rmely gazdag¨¦p¨¦nek ugyanazon elem¨¦vel, amely 'tagname:value' c¨ªmk¨¦kkel rendelkezik. |
/*/key[a,*,c]?[(group="ABC" and tag="Tag1") vagy (group="DEF" and (tag="Tag2" or tag="Tag3:value") ))] |
Az ABC vagy DEF csoport b¨¢rmely gazdag¨¦p¨¦nek hasonl¨® elemeit egyezteti a megfelel? c¨ªmk¨¦kkel. |
Minden hivatkozott elemnek l¨¦teznie kell, ¨¦s adatokat kell gy?jtenie. Csak az enged¨¦lyezett elemek bekapcsolva az enged¨¦lyezett gazdag¨¦pek szerepelnek a sz¨¢m¨ªt¨¢sokban.
Ha egy hivatkozott elem t¨¦telkulcsa megv¨¢ltozik, a sz?r?t manu¨¢lisan kell friss¨ªteni.
A sz¨¹l? gazdag¨¦pcsoport megad¨¢sa mag¨¢ban foglalja a sz¨¹l?csoportot ¨¦s az ?sszes be¨¢gyazottat csoportokat fogadni t¨¢rgyaikkal.
Id?szak
A second ±è²¹°ù²¹³¾¨¦³Ù±ð°ù lehet?v¨¦ teszi az id?tartam megad¨¢s¨¢t ?sszes¨ªt¨¦s¨¦t. Az id?tartam csak id?vel, mennyis¨¦ggel fejezhet? ki ¨¦rt¨¦kek k?z¨¹l (# el?taggal) nem t¨¢mogatott.
[T¨¢mogatott m¨¦rt¨¦kegys¨¦g-szimb¨®lumok] (/k¨¦zik?nyv/mell¨¦klet/ut¨®tagok) haszn¨¢lhat¨®k ebben ±è²¹°ù²¹³¾¨¦³Ù±ð°ùt a k¨¦nyelem kedv¨¦¨¦rt, p¨¦ld¨¢ul ?5m¡± (?t perc) helyett ?300s¡± (300 m¨¢sodperc) vagy ?1d¡± (egy nap) a ?86400¡± (86400) helyett m¨¢sodperc).
A kiszolg¨¢l¨® figyelmen k¨ªv¨¹l hagyja az id?tartamot, ha a last_foreach ±è²¹°ù²¹³¾¨¦³Ù±ð°ùrel adja meg funkci¨®t, ez¨¦rt elhagyhat¨®:
Az id?tartam nem t¨¢mogatott a exists_foreach ´Ú¨¹²µ²µ±¹¨¦²Ô²â²ú±ð²Ô.
Tov¨¢bbi ±è²¹°ù²¹³¾¨¦³Ù±ð°ùek
A harmadik opcion¨¢lis ±è²¹°ù²¹³¾¨¦³Ù±ð°ùt a bucket_rate_foreach t¨¢mogatja funkci¨®:
ahol <±è²¹°ù²¹³¾¨¦³Ù±ð°ùsz¨¢m> a "v?d?r" ¨¦rt¨¦k¨¦nek poz¨ªci¨®ja a t¨¦tel kulcs¨¢t. P¨¦ld¨¢ul ha a myItem[aaa,0.2] "v?d?r" ¨¦rt¨¦ke a k?vetkez? '0,2', akkor a poz¨ªci¨®ja 2.
A <±è²¹°ù²¹³¾¨¦³Ù±ð°ùsz¨¢m> alap¨¦rtelmezett ¨¦rt¨¦ke '1'.
L¨¢sd: [?sszes¨ªtett sz¨¢m¨ªt¨¢sok] (/manual/config/items/itemtypes/calculated/aggregate) tov¨¢bbi r¨¦szletek ¨¦s p¨¦ld¨¢k a foreach f¨¹ggv¨¦nyek haszn¨¢lat¨¢r¨®l.
Behavior depending on availability
The following table illustrates how each function behaves in cases of limited availability of host/item and history data.
| Function | Disabled host | Unavailable host with data | Unavailable host without data | Disabled item | Unsupported item | Data retrieval error (SQL) |
|---|---|---|---|---|---|---|
| avg_foreach | ignore | return avg | ignore | ignore | ignore | ignore |
| bucket_rate_foreach | ignore | return bucket rate | ignore | ignore | ignore | ignore |
| count_foreach | ignore | return count | 0 | ignore | ignore | ignore |
| exists_foreach | ignore | 1 | 1 | ignore | 1 | n/a |
| last_foreach | ignore | return last | ignore | ignore | ignore | ignore |
| max_foreach | ignore | return max | ignore | ignore | ignore | ignore |
| min_foreach | ignore | return min | ignore | ignore | ignore | ignore |
| sum_foreach | ignore | return sum | ignore | ignore | ignore | ignore |
If the item is ignored, nothing is added to the aggregation.