9.3. アクション定義¶
Exastro IT Automation 連携¶
ITAアクションパラメータ¶
パラメータ分類 |
パラメータ変数 |
パラメータ値 |
入力例 |
|---|---|---|---|
ドライバ名 |
ITA_NAME |
ITAドライバ名。 必須項目です。 |
ITA_NAME=exastro-ita01 |
ジョブフロー |
CONDUCTOR_CLASS_ID |
実行するConductorクラスID。 ConductorクラスIDはConductorクラス一覧で確認できます。 SYMPHONY_CLASS_IDのどちらか一つのみを選択する必要があります。 |
CONDUCTOR_CLASS_ID=2 |
SYMPHONY_CLASS_ID |
実行するSymphonyクラスID。 SymphonyクラスIDはSymphonyクラス一覧で確認できます。 CONDUCTOR_CLASS_IDのどちらか一つのみを選択する必要があります。 |
SYMPHONY_CLASS_ID=3 |
|
オペレーション |
OPERATION_ID |
作業を実行する際に利用するオペレーションID。 OPERATION_ID を利用する場合、作業対象やメニュー連携はできません。 |
OPERATION_ID=4 |
投入パラメータ |
MENU_ID |
ITA のメニューIDを指定。 連携可能なメニューはホストグループ利用が有効になっているメニューに限られます。 <メニューID>:<メニューID>:... CONVERT_FLGの指定が必要です。 |
MENU_ID=1 MENU_ID=1:2 |
CONVERT_FLG |
作業対象のホストをメッセージから利用するためのフラグです。 MEMU_IDの利用時に指定が必要です。 TRUE : 取得したメッセージを作業対象ホスト名として利用します。 FALSE : 取得したメッセージの一部を抽出した文字列を作業対象ホスト名として利用します。 |
CONVERT_FLG=TRUE CONVERT_FLG=FALSE |
|
作業対象 |
SERVER_LIST |
ITA の機器一覧に登録されている作業対象ホスト。 OPERATION_ID は自動で払い出されます。 OPERATION_IDおよびMENU_IDとの併用はできません。 |
SERVER_LIST=www01 SERVER_LIST=www01:www02 |
HOST_NAME |
ITA のホストグループ管理のホスト紐付け管理に登録されているホスト名。 <メニューID>:<ホスト名>&<ホスト名>&...|<メニューID>:<ホスト名>... MENU_ID利用時のみ指定ができます。 |
HOST_NAME=1:db01 HOST_NAME=1:db01&db02|2:www01 |
|
HOSTGROUP_NAME |
ITA のホストグループ管理のホストグループ一覧で管理されているホストグループ名。 MENU_ID利用時のみ指定ができます。 |
HOSTGROUP_NAME=1:db-group|2:web-group |
|
注釈
ユースケース¶
ITA_NAME=exastro-ita01,CONDUCTOR_CLASS_ID=1,OPERATION_ID=1
ITA_NAME=exastro-ita01,SYMPHONY_CLASS_ID=2,OPERATION_ID=2
ITA_NAME=exastro-ita01,CONDUCTOR_CLASS_ID=1,SERVER_LIST=www01
ITA_NAME=exastro-ita01,SYMPHONY_CLASS_ID=2,SERVER_LIST=db01:db02
ITA_NAME=exastro-ita01,CONDUCTOR_CLASS_ID=1,SERVER_LIST={{ VAR_<条件名> }}
ITA_NAME=exastro-ita01,CONDUCTOR_CLASS_ID=1,MENU_ID=1,HOST_NAME=1:www01,CONVERT_FLG=FALSE
ITA_NAME=exastro-ita01,CONDUCTOR_CLASS_ID=1,MENU_ID=1,HOSTGROUP_NAME=1:web-group,CONVERT_FLG=FALSE
ITA_NAME=exastro-ita01,SYMPHONY_CLASS_ID=2,MENU_ID=2:3:4,HOST_NAME=2:www01,HOSTGROUP_NAME=3:db-group|4:app1-group&app2-group,CONVERT_FLG=FALSE
ITA_NAME=exastro-ita01,CONDUCTOR_CLASS_ID=1,CONVERT_FLG=TRUE
ITA_NAME=exastro-ita01,SYMPHONY_CLASS_ID=2,CONVERT_FLG=TRUE
ITA_NAME=exastro-ita01,CONDUCTOR_CLASS_ID=1,CONVERT_FLG=FALSE
ITA_NAME=exastro-ita01,SYMPHONY_CLASS_ID=2,CONVERT_FLG=FALSE
Mail 連携¶
Mailアクションパラメータ¶
パラメータ分類 |
パラメータ変数 |
パラメータ値 |
入力例 |
|---|---|---|---|
ドライバ名 |
MAIL_NAME |
Mailドライバ名。 必須項目です。 |
MAIL_NAME=management-mail |
通知先 |
MAIL_TO |
宛先エンベロープToのメールアドレスを指定します。 必須項目です。 |
|
MAIL_CC |
CCのメールアドレスを指定します。 必須項目ですが、パラメータ値記載無しも許容されます。 |
||
MAIL_BCC |
BCCのメールアドレスを指定します。 必須項目ですが、パラメータ値記載無しも許容されます。 |
MAIL_BCC= |
|
テンプレート |
MAIL_TEMPLATE |
アクション設定-メールテンプレートのテンプレート名を指定します。 必須項目ですが、パラメータ値記載無しも許容されます。 |
|
注釈
ユースケース¶
MAIL_NAME=management-mail,MAIL_TO=maintener@example.com,MAIL_CC=dev-team@example.com,MAIL_BCC=
MAIL_NAME=management-mail,MAIL_TO=,MAIL_CC=dev-team@example.com,MAIL_BCC=,MAIL_TEMPLATE=service-down
ServiceNow 連携¶
ServiceNowアクションパラメータ¶
パラメータ分類 |
パラメータ変数 |
パラメータ値 |
入力例 |
|---|---|---|---|
ドライバ名 |
SERVICENOW_NAME |
ServiceNowドライバ名。 必須項目です。 |
SERVICENOW_NAME=department01 |
ワークフロー |
WORKFLOW_ID |
実行したいワークフローが紐づく ワークフロースケジュールの sys_id を指定します。 ワークフロー連携時のみ記載します。 警告 ワークフローの sys_id でないことに注意して下さい。 |
WORLFLOW_ID=abcdef1234567890 |
インシデント |
INCIDENT_STATUS |
インシデントの起票、もしくは、更新するステータスを指定します。 インシデント管理時のみ記載します。 NEW: 新規インシデント起票時に指定します。 インシデント管理する場合は、必ず最初にマッチさせる必要があります。 IN_PROGRESS: ステータスを対処中にする場合に指定します。 通常、ルールの記述の際にはアクション実行直前のルールで指定します。 RESOLVED: ステータスを解決済みにする場合に指定します。 通常、ルールの記述の際にはアクション実行直後のルールで指定します。 CLOSED: ステータスをクローズにする場合に指定します。 通常、ルールの記述の際にはクローズ承認後のルールで指定します。 |
INCIDENT_STATUS=NEW INCIDENT_STATUS=IN_PROGRESS INCIDENT_STATUS=RESOLVED INCIDENT_STATUS=CLOSED |
WORK_NOTES_APPROVAL |
アクション実行の許可文字列を指定します。 ServiceNow の対応するインシデントの作業メモに許可文字列が記入された場合のみ処理を続行します。 許可文字列が記入されない場合、このアクションは処理中のまま何もしません。 |
WORK_NOTES_APPROVAL=APPROVED_ACTION WORK_NOTES_APPROVAL=APPROVED_CLOSE |
|
WORK_NOTES_REJECTED |
アクション実行の却下文字列を指定します。 ServiceNow の対応するインシデントの作業メモに却下文字列が記入された場合のみ処理を中止します。 却下文字列が記入されない場合、このアクションは処理中のまま何もしません。 |
WORK_NOTES_REJECTED=REJECTED_ACTION WORK_NOTES_REJECTED=REJECTED_CLOSE |
|
ユースケース¶
SERVICENOW_NAME=department01,WORKFLOW_ID=abcdef1234567890
SERVICENOW_NAME=department01,INCIDENT_STATUS=NEW
SERVICENOW_NAME=department01,INCIDENT_STATUS=CLOSED
SERVICENOW_NAME=department01,INCIDENT_STATUS=IN_PROGRESS,WORK_NOTES_APPROVAL=APPROVED_ACTION,WORK_NOTES_REJECTED=REJECTED_ACTION
インシデント管理のベストプラクティス¶
ルール名 |
条件 |
発生事象 |
対処概要 |
アクションパラメータ※ドライバ名省略 |
|---|---|---|---|---|
インシデント起票 |
アラート名が ".* is down" である場合 |
サービスダウン発生 |
インシデントを起票します。[APPROVAL_REQUEST] |
INCIDENT_STATUS=NEW |
処理中 |
アラート名が "httpd is down" である場合 |
Apache サービスダウン発生 |
サービス再開処理開始をします。 |
INCIDENT_STATUS=IN_PROGRESS |
ITA実行 |
アラート名が "httpd is down" である場合 |
Apache サービスダウン発生 |
サービス再開処理を実施します。 |
CONDUCTOR_CLASS_ID=3,OPERATION_ID=4 |
処理完了 |
アラート名が "httpd is down" である場合 |
Apache サービスダウン発生 |
サービス再開処理が完了しました。 |
INCIDENT_STATUS=RESOLVED |
インシデントクローズ(承認あり) |
アラート名が "httpd is down" である場合 |
Apache サービスダウン発生 |
インシデントをクローズします。対処内容を確認の上、問題なければクローズ承認をお願いします。 |
INCIDENT_STATUS=CLOSED,WORK_NOTES_APPROVAL=APPROVED_CLOSE,WORK_NOTES_REJECTED=REJECTED_CLOSE |
2022-01-11 10:45:35
ルール名 : インシデントクローズ(承認あり)
発生事象 : Apache サービスダウン発生
対処概要 : インシデントをクローズします。対処内容を確認の上、問題なければクローズ承認をお願いします。
==================================================
2022-01-11 10:45:32
ルール名 : 処理完了
発生事象 : Apache サービスダウン発生
対処概要 : サービス再開処理が完了しました。
==================================================
2022-01-11 10:43:34
ルール名 : 処理中(承認あり)
発生事象 : サービス再開処理を開始します。
対処概要 : OASEにより通常ページに切り替えを行います。この対処に問題なければ承認をお願いします。
==================================================
2022-01-11 10:43:32
ルール名 : インシデント起票
発生事象 : サービスダウン発生
対処概要 : インシデントを起票します。[APPROVAL_REQUEST]
