1.2.327 swsn_increg(ServiceNowインシデント登録コマンド)

機能説明

ServiceNow ITSMのIncident Management機能と連携を行い、Systemwalker Centric Managerの監視イベントからServiceNow上にインシデントを登録します。

本コマンドは、Systemwalker Centric Managerのイベント監視の条件定義のアプリケーション起動アクションに設定して使用します。

本コマンドは、pyhtonコマンドから呼び出して利用するスクリプトです。

記述形式

python swsn_increg.py

[-i {1|2|3}] [-u {1|2|3}] -d IncidentDescription

※先頭の"python"は、サポートしているバージョンのpythonコマンドへのパスが設定されている場合の形式です。パスを設定していない場合は、サポートしているバージョンのpythonコマンドをフルパスで指定します。

オプション

-i:

ServiceNowに新たに登録するインシデントの影響度を指定します。

1:: 影響度をHighとします。

2:: 影響度をMediumとします。

3:: 影響度をLowとします。(省略時)

-u:

ServiceNowに新たに登録するインシデントの緊急度を指定します。

1:: 緊急度をHighとします。

2:: 緊急度をMediumとします。

3:: 緊急度をLowとします。(省略時)

-d:

ServiceNowに新たに登録するインシデントの内容を4096バイト以内で指定します。

インシデント内容に空白文字を含む場合は、「""」（ダブルクォーテーション）で括って指定してください。同様に「"」（ダブルクォーテーション）を含む場合は、「\"」でエスケープして指定してください。

登録するインシデント内容として複数の引数を指定することが可能です。複数指定する場合、インシデント内容として登録したい引数の間を空白(半角ブランク)で区切ります。空白で区切られた複数の引数は、1つに結合されServiceNow上にインシデント内容として登録されます。

本オプション以降のコマンドライン引数をすべてインシデント内容として受け付けます。

復帰値

0:: 正常終了

1:: 異常終了

参照

ServiceNowインシデント登録コマンドログファイル

ServiceNow上の作成インシデント詳細(ServiceNow連携)

コマンド格納場所

Windows	Systemwalkerインストールディレクトリ\MPWALKER\mpaosfsv\bin
Linux	/opt/FJSVfwaos/usr/bin

実行に必要な権限/実行環境

【Windows版】

Administrator権限が必要です。
運用管理サーバ/部門管理サーバで実行可能です。
本コマンドをコマンドプロンプトから実行する場合、[管理者として実行]を選択して起動したコマンドプロンプト上で実行してください。
本コマンドを実行するには、Python3の実行環境、および関連する外部ライブラリのインストールが必要です。
サポートしているPython3のマイナーバージョン、および必要な外部ライブラリについては、“Systemwalker Centric Manager 解説書”の“関連ソフトウェア資源”を参照してください。

【Linux版】

システム管理者(スーパーユーザ)権限が必要です。
運用管理サーバ/部門管理サーバで実行可能です。
本コマンドを実行するには、Python3の実行環境、および関連する外部ライブラリのインストールが必要です。
サポートしているPython3のマイナーバージョン、および必要な外部ライブラリについては、“Systemwalker Centric Manager 解説書”の“関連ソフトウェア資源”を参照してください。

注意事項

コマンドでエラーや警告が発生した場合、メッセージは、標準エラー出力、およびイベントビューアまたはsyslogに出力されます。

ただし、以下のエラーメッセージについては、イベントビューアまたはsyslogには出力されず、標準エラー出力、およびSystemwalkerコンソールの監視イベント一覧へ出力されます。

MpAosfB: ERROR: 8401: You do not have administrator privilege.

MpAosfB: ERROR: 8442: The %1 module is not installed.

MpAosfB: ERROR: 8499: An unexpected internal error occurred. Reason : %1.

使用例

【Windows版】

python C:\Systemwalker\MPWALKER\mpaosfsv\bin\swsn_increg.py -d "2023/10/22 19:34:33" "インシデントが発生しました。"

【Linux版】

python /opt/FJSVfwaos/usr/bin/swsn_increg.py -d "2023/10/22 19:34:33" "インシデントが発生しました。"

実行結果/出力形式

ServiceNow連携定義ファイル(sn_config)に設定したログレベルに応じたログが、ServiceNowインシデント登録コマンドログファイル(swsn_increg.log)に出力されます。出力されるログについては、“ServiceNowインシデント登録コマンドログファイル”を参照してください。

なお、コマンドでエラーや警告が発生した場合、上記のほかに、標準エラー出力、およびイベントビューアまたはsyslogにエラーメッセージが出力されます。出力されるエラーメッセージについては、“Systemwalker Centric Manager メッセージ説明書”を参照してください。