Paragon Automation GUIでのカスタムルールの設定
Paragon Automation GUIを使用した新しいルールの作成
Paragon Automation GUIを使用して新しいルールを作成するには、まずルールに関する一般的な説明情報を入力し、次に[ルール]ページでいくつかのルール定義ブロックをナビゲートして、Paragon Automationルールの特定の設定を指定します。
新しいParagon Automationルールの作成を開始するには、次の手順に従います。
ルールのフィルタリング
[ルール] ページの左側に表示されるトピックとルールをフィルター処理できます。これにより、探しているルールをすばやく見つけることができます。検索機能は、トピック、ルール、センサータイプ、およびその他のカテゴリで機能します。タイトルだけでなく、ルールの定義内容にも取り組んでいます。
次の手順では、このフィルター処理機能について説明します。
センサー
Sensor ブロックを使用して、新しいルールの構成を開始します。図 2 に、OpenConfig センサーpppoe-error-statistics
のセンサー定義を示します。

フィールド
センサーは通常、デバイス上のインターフェイスに関するすべての情報、シャーシ関連情報、システム プロセスとメモリ関連情報などの情報を伝送します。センサーを構成した後、特定のニーズに合わせてセンサー情報を処理するフィールドを指定する必要があります。たとえば、インターフェイスの管理ステータスや運用ステータスをキャプチャするフィールドを定義したり、トラフィック数のしきい値を設定したりできます。
フィールドを追加するには:
受信データがタグ付けプロファイルで定義されたユーザー定義の条件を満たしているかどうかに基づいて、ルールにフィールドとキーを追加できます。タグ付けプロファイルは、Paragon Automationの左側のナビゲーションバーの [管理]>[取り込み設定 ]で定義されます。詳細については、Paragon Insightsのタグ付け を参照してください。
ベクトル
(オプション)これで、ルールにセンサーとフィールドが定義されたので、ベクトルを定義できます。
ベクトルは、1 つのフィールドに複数の値がある場合、または別のフィールドから値を受け取る場合に使用されます。
ベクトルの構文は次のとおりです。
vector <vector-name>{ path [$field-1 $field-2 .. $field-n]; filter <list of specific element(s) to filter out from vector>; append <list of specific element(s) to be added to vector>; }
変数
(オプション) 変数 ブロックは、関心のあるセンサーの部品を定義する場所です。たとえば、インターフェイスのスループットを監視するルールには、デバイスで使用可能なインターフェイスのリストから特定のインターフェイスを識別する方法が必要です。フィールドの詳細については、以下で説明します。
関数
(オプション)必要な関数を定義します。
Functions ブロックを使用すると、ユーザーは Python ファイルで関数を作成し、そのファイルで使用可能なメソッドを参照できます。Pythonファイルは、Paragon Automationの外部で作成する必要があります。メソッド名と引数は、関数を定義するときに必要になるため、知っておく必要があります。
Paragonオートメーションでは、Pythonユーザー定義関数を使用して複数の値を返すことができます。値は、データベース内の複数のフィールドに格納されます。
たとえば、3 つの戻り値を持つ関数example_function.pyがあるとします。ルールで example_function.py を呼び出すと、ユーザー定義関数 (UDF) の最初の戻り値が、関数を呼び出すルール フィールドに格納されます。設定する必要があるのは、 r2 残りの 2 つの戻り値に対して や r3などの戻りフィールドのみです。戻り値のこれらのフィールドは、[関数] タブの [戻り値の一覧] で構成できます。
時系列データベースでは、返品リスト・フィールドの名前の先頭には、UDF を使用するルール・フィールドの名前が付けられます。たとえば、 rule_field_name-r2 のようになります。
図 4 に、Functions ブロックの構成例を示します。

関数を設定するには:
トリガー
設定する必要があるルール定義の必須要素は、trigger 要素です。 図 5 に、ルールの Triggers ブロック system.memory/check-system-memory
を示します。フィールドの詳細については、以下で説明します。

トリガーの設定には、ポリシーの設定に使用する用語の作成が含まれます。トリガー内の用語が一致した場合、何らかのアクションが実行されます。用語は、ルール内で定義されたフィールド、関数、変数などを相互に評価したり、特定の値を探したりできます。用語は、用語リストの上部から下部の順に評価されます。一致するものが見つからない場合は、一致が見つかるまで、または用語スタックの一番下に達するまで、次の用語(存在する場合)が評価されます。
ルールのプロパティ
(オプション) [ルールのプロパティ] ブロックでParagon Automationルールのメタデータを指定します。使用可能なオプションは次のとおりです。
属性 |
説明 |
---|---|
バージョン |
Paragonオートメーションルールのバージョンを入力します。 |
貢献 |
ドロップダウン リストからオプションを選択します。 |
著者 |
有効な電子メール アドレスを指定してください。 |
日付 |
ポップアップカレンダーから日付を選択します。 |
サポートされているParagon Automationバージョン |
ルールが有効な最も古いParagon Automationリリースを指定します。 |
ジュニパーデバイス>サポートされるデバイス |
Junos または Junos Evolved のいずれかを選択します。デバイス メタデータには、製品名、リリース名、リリース サポート (ドロップダウン リスト)、およびプラットフォームが含まれます。複数のデバイス、デバイスごとに複数の製品、および製品ごとに複数のリリースのメタデータを追加できます。 サポートされているすべてのデバイスに適用する既定のセンサーを選択できます。また、ジュニパーデバイスや、特定のOSを実行するジュニパーデバイスに適用するデフォルトセンサーを選択することもできます。 |
サポートされているデバイス>他のベンダーのデバイス |
ジュニパー以外のベンダーについては、ベンダー識別子、ベンダー名、製品、プラットフォーム、リリース、およびオペレーティングシステム関連の情報を追加できます。 ジュニパー以外のすべてのデバイスに適用するデフォルトのセンサーを選択できます。 |
ヘルパー ファイル |
Paragon Automationルールで必要なファイルを指定します。 |
アクション前タスク
ルールでプレアクションタスクを設定する前に、アクションエンジンワークフローを設定する必要があります。アクション エンジン ワークフローを設定するには、「アクション エンジン ワークフローの管理 」を参照してください。
事前アクションタスクを設定するには:
-
[ルール] ページの [ 事前/事後のアクション ] タブをクリックします。
-
[プレアクション] セクションの [アクション エンジン] リストでアクション エンジン ワークフローを選択します。
-
デバイスリストから入力引数を入力します。
リストには、選択したアクションエンジンワークフローで以前にアクション前タスクとして設定した引数が表示されます。
-
Paragon Automationでデバイスグループ内の各デバイスで事前アクションタスクを1回だけ実行する場合は、一度だけ実行を有効にします。
-
次のいずれかの操作を行います。
-
「 保存 」をクリックして構成の変更を保存しますが、更新した構成はデプロイしません。このオプションは、たとえば、複数の変更を行っていて、後ですべての更新を同時に展開する場合に使用できます。
詳細については、 Paragon Insightsの設定変更のコミットまたはロールバック を参照してください。
-
「 保存して展開」 をクリックして、ルール構成を GUI に保存し、構成を展開します。
プレイブックにルールを含め、デバイスグループでプレイブックインスタンスを実行すると、Paragon Automationはテレメトリデータを取り込んでいる間にプレアクションタスクを実行します。
-
プレアクションタブに埋め込まれたアクションエンジンワークフローのステータスを監視できます。詳細については、「 アクションエンジンワークフローの管理 」を参照してください。
ポストアクションタスク
ルールでポストアクションタスクを設定する前に、アクションエンジンワークフローを設定する必要があります。アクション エンジン ワークフローを設定するには、「アクション エンジン ワークフローの管理 」を参照してください。
ポストアクションタスクを設定するには:
-
[ルール] ページの [ 事前/事後のアクション ] タブをクリックします。
-
[ポスト アクション] セクションで、[アクション エンジン] ボックスの一覧でアクション エンジンのワークフローを選択します。
-
デバイスリストから入力引数を入力します。
リストには、選択したアクション エンジン ワークフローでアクション後タスクとして以前に構成した引数が表示されます。
-
Paragon Automationでデバイスグループ内の各デバイスに対して1回だけアクション後処理タスクを実行する場合は、execute-onceを有効にします。
-
次のいずれかの操作を行います。
-
「 保存 」をクリックして構成の変更を保存しますが、更新した構成はデプロイしません。このオプションは、たとえば、複数の変更を行っていて、後ですべての更新を同時に展開する場合に使用できます。
詳細については、 Paragon Insightsの設定変更のコミットまたはロールバック を参照してください。
-
「 保存して展開」 をクリックして、ルール構成を GUI に保存し、構成を展開します。
プレイブックインスタンスを(このルールで)停止すると、Paragon Automationはプレイブックのサービスを停止した後にポストアクションタスクを実行します。
-
ポストアクションタブに埋め込まれたアクションエンジンワークフローのステータスを監視できます。詳細については、「 アクションエンジンワークフローの管理 」を参照してください。