1 Foreach 関数

概要

foreach関数は、集計計算 で使用され、使用されている アイテム フィルター によって選択された各アイテムに対して 1 つの集計値を返します。値の配列が返されます。

たとえば、avg_foreach 関数は値の配列を返します。各値は、指定された時間間隔における、選択された項目の 平均 履歴値です。

アイテム フィルター構文は、foreach 関数で使用される構文の一部です。アイテム フィルターではワイルドカードの使用がサポートされているため、必要なアイテムを非常に柔軟に選択できます。

サポートされている関数

関数構文

Foreach functions support two common parameters: item filter (see details below) and time period: Foreach関数は、item filter (詳細は下記を参照) と time period という 2 つの共通パラメータをサポートしています。

foreach_function(item filter,time period)

例:

avg_foreach(/*/mysql.qps?[group="MySQL Servers"],5m)

MySQL サーバー グループ内の各 'mysql.qps' 項目の 5 分間の平均を返します。

一部の関数では追加の パラメータ がサポートされていることに注意してください。

アイテムフィルター構文

アイテムフィルター:

/host/key[parameters]?[conditions]

4 つの部分から構成されます:

• host - ホスト名
• key - アイテムキー(パラメータなし)
• parameters - アイテムキーのパラメータ
• conditions - ホストグループおよび/またはアイテムタグに基づく条件(式として)

スペースは条件式内でのみ許可されます。

ワイルドカードの使用

• ワイルドカードは、ホスト名、アイテムキー、または個々のアイテムキーパラメータを置き換えるために使用できます。
• ホストまたはアイテムキーのいずれかをワイルドカードなしで指定する必要があります。したがって、/host/* および /*/key は有効なフィルタですが、/*/* は無効です。
• ワイルドカードは、ホスト名、アイテムキー、アイテムキーパラメータの 一部 には使用できません。
• ワイルドカードは、1 つ以上のアイテムキーパラメータと一致しません。したがって、ワイルドカードはパラメータごとに分離して指定する必要があります (つまり、key[abc,*,*])。

条件式

条件式は以下をサポートします:

• 引数:
  • group - ホストグループ
  • tag - iアイテムタグ
  • "<text>" - string constant, with the \ escape character to escape " and \
• 大文字と小文字を区別する文字列比較演算子: =、<>
• 論理演算子: and、or、not
• 括弧によるグループ化: ( )

文字列定数の引用符は必須です。大文字と小文字を区別した完全な文字列比較のみがサポートされています。

例

次の例に示すように、アイテム キー、ホスト グループ、タグを参照する複雑なフィルターを使用することもできます:

参照されるすべてのアイテムが存在しデータが収集されている必要があります。有効なホスト上の有効なアイテムのみが計算に含まれます。

親ホストグループを指定すると、親グループと、そのアイテムを含むすべてのネストされたホスト グループが含まれます。

期間

2 番目の パラメータを使用すると、集計の期間を指定できます。期間は時間としてのみ表現でき、値の量 (# で始まる) はサポートされていません。

このパラメータでは、サポートされている単位記号を使用できます。たとえば、'300s'(300 秒) の代わりに'5m'(5分)、'86400'(86400秒)の代わりに'1d'(1日)などです。

last_foreach 関数で渡された場合、サーバーは時間を無視するため、省略できます。:

last_foreach(/*/key?[group="host group"])

exists_foreach 関数では期間はサポートされていません。

追加のパラメータ

3番目のオプションパラメータはbucket_rate_foreach関数でサポートされています:

bucket_rate_foreach(item filter,time period,<parameter number>)

where <parameter number> is the position of the "bucket" value in the item key. For example, if the "bucket" value in myItem[aaa,0.2] is '0.2', then its position is 2. ここで、<parameter number> は、アイテム キー内の"バケット"値の位置です。たとえば、myItem[aaa,0.2] 内の"バケット"値が '0.2' の場合、その位置は2です。

<parameter number> のデフォルト値は 1'です。

foreach 関数の使用に関する詳細と例については、集計計算を参照してください。

空き状況に応じた動作

次の表は、ホスト/アイテムおよびヒストリデータの可用性が制限されている場合に各関数がどのように動作するかを示しています。

アイテムが無視された場合、集計には何も追加されません。