#はじめに
OASEのコミュニティサイトにLearn「Base」が新しく追加された。

Exastro OASE BASE
OASEの基本機能の利用手順をご用意しました。
本書は、ポイントを絞り込んだ「座学編」、簡単にハンズオンしたい方のための「実習編」の2部構成になっております。
機能ごとの特長を分かりやすく解説し、イメージしづらい概念的な内容は図解している為、効率よく OASEの共通機能を理解することが可能です。　　
(公式コミュニティサイト_Exastro OASE Learn より引用)

「Base【実習】」をハンズオンしてみる。

Exastro OASE Learn MAPを見てみる

(公式コミュニティサイト_Exastro OASE Learn より引用)

実際に手を動かしながら「OASE」と「ITAドライバ」を連携した一連の流れを動かしてみる。

おおまかなフローとしては「事前設定」と「作業実行」の2段構成。

(スライドは公式コミュニティサイト_Exastro OASE Learn より引用)

ハンズオンを実施する前にスペックを確認する

OASEやITAをインストールする必要がある中、環境のスペックが低いとインストールができなかったり、インストールできても動かなかったりする（実際動かなくなった）。
スペックが不足しないか要確認！

###今回の環境

VM2台（OASE用・ITA用）を用意した

####OASE用

カテゴリ	導入
OS	CentOS7
CPU	6コア
メモリ	8GB
ディスク	100GB
メールサーバソフトウェア	Postfix

(参考：システム構成ガイドシステム要件 )

####ITA用

カテゴリ	導入
OS	CentOS7
CPU	2コア
メモリ	4GB
ディスク	20GB

(参考：Exastro-ITA_システム構成/環境構築ガイド_基本編 )

##「Base【実習】」に記載の「前提」を実施していく

###前提 ① ITAをインストール

公式のドキュメントやqiita記事を参考にインストールを実施する

###前提 ② ITA BASE【実習】の実施
前半の内容は今回特に使わないので、「シナリオ」スライド以降を対応する

ITA BASE【実習】

シナリオ以降を実施するとディレクトリ「tmp」配下に「testdirectory」が生成される

###前提 ③ OASEをインストール
公式のドキュメントやqiita記事を参考にインストールを実施する

OASEをインストールしている環境でメールが使えることを確認する

一般ユーザ作成時のパスワード通知のため、インストール時にメールサーバの設定が必要
(公式コミュニティサイト_Exastro OASE Learn 「Base【実習】」より引用)

今回使用するメールサーバソフトウェア「Postfix」が起動しているか確認

# Postfixのプロセス確認
ps -ax | grep postfix

※起動しているとこうなる

※起動していないとこうなる。

以下のコマンドで再起動を実施したり、設定を見直してメールサーバソフトウェアでメールが送れるようにしておく必要がある

# Postfixの起動
systemctl start postfix

今回はOASE側の環境にPostfixを入れたけれど、必ずしも「OASE」と「メールサーバソフトウェア」が同居している必要はないみたい
メールサーバソフトウェアについてはこのあたりを参考にしてみた
（参考：Postfix 基本設定）

###前提 ④ OASE Base【座学】の確認
必要に応じて見ながら進める

###前提 ⑤ OASEへITAドライバをインストール
Base【座学】のスライドにも注釈があるけれど、インストールするディレクトリに要注意

(スライドは公式コミュニティサイト_Exastro OASE Learn 「Base【座学】」より引用)

公式のドキュメントやqiita記事を参考にインストールを実施する

環境構築マニュアル -ドライバインストール編-
Exastro OASE を最速でインストールする

※上記qiitaの後半で、ITAドライバについても資材解凍～インストールについて説明されている

##「Base【実習】」のシナリオを確認

(スライドは公式コミュニティサイト_Exastro OASE Learn 「Base【実習】」より引用)

シナリオを絵にしてみると多分こういう流れになる

###①環境を用意

先述した今回の環境

###②必要なアイテムをインストール

先述した
前提 ① ITAをインストール
前提 ③ OASEをインストール ※メールサーバソフトウェアの設定も実施
前提 ⑤ OASEへITAドライバをインストール

###③【前提】の実施

先述した
前提 ② ITA BASE【実習】の実施
前提 ③ OASEをインストール ※メールの疎通確認実施

###④【事前設定】を実施する

後述する
①【事前設定】グループ作成
②【事前設定】ユーザ作成、新規ユーザでのログイン
③【事前設定】トークン払い出し
④【事前設定】アクション設定（ITAドライバ）
⑤【事前設定】ディシジョンテーブル作成

###⑤【作業実行】を実施する（ルールの登録・staging（検証）まで）

後述する
⑥【作業実行】ディシジョンテーブルファイル作成
⑦【作業実行】ルール登録（アップロード、テストリクエスト）

###⑥【作業実行】を実施する（production(本番)環境で実行）

後述する
⑧【作業実行】ルール判定（curlコマンドによるリクエスト送信）
⑨【作業実行】アクション実行結果の確認（ITA連携）

###⑦【作業実行】を実施する（未知事象の場合はメールで通知される）

後述する未知事象通知

##シナリオの１～９を実践する

【事前設定】～【作業実行】における各ステップのスライドで「こういう値が入力できるよ」とは書かれているけれど具体的な値がなかったりする。
終盤のスライド「A　付録サンプル」に具体値は書いてあるけれど、それだけだと情報が足りない...ので、ここでは「各ステップのスライド」と「A 付録サンプル」の良い所取りをして進めていく。

※ 「各ステップのスライド(左)」と「A 付録サンプル(右)」の比較

(スライドは公式コミュニティサイト_Exastro OASE Learn 「BASE【実習】」より引用)

###①【事前設定】グループ作成

「test_group」という名称のグループを登録する

項目	具体値
グループ名	test_group

作成した「test_group」にアクセス権限を付与する

項目	具体値
アクセス権限	すべて「更新可能」

###②【事前設定】ユーザ作成、新規ユーザでのログイン

「test_user」という名称のユーザを登録する

項目	具体値
ユーザ名	test_user
ログインID	test_user
メールアドレス	（自分のメールアドレス）
グループ	test_group

###③【事前設定】トークン払い出し

「practice_token」という名称のトークンを払い出す

項目	具体値
トークン名	practice_token
グループ別権限	test_group：権限あり

###④【事前設定】アクション設定（ITAドライバ）

「test_ita」という名称でITAドライバを追加する

項目	具体値
名前	test_ita
バージョン	1.7.1
プロトコル	http
ホスト/IP	（ITAをインストールした環境のIP）
ポート	80
ユーザ名	administrator
パスワード	(ITAにログインできるパスワード)
権限の設定	test_group：更新可能

ITAにログインして、今回の「Base【実習】」で生成されるディレクトリ名に具体値を変更する

項目	具体値
具体値	oase_testdirectory

※「ITA_BASE【実習】」では「testdirectory」と入力させられた箇所

「ITA_BASE【実習】」では特に見なかった以下の画面にて、「廃止」ステータスの「Symphony紐付Movement一覧」メニューを「復活」させる

###⑤【事前設定】ディシジョンテーブル作成

「基本情報・権限」タブ

項目	具体値
ディシジョンテーブル名	test_dt
権限の設定	test_group：全て「更新可能」

「条件式」タブ

項目	具体値
条件名①	アラートレベル
条件式①	正規表現に一致する
条件名②	対象
条件式②	正規表現に一致する

「未知事象通知」タブ

項目	具体値
未知事象通知	メールで通知する
連絡先メールアドレス	（自分のメールアドレス）

ディシジョンテーブルの作成は4件程度にとどめておくこと
4件以上作成するとエラーになる可能性が高くなるので留意

ディシジョンテーブル作成可能数¶
ディシジョンマネージャは環境によって作成できるディシジョンテーブル数が変動します。
ディシジョンテーブルの最大作成可能数はデフォルトでは4ファイル程度となります。
記載ルール数またはルール自体の複雑度によってディシジョンテーブル作成数が前後する可能性があります。
より多くのディシジョンテーブルの作成を実施したい場合はチューニングが必要となります。
(OASE_docs 環境構築マニュアル -基本編- より引用)

###⑥【作業実行】ディシジョンテーブルファイル作成

ルール説明	アラートレベル	対象	ルール名	アクション種別	アクションパラメータ情報	アクション実行前パラメータ情報	リトライ間隔	リトライ回数	条件回数	条件期間	大グループ	優先順位	小グループ	優先順位	有効日	無効日
ルール1	^.Error.$	^.HDD.$	check_Error	ITA(Ver1)	ITA_NAME=test_ita,SYMPHONY_CLASS_ID=1,OPERATION_ID=1	x	1	1	x	x	x	x	x	x	(空白)	(空白)
ルール2	^.Warning.$	^.memory.$	check_Warning	なし	x	x	1	1	x	x	x	x	x	x	(空白)	(空白)
ルール3	^.info.$	^.％.$	check_Info	なし	x	x	1	1	x	x	x	x	x	x	(空白)	(空白)

###⑦【作業実行】ルール登録（アップロード、テストリクエスト）

「ディシジョンテーブル」タブ

項目	具体値
ディシジョンテーブル名選択	test_dt

「設定」タブ（一括テストリクエスト）

リクエスト名	イベント発生日時	アラートレベル	対象
ルール1用	2019-5-17 1:20:30	Error:	HDD usage 80% over
ルール2用	2019-5-17 1:20:30	Warning:	memory usage 80% over
ルール3用	2019-5-17 1:20:30	[info]	HDD usage 20% over

ファイル選択

項目	具体値
ファイルを選択	id000000000xx_testrequest.xlsx

###⑧【作業実行】ルール判定（curlコマンドによるリクエスト送信）

OASEをインストールしている環境で以下のコマンドを実行する

# 作成したルールに合致するメッセージを投入する
curl -X POST -k "https://xx.xx.xx.xx（※1）/oase_web/event/event/eventsrequest" \
     -H "accept: application/json" \
     -H "Authorization: Bearer xxxxxxxxxxxxxxxxxxxxx(※2)" \
     -d '{"decisiontable":"test_dt","requesttype":"1","eventdatetime":"2021/04/26 11:20:00","eventinfo":["Error:","HDD usage 80% over"]}'

※1...OASEを導入した環境のIPアドレス
※2...「【事前設定】③ トークン払い出し」で払い出したトークン

###⑨【作業実行】アクション実行結果の確認（ITA連携）

####OASEの「アクション履歴」画面
ログ詳細に「処理済み（正常終了）」と表示される

####ITAの「Symphony作業一覧」メニュー
項目「ステータス」に「正常終了」と表示される

####ITA環境の「/tmp」ディレクトリ配下
設定した通りのアクションが行われ、「oase_direcgtory」が作成された

####未知事象通知

ルール定義していない「message:」「SKIP」といったメッセージを流した場合は未知事象通知が飛ぶ

※「A 付録サンプル」に則り、以下のcurlコマンドを実行する

# ルールとして定義していないメッセージを投入する
curl -X POST -k "https://xx.xx.xx.xx（※1）/oase_web/event/event/eventsrequest" \
     -H "accept: application/json" \
     -H "Authorization: Bearer xxxxxxxxxxxxxxxxxxxxx(※2)" \
     -d '{"decisiontable":"test_dt","requesttype":"1","eventdatetime":"2021/04/26 11:20:00","eventinfo":["message:","SKIP"]}'

※1...OASEを導入した環境のIPアドレス
※2...「【事前設定】③ トークン払い出し」で払い出したトークン

#まとめ
OASEからITAをキックするといった流れで処理を通すことができた。