9.7. ルール適用

本章では、OASE のルール画面の機能および操作方法について説明します。
ディシジョンテーブルへのルールの適用は下記の流れで行います。
  • ステージング環境に対するルールの適用

  • ルールの検証

  • プロダクション環境に対するルールの適用

  • ルールの切り戻し

ステージング環境とプロダクション環境

Exastro OASE には、各ディシジョンテーブルに対して、ステージング環境とプロダクション環境を持ちます。
各環境についての説明は下記を参照して下さい。
ステージング環境
作成したディシジョンテーブルファイル内のルールの妥当性検証に利用する環境です。
ここでの検証作業は、プロダクション環境を含む外部のシステムへ一切の影響を与えません。
プロダクション環境
ステージング環境で検証済みのルールを使用して、監視運用の自動化を行う環境です。
../../../_images/staging_confirmation1.png

図 9.48 ルール適用の流れ

../../../_images/rule_00_01.png

図 9.49 ステージング環境とプロダクション環境の画面構成

ステージング環境に対するルールの適用

Exastro OASE では、ルールを適用するために、一度ステージング環境でルールを適用してからプロダクション環境に適用する必要があります。ステージング環境での確認プロセスを経由することで、ユーザの意図しない対処の実施を未然に防止し、安全にルールをプロダクション環境に適用することを目的としています。

ディシジョンテーブルファイルのアップロード

ディシジョンテーブルをステージング環境にアップロードするためには、 ルール ‣ ルール 画面を開き、 ステージング適用ルール フレームにある  ファイルを選択 ボタンを押下し、ファイル選択ダイアログから作成済みのディシジョンテーブルファイルを選択します。

注釈

ディシジョンテーブルの作成、および、ディシジョンテーブルファイルの取得方法については、 ルール作成 を参照してください。
また、ステージング環境へのルール適用には、対象となるディシジョンテーブルのステージング環境に対する「更新可能」のアクセス権限が必要です。
../../../_images/rule_03_02.png

図 9.50 ディシジョンテーブルファイルの選択

ファイルを選択後に  アップロード ボタンを押下することで、ディシジョンテーブルファイルのステージング環境への適用が開始されます。

注釈

ステージング環境へのアクセス権限が「更新可能」の場合のみ、アップロードボタンは押下することができます。
../../../_images/rule_03_03.png

図 9.51 ディシジョンテーブルファイルのアップロード

ルール適用状況の確認

ディシジョンテーブルファイルのアップロードをすると、ルールの適用プロセスが開始されます。
ディシジョンテーブルのルール適用状況は運用ステータスと作業ステータスから確認でき、運用ステータスが「検証未実施」となっていればステージング環境へのルール適用が完了です。

Tip

アップロードに失敗した場合は、ディシジョンテーブルファイルの記述に謝りがある可能性が高いです。
その場合は、ステージング適用ルール の該当するルールの ボタンからログファイルを取得することで原因を特定することができます。
ステージング適用ルールにおける、運用ステータスの詳細は下記の表のとおりです。
表 9.30 運用ステータス(ステージング適用ルール)

ステータス名

説明

未適用

アップロードを実施直後の状態。アップロード処理が正常に完了し、ステージング環境に適用されることで「検証未実施」状態へ遷移します。また、アップロード処理が異常終了した場合、この状態のままとなります。

検証未実施

ステージング環境に適用されているルールに対して、テストリクエストによる検証を実行していない状態。テストリクエストを行う、もしくは、運用者の任意で「検証実施中」「検証NG」「検証完了」へ遷移可能です。

検証実施中

ステージング環境に適用されているルールに対して、テストリクエストによる検証が完了していない状態。テストリクエストを行う、もしくは、運用者の任意で「検証NG」「検証完了」へ遷移可能です。また、運用者の任意で「検証未実施」へ戻すこともできます。

検証NG

ステージング環境に適用されているルールに対して、テストリクエストによる検証が異常終了した状態。運用者の任意で「検証未実施」「検証実施中」「検証完了」へ遷移可能です。

検証完了

ステージング環境に適用されているルールに対して、テストリクエストによる検証が正常終了した状態。この状態のとき、プロダクション環境への「適用」ボタンを押下することができます。また、プロダクション適用前であれば、運用者の任意で「検証未実施」「検証実施中」「検証NG」へ遷移可能です。

検証完了(プロダクション適用済み)

ルールがステージング環境に適用されている、かつ、プロダクション環境にも適用されている状態。この状態のとき、運用者の任意で状態遷移はできません。

適用終了

過去にステージング環境に適用されていたが、更新されルールが利用されなくなった状態。 過去を含め表示 ボタンが「ON」の状態の場合のみ表示されます。

ステージング適用ルールにおける、作業ステータスの詳細は下記の表のとおりです。
表 9.31 作業ステータス(ステージング適用ルール)

ステータス名

説明

アップロード中

アップロードを実施直後のディシジョンテーブルの状態。

アップロード異常終了

アップロード処理中に異常が発生し、処理が中断された状態。

アップロード完了

アップロード処理が正常終了した状態。その後、自動的にビルド処理が実行され、「ビルド中」状態へ遷移します。

ビルド中

アップロードされたディシジョンテーブルファイルを元に、ディシジョンテーブルのプロジェクトがビルドされている状態。

ビルド異常終了

ビルド処理中に異常が発生し、処理が中断された状態。

ビルド完了

ビルド処理が正常終了した状態。自動的にステージング適用処理が実行されると「ステージング適用中」状態へ遷移します。

ステージング適用中

ビルドされたプロジェクトをデプロイ中の状態。

ステージング適用異常終了

デプロイ処理中に異常が発生し、処理が中断された状態。

ステージング適用完了

デプロイ処理が正常終了した状態。

注釈

自動更新制御ボタンがONであり、アップロード中、ビルド中、ステージング適用中のいずれかのステータスが一覧の中に一つでもある場合、5秒間隔で自動的に一覧の更新が行われます。

ルールの検証

アップロードされたルールの検証を行う手段として、テストリクエストの機能が提供されています。
これは、アップロードしたルールがユーザの想定通り条件に一致するかを確認するための機能です。
上記の理由からルールの検証を行うことを推奨しますが、ルールの検証が不要な場合は、手動による運用ステータスの変更 を行うことで本手順をスキップすることが可能です。
テスト実施の方法には、単発のリクエスト送信による単発テストと複数のリクエストを同時に送信する一括テストの2通りの方法があります。

注釈

テストの実施には、対象となるディシジョンテーブルのステージング環境に対する「参照のみ」、「更新可能」のアクセス権限が必要です。

テスト実施(単発テスト)

単発テストは、画面からの操作のみでテストを実行できるため簡単にテストを実施できるメリットがあります。
 テストリクエスト ボタンを押下し、テストリクエスト画面へ遷移します。
テスト実施対象のディシジョンテーブルをプルダウンから選択します。
../../../_images/rule_03_04.png

図 9.52 テストリクエスト

../../../_images/rule_03_13_02.png

図 9.53 ディシジョンテーブル選択

ディシジョンテーブルの選択し、  テストリクエスト設定へ ボタンを押下します。
単発テスト を押下し、テストリクエストで投入する内容を記入します。
../../../_images/rule_03_18.png

図 9.54 テストリクエスト設定

表 9.32 テストリクエスト設定項目

項目名

説明

イベント発生日時

現在時刻が自動的に入力されます。

リクエスト項目

ディシジョンテーブルで定義されている条件部に対して、テストリクエストで送信する値を設定します。Web API により投入されるリクエストや監視アダプタから取得したイベント情報により想定される値を記入します。

各項目にテスト用の値を入力したら、下部の  実行 ボタンを押下し、テストを実施します。

テスト実施(一括テスト)

一括テストは、スプレッドシートに事前にテストで検証したい値のパターンを複数用意することで、一度に複数の検証を実施できるメリットがあります。
 テストリクエスト ボタンを押下し、テストリクエスト画面へ遷移します。
テスト実施対象のディシジョンテーブルをプルダウンから選択します。
../../../_images/rule_03_04.png

図 9.55 単発テストリクエスト

../../../_images/rule_03_13_02.png

図 9.56 ディシジョンテーブル選択

ディシジョンテーブルの選択し、  テストリクエスト設定へ ボタンを押下します。
一括テスト を押下し、 一括テスト用Excelファイルのダウンロード ボタンからファイルをダウンロードします。
ダウンロードした一括テスト用Excelファイルに、ディシジョンテーブルで定義されている条件部に対して、テストリクエスト送信の値を記入します。Web API により投入されるリクエストや監視アダプタから取得したイベント情報により想定される値を記入します。
../../../_images/rule_03_19.png

図 9.57 一括テストリクエスト設定

../../../_images/rule_04_01.png

図 9.58 一括テスト用Excelファイル

各項目にテストリクエスト送信の値を入力したら、 ファイルを選択する ボタンから記入済みの一括テスト用Excelファイルをアップロードし、下部の  実行 ボタンを押下し、テストを実施します。

テスト実行結果の確認

テストが開始されると、実行ログ 画面に遷移し、その実行状況が出力されます。
実行状況は定期的に取得され、随時ログの出力内容が更新されます。
実行状況の取得は、テストが完了する、もしくは、テストリクエスト画面が閉じられるまで行われます。
../../../_images/rule_03_25_01.png

図 9.59 実行ログ(単発テスト)

表 9.33 ログ出力内容(単発テスト)

No.

出力項目

説明

1

ステージング実行開始

テストリクエストが実行された日時が表示されます。

2

リクエスト情報

設定タブのリクエスト項目にて入力された情報が表示されます。

3

実行状態

テストの実行状態が表示されます。

4

マッチング結果

テストが完了した際、ディシジョンテーブルから受信したルールのマッチング結果が表示されます。テストが完了していない、もしくは、ルールがマッチングしなかった場合は何も表示されません。

../../../_images/rule_03_25_02.png

図 9.60 実行ログ(一括テスト)

表 9.34 ログ出力内容(一括テスト)

No.

出力項目

説明

1

ステージング実行開始

テストリクエストが実行された日時が表示されます。

2

ファイル名

リクエストが記述された一括リクエストファイル名が表示されます。

3

処理件数

分母に送信されたリクエスト数、分子にテストが完了したリクエスト数が表示されます。

4

実行状態

各リクエストごとに、ファイル内の記述行、および、テストの実行状態が表示されます。ディシジョンテーブルからマッチング結果を受信した場合、その件数、および、アクションパラメーターが表示されます。

実行ログは、テストの証跡取得のためにテキストファイルとして出力するが可能です。
../../../_images/rule_03_27.png

図 9.61 ログダウンロード

テスト実行が完了したら、 閉じる を押下するとルール画面に戻ります。
このとき、「運用ステータスを検証完了にしてよろしいですか?」と確認メッセージが表示されます。
OK を選択すると運用ステータスが「検証完了」へ、「キャンセル」を選択すると運用ステータスが「検証実施中」へ遷移します。
../../../_images/rule_03_31.png

図 9.62 検証の終了

手動による運用ステータスの変更

ルールファイルの運用ステータスが「検証未実施」「検証実施中」「検証NG」「検証完了」のいずれかに該当、かつ、プロダクション環境へ適用していない場合、運用者の任意でステータスを変更できます。
ステージング環境へのアクセス権限が「更新可能」の場合のみ、運用ステータスの変更は押下することができます。
../../../_images/rule_03_06.png

図 9.63 運用ステータスの変更

プロダクション環境に対するルールの適用

ステージング適用ルールにおける運用ステータスが「検証完了」の場合、ルールをプロダクション環境へ適用させることができます。
適用させたい ステージング適用ルール ボタンを押下することで、プロダクション環境にルールを適用します。

警告

ボタンを押下すると、プロダクション環境に新しいルールでの対処が開始されます。

注釈

プロダクション環境へのルール適用には、対象となるディシジョンテーブルのプロダクション環境に対する「更新可能」のアクセス権限が必要です
../../../_images/rule_03_08.png

図 9.64 プロダクション環境への適用

プロダクション環境へルールの適用を実施すると、作業ステータスや運用ステータスが更新されます。
プロダクション適用ルールの運用ステータスが「プロダクション適用」となれば正常です。
../../../_images/rule_03_09.png

図 9.65 プロダクション適用ルール

プロダクション適用ルールにおける運用ステータスは下記のとおりです。
表 9.35 運用ステータス(プロダクション適用ルール)

ステータス名

説明

プロダクション未適用

ステージング環境に適用されているルールをプロダクション環境へ適用実施直後の状態。適用処理が異常終了した場合、この状態のままとなります。

プロダクション適用

現在適用中のプロダクションの状態。

プロダクション適用終了

過去にプロダクション環境に適用されていたが、更新されルールが利用されなくなった状態。 過去を含め表示 ボタンが「ON」の状態の場合のみ表示されます。

プロダクション適用ルールにおける作業ステータスは下記のとおりです。
表 9.36 作業ステータス説明(プロダクション適用ルール)

ステータス名

説明

プロダクション適用中

ステージング環境に適用されているルールをプロダクション環境へ適用実施直後、もしくは、切り戻しによる再適用の実行直後の状態。

プロダクション適用異常終了

プロダクション適用中に異常が発生した状態。

プロダクション適用完了

プロダクション適用処理が正常終了した状態。

ルールの切り戻し

ルールの記述に誤りがあった場合、Exastro OASE ではルールの適用履歴から過去のルールに戻すことが可能です。
プロダクション適用ルール のパネル右上にある  過去を含め表示 を「ON」に切り替え、過去の適用履歴を表示させます。
 過去を含め表示 機能は通常は「OFF」となっており、押下することでON/OFFが切り替わります。
過去にプロダクション環境へ適用されていたルールを確認するために、ダウンロードボタン から当時のディシジョンテーブルファイルを取得します。
ダウンロードしたディシジョンテーブルファイルの内容を確認し問題なければ、切り戻しボタン を押下し、再度プロダクション環境へルール適用(切り戻し)を実施します。

注釈

プロダクション環境へのルール適用には、対象となるディシジョンテーブルのプロダクション環境に対する「更新可能」のアクセス権限が必要です
../../../_images/rule_03_12.png

図 9.66 プロダクション適用ルールの履歴からルールの再適用

ルールの評価結果

ルールの評価結果については、アクション履歴 を参照してください。