メトリックベース ギャップトリガーの作成

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間:4分
  • メトリックベース ギャップトリガーを作成して、メトリックベース がデータの受信を停止したときに警告します。

    始める前に

    必要なロール:admin

    このタスクについて

    メトリックベース が指定された期間データの受信を停止すると、ギャップトリガーが実行されます。

    図 : 1. データ不足で実行されるギャップトリガー
    ギャップトリガーはデータベース内のデータが不足している場合に実行されます
    複数のトリガーレベルを定義して、さまざまな重大度を示すことができます。たとえば、10 分のギャップをレベル 1 として設定し、20 分のギャップをレベル 2 として設定することができます。レベルごとに異なる ワークフロースタジオ フローをトリガーする必要があります。異なるレベルのギャップ期間の差は、10 分以上である必要があります。たとえば、レベル 1 を 10 分のギャップに設定する場合、レベル 2 を 20 分以上のギャップに設定する必要があります。
    注:
    レベル間のギャップ期間を 10 分未満にすると、メトリックベース にエラーメッセージが表示され、追加したレベルが削除されます。

    ポーリング頻度は、さまざまなレベルのギャップ期間の差を 2 で除算して計算されます (切り捨て)。たとえば、以下であるとします。

    • レベル 1 は、データが不足している状態が 5 分続くとトリガーします
    • レベル 2 は、データが不足している状態が 30 分続くとトリガーします

    ポーリング頻度は 12 分です。Floor((30-5)/2) = 12 分 だからです。

    最大ポーリング頻度は 5 分ごと、最小頻度は 30 分ごとです。トリガーのレベルが 1 つしかない場合、ポーリング頻度は 30 分です。

    メトリックベース は、受信データではなく、メトリックベース データベースに格納されているデータを検索します。そのため、データが不足している場合、ギャップトリガーがギャップの後に実行されることがあります。たとえば、メトリックベース が 10 分ごとにポーリングし、そのギャップが 30 分データ不足の場合、データが最後に受信されてから 40 分後にトリガーが実行される可能性があります。

    手順

    1. 次のように移動する。 All (すべて) > MetricBase > ワークフロースタジオ > トリガー定義.
    2. [New (新規)] を選択します。
    3. メトリックベーストリガー作成フォームで、[ギャップトリガー] オプションを選択します。
    4. フォームのフィールドに入力します。
      トリガーレベルは、最初はこのフォームに表示されません。レベルは後で設定します。
      表 : 1. メトリックベースギャップトリガーフォーム
      フィールド 説明
      名前 トリガーの名前。
      テーブル名

      監視したいメトリクスが含まれている メトリックベース データベース内のテーブル。検索アイコンをクリックしたときに表示されるテーブルは、時系列メトリクスで指定したテーブルのみです。

      テーブルを選択する前にメトリクスを選択した場合、そのメトリクスを持つテーブルのみが [テーブル名] ダイアログボックスに表示されます。

      アクティブ トリガーを有効にするためのオプション。
      メトリクス

      監視したいテーブルメトリクス。[テーブル名] で指定します。検索アイコンをクリックしたときに表示されるメトリクスのみが、そのテーブルのメトリクスです。

      [テーブル名] を指定する前にメトリクスを選択した場合、時系列メトリクスのメトリクスがすべて表示されます。メトリクスを選択した後は、[テーブル名] の横にある検索アイコンをクリックすると、そのメトリクスを含むテーブルのみが表示されるようになります。

      説明 トリガーの説明。
    5. [保存] を選択します。
      新しいレコードが作成されます。
    6. 作成したレコードの [メトリックベース ギャップトリガーレベル] 領域で、各セルをダブルクリックし、トリガーパラメーターを指定する値を追加します。
      フィールド 説明
      レベル 重大度の増加を示す数字。たとえば、レベル 1 を 10 分間データなしと定義します。レベル 2 は 20 分間データがなしと定義します。レベルごとに異なるフローをトリガーする必要があります。レベルは、条件スクリプトでよく使用されます。「条件付きでトリガーを実行」を参照してください。
      関数 関数 [次の値以上] は、受信したデータのギャップが [期間] フィールドで指定した値より大きい場合に、このトリガーが実行されることを意味します。この関数のオプションは 1 つしかなく、空のままにすることはできません。空のままにすると、メトリックベース によりエラーメッセージが表示されます。
      ウィンドウ トリガーが実行される、データが受信されなかった時間の長さ。形式は、時:分:秒です。たとえば、00:20:00 は、このトリガーが 20 分間データが不足した後に実行されることを意味します。
    7. オプション: テーブルに行を追加して、マルチレイヤーのトリガー動作を作成します。
      通常、追加の各行 (レベル) はより重大な状態を示します。レベルに関連付けられた ワークフロースタジオ フローは、重大度が増すとともに警告を発します。
    8. [更新] を選択します。
    9. オプション: トリガーがワークフロースタジオのフローを実行するかどうかを決定するトリガー条件を追加します。
      条件付きでトリガーを実行」を参照してください。

    ギャップトリガーフォーム

    ギャップトリガーフォーム

    次のタスク

    このトリガーを ワークフロースタジオ フローに関連付けます。詳細については、「Assign a trigger to a flow (フローへのトリガーの割り当て)」を参照してください。