次の方法で共有

Activator の検出設定

  • [アーティクル]

この記事では、ルールを作成するときに使用できる検出設定の範囲について説明します。 Fabric Activator での検出設定の動作と、それらを効果的に構成する方法について説明します。 さまざまな検出設定が連携して、ユーザーが追跡しようとしているデータを正確に特定します。

この例では、パッケージ配信イベント イベントストリームを使用します。 このイベントストリームからは、"温度" という名前のオブジェクトと、ルール "薬には熱すぎる" を既に作成しています。

検出設定のオプション

検出設定は、Activator の右側に表示される [定義] ペインで管理します。 エクスプローラーからルールを選ぶか、[新しいルール] を選んで [定義] ペインを開きます。 ここで、[概要]、[フィルター]、[条件] を使って検出設定を設定します。

Activator で [定義] ペインを開いているスクリーンショット。

概要

概要は、ルールで使われる属性の集計 (平均、最小、合計など)、ウィンドウ サイズ、ステップ サイズで構成されます。 この例では、属性として Temperature オブジェクトを使います。 Temperature オブジェクトは、"パッケージ配信イベント" ストリームから取得されます。

[定義] ペインに [概要] セクションが表示されない場合は、[概要の追加] を選んで開きます。

概要を作成するときは、ルールの時間枠を指定します。 時間枠の範囲は 10 秒から 24 時間です。 概要は、各時間枠の間のルール プロパティの値をすべて取得し、時間枠に対して単一の概要値に変換します。 この例でのルールの概要は、属性 Temperature の平均集計です。

Temperature 属性が選択されている、[定義] ペインの [監視] セクションを示すスクリーンショット。

概要にはステップ サイズも含まれます。 ステップ サイズの範囲は 10 秒から 24 時間です。

概要の種類 説明
時間内での平均 その時間枠について、プロパティまたは列の平均値を計算します。
カウント その時間枠について、プロパティまたは列を含むイベントの数を計算します。
時間内の最小値/最大値 その時間枠の間の、プロパティまたは列の最小/最大値を計算します。
トータル その時間枠の間の、プロパティまたは列の合計値を計算します。

フィルター

フィルターでは、選んだ属性の比較操作を指定します。 フィルターは、比較条件を満たすイベントのみを保持します。 他のイベントはすべて、ルールの考慮から除外されます。 フィルター セクションを開くには、[定義] ペインから [フィルターの追加] を選びます。 フィルターと [操作] フィールドを表示するには、上にスクロールすることが必要な場合があります。

アクティベーター フィルターを使用するスクリーンショット。

任意の型の属性でフィルターを使用できます。 ただし、通常は、テキスト値でフィルターを使い、データのサブセットで条件を作成できるようにします。 たとえば、一部のパッケージ追跡イベントに "City=Redmond" というフィルターを設定して、Redmond のパッケージのイベントだけになるように条件を設定できます。 数値データにフィルターを設定することもできます。 この例では、60 を超える温度にフィルターを設定しました。

最大 3 つのフィルターを指定できます。

条件

3 番目の検出設定は条件です。 [条件] を使って、ルールをアクティブにするタイミングを Activator に伝えます。

アクティベーターの条件の種類を使用するスクリーンショット。

条件タイプは、次のカテゴリに分類されます。

条件タイプ 説明
Is 条件 "である" 条件は、条件が true のイベントごとにアクティブになります。
Becomes 条件 "なった" 条件は、条件が false になっていた後で true になった場合にのみアクティブになります。 たとえば、"10 より大きくなった" は、プロパティの値が 5 (10 より小) から 11 (10 より大) に変わった場合にアクティブになります。 条件が false から true になった場合にのみ、アクティブになります。
範囲に入る、範囲から外れる条件 "範囲に入る" 条件は、プロパティ値が定義された値範囲に入ったときにアクティブになります。 以前のプロパティの値が範囲外で、現在の値が範囲内にある場合にのみアクティブになります。 終了範囲の条件は似ていますが、プロパティ値が範囲外になるとアクティブになる点が異なります。
変更、「に変更」、「からの変更」 これらの条件は、条件が変わったとき、指定された境界内に変わったとき、または境界外に変わったときにアクティブになります。
含む、終わる、始まる などのテキストの状態 これらの条件は、テキストが選んだ条件を満たすとアクティブになります。
ハートビート条件 "データが存在しない" 条件は、データが Activator に到着しない場合にアクティブになります。 経過時間は、新しいデータが到着しないかどうかをルールで監視する時間です。

条件の種類を指定した後、発生条件を指定します。

発生条件は、ルールがアクティブになるために、条件が true になっている必要がある時間または回数を示します。

Timer 説明
毎回 条件が true であるたびにルールをアクティブにします。
回数 条件が true である回数をカウントし、指定した回数だけ true になったときにのみ、ルールをアクティブにします。
据え置き 指定した時間だけ条件が継続して true である場合、ルールをアクティブにします。

関連するコンテンツ

Microsoft Fabric の詳細についても確認してください。