周波数プロファイルとオフセット時間
周波数プロファイル
周波数プロファイルは、センサーとルールの時間周波数を管理できる中心的な場所です。周波数プロファイルを理解するには、次の点を考慮してください。
Paragon Insights(旧HealthBot)でルールを定義する場合、以下を行うことができます。
同じセンサーを使用する複数のルールを定義する
ルールごとに異なるセンサー周波数を定義する
これらのルールをすべて同じデバイスグループ/デバイスに適用します
これにより、個々のルール内でのルールの適用と頻度調整が複雑になります。
OpenConfigおよびネイティブGPBセンサーのセンサーパス、またはiAgentセンサーのファイルとテーブルのタプルで構成されるキーは、特定のルールを識別するために使用されます。
Paragon Insightsは、適用されたルールからそのセンサーに定義された最小周波数を取得し、それを使用してデバイスからデータをサブスクライブまたはフェッチします。
これにより、そのセンサーのデータレートを特定するのが難しくなります。これを行うには、適用されているすべてのルールを確認する必要があります。
適用されたルールのセンサー周波数の変更は、意図したとおりに反映されない場合があります。
このような複雑さに対処するために、Paragon Insightsには、これらの周波数を制御するための共通の場所が必要でした。
HealthBotリリース3.0.0以降、周波数プロファイルを作成して、センサーとルールの周波数を1か所から管理し、Paragon Insightsのさまざまな場所でそのプロファイルを適用できるようになりました。これらのプロファイルを適用することで、ルール、センサー、トリガー、数式、リファレンス、学習期間、ホールドタイムの頻度に関して、永続的で反復可能な動作が可能になります。
センサー プロファイルは、プロファイル名と 2 つのオプション セクション (センサー セクションと非センサー セクション) で構成されます。各セクションのエントリは、センサーまたはルールの名前と頻度で構成されます。周波数プロファイルは、デバイスグループまたはネットワークグループに適用されます。
設定手順を以下に示します。
- Paragon Insights GUIを使用した設定
- Paragon InsightsCLIを使用した設定
- Paragon InsightsGUIを使用した周波数プロファイルの適用
- Paragon InsightsCLIを使用した周波数プロファイルの適用
Paragon Insights GUIを使用した設定
周波数プロファイルは、Paragon Insights GUIまたはParagon Insights CLIで設定および管理されます。GUIでは、[ 設定]>[取り込み設定 ]ページに移動し、ページの左側から [周波数プロファイル ]タブを選択することで管理されます。
周波数プロファイルのセクションはどちらもオプションですが、適用されたプロファイルで何かを実行できるようにするには、周波数プロファイルごとに少なくとも1つのセクションに入力する必要があります。
Add a Frequency Profile
追加(+)アイコンをクリックしてプロファイルを追加します。
周波数プロファイルの追加ウィンドウが表示されます。
プロファイルに次のような名前を付けます。
Profile1
追加(+)アイコンをクリックしてセンサーを追加します。
[センサー名] フィールドに、次のガイドラインに従ってセンサー名を入力します。
OpenConfig センサー: 目的のセンサーの OpenConfig パスを入力します (
/components
/interfaces
や など)。iAgent センサー: センサー定義で使用するテーブル名を入力します (
ChassisAlarmTable
または など)REutilizationTable
SNMP: センサー名などを入力します。
npr_qmon_ext
BYOI: <topic-name//>
topic1
と入力します (例: //rule-namesensor-namerule1
sensor1
[頻度] フィールドに、、
30seconds
1minute
、2hours
などの適切な頻度を入力します。(オプション) 追加(+) アイコンをクリックして、非センサーを追加します。
[ルール名] フィールドに、 などの
check-chassis-alarms
ルール名を入力します。[頻度] フィールドに、、
45seconds
3minutes
、1hour
などの適切な頻度を入力します。必要に応じて、プロファイルに対して手順 3 から 5 または 6 から 8 を繰り返します。
[SAVE & DEPLOY] ボタンをクリックして、プロファイルを保存して展開します。
新しいセンサー プロファイルがリストに追加されます。
Edit a Frequency Profile
既存の周波数プロファイルを編集するには:
[周波数プロファイル] タブをクリックして、[周波数プロファイル] ページを表示します。
変更する< Profile Name>を選択します。
編集(鉛筆)アイコンをクリックして、プロファイルを編集します。
[周波数プロファイルの編集(Edit Frequency Profilation)] ページが表示され、周波数プロファイルを追加したときと同じフィールドが表示されます。
パラメータを変更します。
後で展開するためにプロファイルを保存するには [保存 ] ボタンをクリックするか、すぐに保存して展開するには [保存 & DEPLOY ] ボタンをクリックします。
Delete a Frequency Profile
周波数プロファイルを削除するには:
左側のナビゲーション バーで [ 設定 ] > [ 取り込み ] をクリックします。
[取り込み設定] ページが表示されます。
[周波数プロファイル]タブをクリックして、[周波数プロファイル]ページを表示します。
削除する周波数プロファイルを選択し、 削除(ゴミ箱) アイコンをクリックします。
「周波数プロファイルの削除を確認」ポップアップが表示されます。
図1:削除頻度プロファイル ポップアップの確認次のいずれかの操作を行います。
[ はい ] をクリックして、データベースから周波数プロファイルを削除します。ただし、変更は取り込みサービスには適用されません。
メモ:現在使用中の周波数プロファイルは削除しないことをお勧めします。
データベースから周波数プロファイルを削除すると、変更を展開していなくても、その周波数プロファイルを別のデバイス グループに適用することはできません。
また、[ 保留中の構成 ] ページから、取り込みサービスへの変更をデプロイしたり、既に削除した変更をロールバックしたりすることもできます。詳細については、 Paragon Insightsの設定変更のコミットまたはロールバックを参照してください。
「変更を デプロイ 」チェック・ボックスを選択し、「 はい 」をクリックしてデータベースから頻度プロファイルを削除し、変更をインジェスト・サービスに適用します。
(オプション)この操作をキャンセルするには、[ いいえ ] をクリックします。
Clone a Frequency Profile
周波数プロファイルのクローンを作成するには:
[周波数プロファイル] タブをクリックして、[周波数プロファイル] ページを表示します
複製する< Profile Name>を選択し、ページの右上隅にある [ 複製 ] ボタンをクリックします。
[クローン頻度プロファイル]ページが表示されます。
クローン・プロファイルの適切な名前を指定します。
[ OK] をクリックして変更を保存します。
プロファイルのクローンが作成され、[周波数プロファイル] ページに一覧表示されます。
Usage Notes:
プロファイル エントリ:各セクションで複数のエントリを設定できます。
上書き - 適用された周波数プロファイル内で定義されたセンサーまたはルールの頻度は、個々のルールまたはセンサー内で定義されたものを上書きします。
優先順位 - センサーまたはルールが複数の周波数プロファイルで定義され、それぞれ異なる周波数設定を持つ場合、センサーまたはルールの最小周波数値が使用されます。
Paragon InsightsCLIを使用した設定
Paragon Insights CLIでは、上記と同じ周波数プロファイルを設定できます。上記の例を完了するために必要なCLI設定の例は、以下のようになります。
user@mgd-69ab987fbc6-pt9sh> show configuration healthbot ingest-settings frequency-profile Profile1 sensor /components { frequency 60seconds; } sensor /interface { frequency 30seconds; } non-sensor net-topic/net-rule { frequency 2minutes; }
Paragon InsightsGUIを使用した周波数プロファイルの適用
周波数プロファイルは、Paragon Insightのデバイスグループまたはネットワークグループに適用されます。デバイスまたはネットワークグループを作成または編集するときは、デバイスグループ定義の[取り込み頻度]セクションから周波数プロファイルを選択して適用します。下の図2は、デバイスグループに適用される周波数プロファイルの例を示しています。
必要なプロファイルを適用したら、 SAVE & DEPLOY ボタンを使用してデバイス グループを保存して展開します。
周波数プロファイルは、 オフセット時間単位 機能を使用するルールにのみ適用することを強くお勧めします。
Paragon InsightsCLIを使用した周波数プロファイルの適用
周波数プロファイルを含み、Paragon Insightsで導入できるデバイスグループのCLI設定の例を以下に示します。
user@mgd-69ab987fbc6-pt9sh> show configuration healthbot device-group lab-group devices router1; ingest-frequency Profile1;
オフセット時間単位
Paragon Insights(旧HealthBot)オフセット時間単位は、 頻度プロファイル と組み合わせて使用され、Paragon Insightsルール内のさまざまな場所で時間範囲の計算を自動的に管理します。Paragon Insightsのオフセット機能を理解するために、以下のシナリオを考えてみましょう。
Paragon Insightsでは、次のようなルールを定義できます。
センサーを使用して10秒の頻度でデータを収集します
60 秒ごとに平均を計算するフィールドがあります
後でセンサーの周波数を60秒に増やすことにした場合、60秒ごとに平均を計算しても意味がありません。その結果、センサーの周波数を変更したいときはいつでも、フィールド計算を手動で更新する必要があります。
HealthBot リリース 3.0.0 以降、平均計算の時間範囲を 60 秒または 60 秒ではなく、6o または 6offset の値に設定できます。静的な時間値ではなくオフセット時間値を使用すると、Paragon Insightsはセンサーの周波数にオフセットの数値を自動的に乗算します。したがって、センサー周波数の変更は、数式の時間範囲計算に自動的に含まれます。
オフセット時間単位は、次の時間範囲の場所で標準時間単位の代わりに使用できます。
数式
参照
ベクトル
トリガ周波数
トリガー期間
以下では、上記の各場所でオフセット時間単位を設定する方法のGUIとCLIの例について説明します。
数式で使用されるオフセット
この例では、センサー Sensor1を使用してルール Rule1を作成します。センサーの周波数は10秒に設定されています。
下の 図 3 では、Rule1 の Fields ブロック定義と Sensors ブロック定義が緑色で囲まれています。数式 formula1、 の 時間範囲 の値は 2o
同じフィールドの CLI 形式の設定スニペットは次のようになります。
user@mgd-97bb5d555-sw87n$ show healthbot topic external rule rule1 synopsis "This rule is used only to demonstrate various rule features and concepts"; description "Demonstration Rule"; sensor Sensor1 { open-config { sensor-name /interfaces; frequency 10s; } } field field1 { constant { value 833; } type integer; } field formula1 { formula { max { field-name "$field1"; time-range 2o; } } type integer; }
Usage Notes for Offset Used in Formulas
数式の時間範囲に適用されるオフセット値は、そのルールのルール、センサー、またはトリガー頻度を乗算します。
この例の結果、Max 式の時間範囲は、頻度の 10 秒の 2 倍 Sensor1 、つまり 20 秒 (2 * 10s = 20 秒) になりました。
この例で使用されているルールに 30 秒の周波数プロファイルを適用した場合、結果の時間範囲は 60 秒(2 * 30s = 60s)になります。
オフセット時間は、最新、カウント、最小、最大、合計、平均、変化時、および標準偏差の式に適用できます。
参照で使用されるオフセット
この例では、2 つのルールが使用されていますが、1 つだけが表示されています。ルーティングエンジンのトピックにないルールRule1は、ルーティングエンジン(ルーティングエンジン/ルーティングエンジン)という名前が付けられています。ルール 1 の頻度は 20 秒です。ルール 1 が参照されます。
図 4 に示す Rule2 は、ref1 という名前の参照フィールドを持つネットワーク ルールです。フィールド ref1 は、時間範囲設定が 3offset の参照 XPath 式を使用して Rule1 を参照します。
Usage Notes for Offset Used in References
参照で使用されるオフセット値には、参照されるルールの頻度にオフセット値が乗算されます。この場合、Rule1 の 20 秒の周波数に 3 が掛けられ、60 秒の時間範囲 (3 * 20s = 60s) になります。
60 秒 (60 秒) の周波数プロファイルが Rule1 に適用された場合、参照の時間範囲は 180 秒 (3 * 60 秒 = 180 秒) に増加します。
ベクトルで使用されるオフセット
この例では、3つのルールが関係しています。ルール Rule1 と Rule2 は表示されていませんが、ベクトルによって参照されています。
ルール 1 はトピックのラインカードにあり、ラインカード(ラインカード/ラインカード)と呼ばれ、20 秒(20 秒)の頻度があります。
Rule2 はトピックルーティングエンジンにあり、ルーティングエンジン(ルーティングエンジン/ルーティングエンジン)と呼ばれ、頻度は30秒(30秒)です。
以下の ルール3 では、2つのパス参照と1つのフィールドで構成されるベクトル vector1 を定義しています。ベクトルには、3offset として定義された 時間範囲 があります。 図5 は、Paragon Insights GUIでのベクトルブロックの定義を示しています。
Usage Notes for Offset Used in Vectors
ベクトルの時間範囲で定義されたオフセット値は、参照されるルールまたはセンサーのセンサーまたはルール頻度を乗算します。同じルールのフィールドが参照として使用される場合は、ベクトルを含むルールの頻度が使用されます。
ベクトルに複数の参照またはフィールドが定義されていて、オフセット時間を使用する場合、オフセット値は各パスに個別に適用されます。したがって、オフセット値が3(3offset)であるこの例では、次のようになります。
ルール 1 へのパス参照: "/device-group[device-group-name='Core4']/device[device-id='R1']/topic[topic-name='line-cards']/rule[rule-name='line-cards']/memory" の頻度が 20 秒の場合、ベクトルの時間範囲は 60 秒になります (3 * 20s = 60s)。
Rule2 へのパス参照: "/device-group[device-group-name='Core4']/device[device-id='R1']/topic[topic-name='routing-engine']/rule[rule-name='routing-engine']/field[slot='0']/ref1" の頻度が 30 秒の場合、ベクトルの時間範囲は 90 秒になります (3 * 30s = 90s)。
メモ:パス参照にスペースや改行はありません。これらは、読みやすくするためにのみこのドキュメントに追加されています。
フィールド参照
formula1
: はベクトルブロック内で使用される通常のフィールドであるためformula1
、現在のルールのルール頻度がベースとして使用されます。したがって、のformula1
時間範囲は30秒(3 * 10秒= 30秒)です。
60 秒の周波数プロファイルが Rule1(ラインカード/ラインカード)に適用された場合、ベクトル内のそのパスの時間範囲は 180 秒(3 * 60s = 180s)になります。
120 秒の周波数プロファイルが Rule2(ルーティング エンジン/ルーティング エンジン)に適用された場合、ベクトル内のそのパスの時間範囲は 360 秒(3 * 120s = 360 s)になります。
フィールド参照の時間範囲である は、
formula1
ルール 3 に変更が加えられるか、異なる時間の周波数プロファイルがルール 3 に適用されない限り、以前と同じ 30 秒のままになります。
トリガーで使用されるオフセット
この例では、Rule1 という 1 つのルールがあります。下の 図6 は、センサーブロックの定義が緑色の境界線でオーバーレイされたトリガーブロックの定義を示しています。
ルール Rule1 には、10 秒 (10 秒) のセンサー頻度が適用されています。
トリガー自体 Trigger1 には、2 (2o) のオフセット周波数が適用されています。
トリガー項 であるterm1には、独自の時間範囲オフセット2(2o)も適用されます。
Usage Notes for Offset Time Used in Triggers
トリガー周波数で定義されたオフセット値は、センサーまたはルールの周波数を乗算します。したがって、 trigger1 のオフセット値が 2 の場合、ルールのセンサー周波数が基準として使用されるため、トリガー周波数は 20 秒 (2 * 10s = 20s) と解釈されます。
トリガー項で定義されたオフセット値は、トリガー周波数値を乗算します。したがって、 term1 のオフセット値が 2 の場合、項の頻度は 40 秒(2 * 20s = 40s)と解釈されます。
トリガ参照で使用されるオフセット
この例では、外部トピックに2つのルールがあり、1つの周波数プロファイル prof1があります。
ルールは次のとおりです。
外部/テスト: テスト ルールには、センサー パスが /components で、センサー頻度が 10 秒の OpenConfig センサーである components という名前のセンサーがあります。
また、2oまたは2offsetの周波数を持つ トリガーtrig1 もあります。トリガーには Term_1 という名前の用語がありますが、この例では使用されていません。
external/ref: ref ルールは非センサー ルールであり、ルールは参照フィールド trigger_reference を使用して、別のルールで定義されたセンサーを参照します。この場合 は外部/テストです。
周波数プロファイルは次のとおりです。
prof1: prof1 プロファイルは、 /components センサーの周波数を 30 秒に設定します。