Neuron ワークフロービルダー

Ivanti Neurons (機能) は非推奨となり、新しい Ivanti Neurons Bots エクスペリエンスに置き換えられます。詳細については、「Neurons Bots への移行」をご参照ください。

Neuron ワークフローは、さまざまなビジネスプロセスを自動化するために設計された一連の関連付けられたステージから構成され、洞察を発見して提供し、アクションを実行するために使用できます。 Neuron ビルダーを使用すると、カスタム Neuron ワークフローを最初から作成するか、構築済みのワークフローを編集して、ビジネスニーズに合わせてカスタマイズできます。

Neuron 設定

Neuron 設定パネルを使用して、Neuron ワークフローを構成します。使用できる設定は、Neuron のタイプに依存します。

マイステージ

左側の [マイステージ] パネルには、既定およびインストール済みのステージがすべて含まれています。ステージには、いくつかのカテゴリがあります。

追加のクエリと処理はライブラリにあり、[ステージ] に追加されます。ライブラリの詳細については、「Neurons (機能)」をご参照ください。

クエリ: 特定の条件を満たすデバイスからの情報の提示やフィルタリングに使用します。たとえば、空きディスク領域が10% 未満のデバイスを表示します。このクエリステージからの出力とコンテキストは、Neuron ワークフローの後続のステージを通過できます。それぞれのクエリに、結果が返されなかった場合に Neuron の動作を制御できるようにする設定が含まれます。既定では、[結果が返された場合にのみ Neuron を続行する] が選択されています。つまり、オンラインデバイスから結果が返されない場合は、Neuron ワークフローはそれ以上進みません。このチェックボックスをオフにすると、Neuron ワークフローは引き続き進行します。これは、たとえば、問題が見られなかった場合に肯定的確認を得るためのアラートを発行する場合などに役立つ可能性があります。
処理: 処理ステージでは自動化ファブリックを利用して、ユーザデバイスで電子メールの送信やカスタム PowerShell の実行といった処理を実行します。変数の使用が可能なアクションもあります。詳細については、「変数」をご参照ください。
共通: 次のものがあります。:
- 結果のフィルタリング: フィルタプロパティの定義に従い、取り込まれたクエリ情報をフィルタリングします。詳細については、フィルタをご参照ください。
- Neurons アラート: Neurons のホームページにアラートを生成するように設計されています。
カスタム: Bash 処理、カスタム JavaScript、PowerShell 処理およびクエリ、osquery を活用して、カスタム処理とクエリを作成できます。 [ライブラリ] > [ステージエディタ] で作成されたカスタムステージは、インストールされた後にここに表示されます。

osquery と PowerShell の使用方法の例については、「Neuron ワークフローの高度な例」をご参照ください。

ワークスペース

ステージをワークスペースまでドラッグすると、Neuron ワークフローが作成されます。ステージをクリックすると、次のオプションが表示されます。

クリックして、ステージを Neuron から削除します。

クリックして、別のステージへのコネクタを追加kします。

クリックして、ステージ間の接続を切断します。

ステージ設定

ステージをワークスペースにドラッグし、ハイライト表示されると、[ステージ設定] パネルが開きます。設定を使用して、各ステージの構成やカスタマイズができます。

[ステージ情報] をクリックすると、ステージの説明と、すべての関連付けられたプロパティが表示されます。これらはクエリ結果をフィルタリングする条件として使用できます。

接続

Neuron ワークフローを実行できるように、各ステージを別のステージに接続する必要があります。ステージをハイライトし、コネクタ矢印を接続先のステージまでドラッグします。[接続] パネルが開きます。このパネルで、接続のタイプとスタイル、線幅、およびスタイルをカスタマイズできます。色の修正と、ラベルの追加も行えます。

フィルタ

カスタマイズ可能なプロパティに基づいて、クエリ結果をフィルタリングできます。組み込みのクエリステージをフィルタに接続すると、選択可能な、使用できる全プロパティが [プロパティ] ドロップダウンにリストされます。プロパティの詳細を表示するには、クエリ [ステージ設定] パネルに移動し、[ステージ情報] を選択します。

また、クエリのプレビュー機能を使用すると、すべてのターゲットデバイスを評価し、結果の表を使用して、フィルタリングできる値の形式と範囲を確認することができます。

osquery、PowerShell、BASH などのカスタムクエリでは、フィルタプロパティが自動的に入力されません。クエリで返される (またはクエリのプレビューに表示される) 列名に基づいて手動で入力する必要があります。

複数のクエリを連続して結合できます。これが完了した場合は、すべての結果が結合され、フィルタリングしたり、電子メールの送信や ISM チケットの作成などの処理ステージで使用したりできます。接続されたフィルタの比較動作を変更し、AND または OR ロジックを適用して、結果を判定することができます。

変数

ステージ間での情報の受け渡しや、アクション間での出力の受け渡しに、変数を使用できます。変数は、次のステージで使用できます。

Neurons アラート
電子メールの送信
チケットの作成 (ISM)

変数の挿入

変数を挿入するには、適切なステージ (Neuron アラート、電子メールの送信、チケットの作成 (ISM)) のいずれかで [ステージ設定] を開きます。適切なフィールドで、キーボードショートカット (Ctrl+Space) を使用して利用可能な変数のドロップダウンリストを開き、使用する変数を選択します。

Neuron 名: [[Workflow.Name]] - Neuron の名前。例: ブラックリストに載っているソフトウェア
グループ名: [[Workflow.Assistant]] - Neuron が属しているNeuron カテゴリの名前。例: 準拠
Neuron URL: [[Workflow.Url]] - Neuron の、一意の実行番号を持つインスタンスへのリンク
開始ユーザ: [[Initiation.User]] - 手動インスタンスを実行したユーザの名前
開始ユーザ ID: [[Initiation.UserId]] - 手動インスタンスを実行したユーザの ID
すべてのデバイス名: ${Ivanti.Devices} - クエリで返されたデバイス名のコンマ区切りリスト
すべてのデバイスデータ: ${Ivanti.Results} - クエリで返された全デバイスデータのリスト
デバイス数: ${Ivanti.Results.length} - クエリで返されたデバイスの数
対象 - 応答数: 応答したデバイスの数
対象 - エラー数: エラーで応答に失敗したデバイスの数
対象 - パーセント: 応答したデバイスのパーセンテージ

変数を使用した、すぐに使用できるテンプレートがあります。より複雑な要件がある場合のために、[Neuron アラート] と [電子メール] のフィールドで javascript をサポートしていますが、これには handlebars.js を使用します。

エラーの管理

毎回、ターゲットにしたすべてのデバイスですべての Neuron が正常に実行されれば、理想的です。しかし、時には、すべて成功しないこともあります。 Neurons ワークフローには、成功率を高めるための機能がいくつか組み込まれています。また、成功率を高め、発生したエラーを管理する上で役立つように、設計に関する意思決定や構成設定を、ユーザ側でも行えるようになっています。

タイムアウト

ワークフローが完了するまで待機するのか、失敗したワークフローを長く放っておかないようにするのか、その2つの間のバランスというものがあります。ワークフローの各ステージには、適切なタイムアウトが適用されています。クエリステージには、タイムアウト15秒、アクション5分、ターゲットアクション25分が設定されています。

実行のスキップ

スケジュールされた実行は、前の実行が完了している場合にのみ開始されます。 Neuron の [実行ログ] には、スキップされた実行がで示されます。

エラー分岐

ステージが実行されると、ワークフローは、ステージが成功したデバイスとステージが失敗したデバイスを記録します。これらの結果を、[ステージ出力] で確認できます。ステージが一部のターゲットデバイスでのみ成功した場合は、ステージと実行の両方が一部成功とマーク付けされ、ワークフローは、ステージが成功したデバイスのみへと進みます。エラー分岐を追加することで、この状況がより積極的に処理されるようにワークフロー設計を改善できます。

エラー分岐を追加するには:

任意のワークフローを開きます。
[ステージ] パネルの [共通] セクションで、[処理] ステージの下に [フィルタ結果] ステージを追加します。
このアクションステージをフィルタ結果ステージに接続します。
[フィルタ結果] ステージをクリックします。
[ステージ設定] パネルで [ロジック] を [AND]、[プロパティ] を [処理ステータス]、[比較] を [等しい]、[値] を [失敗] に設定します。
類似したフィルタ結果ステージを同じ処理ステージに関連付けますが、[値] は [完了] に設定されます。
これで、成功したデバイスを失敗したデバイスから分離するエラー分岐が設定されました。
[完了] フィルタ結果ステージでは、ワークフロー設計を完了します。
[失敗] フィルタ結果ステージの下で、[電子メールの送信] 処理ステージを追加して失敗を報告するか、別の該当する処理を追加してワークフローを進めます。