1.1. インスタンスのスケールアウト実施¶

1.1.1. 今回のシナリオで自動化する作業について¶

このシナリオでは、以下の保守作業を自動的に実行します。

作業A インスタンスをスケールアウトする作業

今回想定している構成から作業Aが実行されるのは、

リクエスト数が閾値を超過したとき。ただし、稼働するインスタンス数は3台まで

となります。

つまり通常は1台稼働なので、リクエスト数が閾値を超過しスケールアウトする状況は、

1台稼働の閾値である50リクエスト/minを超えたとき

2台稼働の閾値である100リクエスト/minを超えたとき

になります。

1.1.2. 具体的な設定の検討¶

では具体的に今回の運用保守の一連の流れをどのようにOASEで設定するか、作業計画を立てましょう。

作業Aを条件に合わせて実行するようにするためには、OASEで以下のような設定を行う必要があります。

設定a 外部サービスからイベントを収集する設定
設定b 収集したイベントの中から、リクエスト数超過に関するイベントを特定する設定
設定c リクエスト数超過に関するイベントの中から自動化する作業Aの条件に合うイベントを検知する条件の設定
設定d 自動化する作業Aの登録
設定e 設定cで設定した振り分け条件と設定dで登録した作業を紐づける設定

ここまで整理できたら、具体的に以下の順にOASEの設定を行っていきましょう。

イベント収集設定
ラベルの設定
OASEエージェントの設定
ルールの設定

1.1.3. イベント収集設定¶

エージェントはイベント収集設定で設定された外部サービスに対して、イベントの収集を行います。

エージェントがどの外部サービスからリクエスト数超過というイベントを収集するか設定をしていきましょう。

Tip

設定するためには対象となる外部サービスの情報が必要です。お手元にご準備ください。

1.1.3.1. イベント収集設定¶

イベント収集設定では、エージェントがどの外部サービスからイベントを収集するかを設定します。

事前に用意したメールサーバの情報をもとに設定をしましょう。

OASE管理 ▶ エージェントから、外部サービスの情報を登録します。

登録ボタンを押し、以下のエージェントの登録をしていきます。

表 1.25 イベント収集設定値¶
イベント収集設定名	接続方式	リクエストメソッド	接続先	認証情報		TTL
				ユーザー名	パスワード
`リクエスト監視`	`IMAP パスワード認証`	`IMAP: Plaintext`	`...**`	`***@.***`	`**`	`60`

入力が終わったら、編集確認ボタンを押して登録します。

Tip

* の部分は、各自の外部サービスの情報を入力してください。

1.1.4. ラベルの設定¶

収集するイベントに付与するラベルの作成と付与する条件を設定します。

ラベル¶
ラベルは「キー」と「値」から成り、付与されたイベントの属性を表します。¶
イベントは、付与された「キー」と「値」によって認識されます。¶

今回必要なラベルキーは以下の通りです。

表 1.26 ラベルキー一覧¶
ラベルキー	利用目的
subject	イベントの内容を特定できるようにするラベル
requestcount	基準となった閾値を把握するためのラベル
instance	作業Aの作業結果を示すためのラベル

注釈

イベントに含まれる全ての情報をラベルとして管理する必要はありません。今後必要になったタイミングで適宜追加や見直しをしましょう。

1.1.4.1. ラベルの作成¶

ラベル作成では、イベントを特定する時に利用するキー(ラベル)を作成します。

OASE ▶ ラベル ▶ ラベル作成から、ラベルを作成します。

登録ボタンを押し、以下のラベルの設定を追加していきます。

必要に応じて、追加ボタンを押して行数を追加しましょう。

表 1.27 ラベル作成の設定値¶
ラベルキー	カラーコード
`subject`	`#FBFF00`
`requestcount`	`#7F76F9`
`instance`	`#00FF33`

入力が終わったら、編集確認ボタンを押して登録します。

注釈

ラベルそれぞれにカラーコードを設定することで、付与されたときに見分けやすくなります。

1.1.4.2. ラベルを付与する条件の設定¶

ラベル付与では、イベントにラベルを付与する条件と、条件に合った際に付与するラベルの内容を設定します。

今回は、リクエスト数超過を知らせるものであるかどうか、また、基準となった閾値はいくらかを示すラベルを付与する必要があります。

OASE ▶ ラベル ▶ ラベル付与から、ラベルを付与するための設定を行います。

登録ボタンを押し、以下のラベル付与の設定を追加していきます。

必要に応じて、追加ボタンを押して行数を追加しましょう。

表 1.28 ラベル付与の設定値¶
ラベリング設定名	イベント収集設定名	検索条件				ラベル
		キー	値のデータ型	比較方法	比較する値	キー	値
`通知名`	`リクエスト監視`	`subject`	`文字列`	`==`	`[alert] Requests: Threshold reached`	`subject`	`リクエスト数超過`
`リクエスト数監視`	`リクエスト監視`	`body.plain`	`その他`	`RegExp`	`RequestCount . (\d{2,3})`	`requestcount`	`\1`

入力が終わったら、編集確認ボタンを押して登録します。

Tip

ラベリング設定名とイベント収集設定名は任意で設定可能です。わかりやすいものを設定しましょう。
メールの件名から通知内容を特定する、「subject」のラベルを付与する設定を行います。
メールの本文から通知の基準となった閾値を参照でする、「requestcount」のラベルを付与する設定を行います。

1.1.5. OASEエージェントの設定¶

OASEエージェントの設定を行い、エージェントを実行します。

これにより、「イベント収集設定」で指定した外部サービスからイベントを収集し、「ラベルを付与する条件の設定」に合うイベントにはラベルが付与されます。

注釈

OASEエージェントの詳細は、下記のページにてご確認ください。

OASE Agent on Docker Compose - Online

1.1.5.1. .envの設定¶

.envの項目にこれまでの工程で設定した値を設定します。

exastro-docker-compose/ita_ag_oase/.env に下記の内容を入力します。

表 1.29 .envの設定値¶
項目名	設定値
`AGENT_NAME`	`ita-oase-agent-01`
`EXASTRO_URL`	`http://********`
`EXASTRO_ORGANIZATION_ID`	`********`
`EXASTRO_WORKSPACE_ID`	`********`
`EXASTRO_USERNAME`	`********`
`EXASTRO_PASSWORD`	`********`
`EVENT_COLLECTION_SETTINGS_NAMES`	`リクエスト監視`
`EXECUTE_INTERVAL`	`5`
`LOG_LEVEL`	`INFO`

Tip

* の部分は、各自の情報を入力してください。
「EXASTRO_USERNAME」と「EXASTRO_PASSWORD」は、ワークスペースのものになります。
各項目の詳細は、下記のページ 2.8.1. OASE Agentの処理フローと.envの設定値 を参照ください。
OASE 管理

1.1.5.2. エージェントの実行¶

次のコマンドを使い、コンテナを起動してみましょう。

警告

UIDが1000以外のユーザで実行する場合は、「chown -R 1000:1000 保存先のボリュームのパス」を実行してください。

リスト 1.8 docker コマンドを利用する場合(Docker環境)¶

docker compose up -d --wait

リスト 1.9 docker-compose コマンドを利用する場合(Podman環境)¶

docker-compose up -d --wait

状態が Healthy になっていることを確認します。

正常に接続できているか、以下のコマンドでLogの確認をします。

リスト 1.10 docker コマンドを利用する場合(Docker環境)¶

docker compose logs -f

リスト 1.11 docker-compose コマンドを利用する場合(Podman環境)¶

docker-compose logs -f

エラーが出ている場合は、.envファイルの各設定値が正しいか確認してください。

1.1.6. ルールの設定¶

ルール では、イベントを特定する条件と、その条件に合致したイベントが発生した場合に実行したい作業を紐づけることができます。
イベントを特定する条件は フィルター 、実行したい作業は アクション 、でそれぞれ設定します。
ルール では、フィルター と アクション を紐づける形で設定します。

注釈

イベントフロー では、OASEエージェントが収集したイベント等、イベントが時系列に表示されます。
表示されたイベントには、ラベル付与での設定に沿ってラベルが付与されています。
この画面から フィルター 、アクション 、ルール の設定をそれぞれ行うこともできます。

まずは、以下のような、1台稼働の時にリクエスト数超過のイベントを発生させて、設定を進めましょう。

表 1.30 通知メール一覧¶
通知内容	リクエスト数超過
`件名`	`[alert] Requests: Threshold reached`
`本文`	`リクエスト数が、閾値を超えました。` `RequestCount > 50`

1.1.6.1. フィルターの設定¶

フィルターでは、ラベルをもとにイベントを検知するための条件を設定します。

イベントの件名と本文からスケールアウトを実施する条件に合うイベントを特定できるように条件を設定してみましょう。

注釈

スケールアウトを実施するのは、インスタンスが3台未満の稼働の状態で、リクエスト数が閾値を超過する場合です。

閾値は、インスタンス1台につき50リクエスト/minです。

OASE ▶ ルール ▶ フィルターから、フィルターを設定します。

登録ボタンを押し、以下のフィルターの設定を追加していきます。

表 1.31 フィルターの設定値¶
有効	フィルター名	フィルター条件	検索方法
`True`	`request_limit`	`[["subject", "==", "リクエスト数超過"], ["requestcount", "≠", "150"]]`	`ユニーク`

入力が終わったら、編集確認ボタンを押して登録します。

Tip

フィルター名は任意で設定可能です。わかりやすいものを設定しましょう。
ラベル「subject」の値から、リクエスト数が超過したことを通知するイベントであることを特定できるようにフィルター条件を設定します。
ラベル「requestcount」の値から、通知の基準となった閾値を特定できるようにフィルター条件を設定します。

今回は、閾値として50か100の場合を条件として同じアクションを実行するので150以外と設定しましたが、それぞれの閾値でアクションを変えるなど、個別の設定がしたい場合は、それぞれの閾値で別のフィルターを設定しましょう。

ラベル「requestcount」だけでは超過したイベントなのか回復したイベントなのか判別できないため、ラベル「subject」をフィルター条件に設定し、イベントを一意に特定できるようにします。

このように、イベントごとに特定のラベルを付与しなくても、必要に応じてフィルター条件を複数設定することで、イベントを一意に特定することできます。

フィルターは OASE ▶ イベント ▶ イベントフローからも設定することが可能です。

注釈

未知のイベントが発生した場合は、OASE ▶ イベント ▶ イベントフローからの設定がおすすめです。

イベントを参照しながら直感的に設定できます。

OASE ▶ イベント ▶ イベントフローからは以下のように設定します。

警告

フィルターでイベントを検出するには、そのイベント発生前に設定しておく必要があります。

1.1.6.2. アクションの設定¶

アクションでは、ITAで作成したConductorとオペレーションを指定できます。

インスタンスを1台スケールアウトするアクションを登録してみましょう。

OASE ▶ イベント ▶ イベントフローから、アクションを設定してみます。

表 1.32 アクションの設定値¶
アクション名	Conductor名称	オペレーション名	ホスト
			イベント連携
`scale-out`	`インスタンススケールアウト`	`インスタンススケールアウト`	`false`

Tip

アクション名は任意で設定可能です。わかりやすいものを設定しましょう。

Conductor名称とオペレーション名は、事前に設定してあるものから選択します。今回はスケールアウト用に準備したものを選択しましょう。

警告

発生したイベントに適用したい場合、そのイベントのTTL内に設定する必要があります。

TTL内に設定が難しいようであれば、事前に設定しておきましょう。

OASE ▶ ルール ▶ アクションからは以下のように設定します。

登録ボタンを押し、以下のアクションの設定を追加していきます。

入力が終わったら、編集確認ボタンを押して登録します。

1.1.6.3. ルールの設定¶

ルールでは、フィルターとアクションを紐づけます。

そのフィルターでイベントを検知した場合に実行したいアクションを紐づけましょう。

注釈

スケールアウトを実施するのは、インスタンスが3台未満の稼働の状態で、リクエスト数が閾値を超過する場合です。

閾値は、インスタンス1台につき50リクエスト/minです。

OASE ▶ イベント ▶ イベントフローから、ルールを設定してみます。

表 1.33 ルールの設定値¶
有効	ルール名	ルールラベル名	優先順位	条件	アクション	結論イベント
				フィルターA	アクションID	元イベントのラベル継承		結論ラベル設定	TTL
						アクション	イベント
`True`	`スケールアウト`	`スケールアウト`	`1`	`request_limit`	`scale-out`	`True`	`False`	`["instance", "scale-out"]`	`60`

Tip

ルール名・ルールラベル名は任意で設定可能です。わかりやすいものを設定しましょう。
条件では、フィルターの設定で設定したフィルター「request_limit」を選択します。
アクションでは、アクションの設定で設定したアクション「scale-out」を選択します。
これにより、フィルタ―「request_limit」でイベントを検知したら、アクション「scale-out」が実行されます。

結論ラベル設定には、アクションが実行されたことを示す結論イベントに付与するラベルを設定します。

結論イベントが判別しやすいようなラベルを設定するとよいでしょう。

分間で集計したリクエスト数をもとに通知されるため、TTLは60秒とします。

警告

発生したイベントに適用したい場合、そのイベントのTTL内に設定する必要があります。

TTL内に設定が難しいようであれば、事前に設定しておきましょう。

OASE ▶ ルール ▶ ルールからは以下のように設定します。

登録ボタンを押し、以下のルールの設定を追加していきます。

入力が終わったら、編集確認ボタンを押して登録します。

1.1.6.4. 結果の確認¶

以上の設定が完了したら、発生したイベントをもとにアクションが実行される様子を、イベントフロー画面から確認してみましょう。

Tip

ルールの設定の間に発生させたイベントのTTLが切れてしまったら、改めて同じイベントを発生させてください。

表 1.34 通知メール一覧¶
通知内容	リクエスト数超過
`件名`	`[alert] Requests: Threshold reached`
`本文`	`リクエスト数が、閾値を超えました。` `RequestCount > 50`

OASE ▶ イベント ▶ イベントフローの画面では、時系列に沿ってイベントが発生している様子を確認できます。

アクションが実行されたことを示す結論イベントにルールで設定したラベルが付与されていることも確認しましょう。

さて次に、2台稼働となった状態で、以下のようなリクエスト数超過イベントを発生させてみましょう。

そうすると、事前に設定したルールが適用され、結論イベントの発生まで確認できます。

このように一度設定し有効にしている限り、フィルターに合致するイベントが発生するたびにルールは適用されます。

↑ Page Top