ServiceNow ITSMアプリのアラート配信チャネル
ServiceNow のITSM(ITサービス管理)アプリのアラートチャネルは、 Instana と ServiceNow の間でアラート通知を伝達します。 application.To が Instana から ServiceNow へアラート通知をリアルタイムで送信するには、 ServiceNow のITSMアプリケーションのアラートチャネルを作成してください。
この InstanaIBM アプリケーション で動作するこの ServiceNow プログラムは、以下の機能を提供します:
- Instana のイベントを、 ServiceNow のインシデントテーブル、または IBM の Instana の中間テーブルに転送します
- Instana のインシデントに関するメモおよびAIによるインシデント要約結果を、 IBM の Instana アプリケーションによって作成された対応する ServiceNow のインシデントに反映します
- Instana のイベント・クロージャーのステータスを、 ServiceNow のインシデントテーブル、または IBM や Instana の中間テーブルに反映します
- ServiceNow のインシデントテーブルから、作業メモ、追加コメント、およびフィールドの変更内容を Instana に反映します
- インシデントのステータスが
ResolvedまたはClosedに変更された場合、イベント閉鎖を伝播する
インストールの前提条件
Instana 現在、 SaaS でのデプロイのみをサポートしています。
ServiceNow アプリケーションは、以下の ServiceNow テーブルにアクセスします:
- インシデント(incident) 読み取り/書き込み
- 優先度データの検索 (dl_u_priority) 読み取り専用
- ユーザー (sys_user) 読み取り専用
- グループ (sys_user_group) 読み取り専用
- グループメンバー (sys_user_grmember) 読み取り専用
- テーブル (sys_db_object) 読み取り専用
- 辞書エントリ (sys_dictionary) 読み取り専用
Instana から伝播されたイベントは、イベントの種類に応じて、以下のいずれかの IBM Instana 中間テーブルに格納されます
- IBM Instana インシデント用 (x_ibm_instana_ibm_instana_for_incidents)
- IBM Instana 問題用 (x_ibm_instana_ibm_instana_for_issues)
- IBM Instana for Change (x_ibm_instana_ibm_instana_for_change)
- IBM Instana 監視用 (x_ibm_instana_ibm_instana_for_monitoring_issues)
Instana から ServiceNow へリアルタイムでアラート通知を送信するには、 ServiceNow のITSMアプリケーションアラートチャネルを作成してください。
ServiceNow のITSMアプリのアラートチャネルを作成する
ServiceNow での「 ServiceNow 」アプリケーションの設定
「 ServiceNow 」アプリが、 ServiceNow ストアで配信開始されました。 「 IBM 」アプリ( Instana )は、 ServiceNow のアプリストアからダウンロードしてインストールできます。 インストール手順の詳細については、 「インストールガイド」 をご覧ください。
ServiceNow でのユーザーの設定
Instana インスタンス内の ServiceNow ITSMアプリのアラートチャネルが、 ServiceNow 内の IBM Instana アプリケーションにアクセスするために使用するユーザーを作成する必要があります。
- クリック全て検索ユーザー管理。 クリックユーザー管理>ユーザー。
- 「新規」をクリックして、新規ユーザーを作成します。
- を入力ユーザーID 。 これはユーザーがこのサイトにサインインするときのユーザー名ですServiceNow実例。
- ユーザー情報に基づいて他のフィールドを入力し、クリックします提出するユーザーを作成します。
- Go 新しく作成されたユーザーページに移動し、 「パスワードを設定」 をクリックします。 ポップアップウィンドウで、生成するユーザーのパスワードを作成します。 パスワードはユーザーが初めてログインするときに必要となるため、コピーして保存してください。
- デフォルトでは、 パスワードの作成と保存が正常に完了すると、「パスワードをリセットする」チェックボックスがオンになります。 このチェックボックスをオフにします。
- 「 ID タイプ 」フィールドで 「マシン」 を選択します。 「 Identity タイプ 」フィールドが表示されない場合は、詳細について ServiceNow、 KB2420837、および KB2567879 を参照してください。
図 1. ServiceNow ユーザーを作成する 
- をクリックして、ユーザーへのアプリケーションアクセスを許可します。役割タブ。
- 「編集」 をクリックします。 「検索」タブで、 および
sn_incident_writeのx_ibm_instana.user役割を検索して選択します。 次に、それらをロール一覧に追加します。図 2. ServiceNow アクセス権を追加する 
- 「保存」をクリックして変更を保存します。
- クリックアップデート更新を保存します。 ユーザー ページで、ロールがロール リストに追加されます。 リストには3つ以上の役割が含まれています。
data_lookup_adminこれは、およびsn_incident_writeに複数のサブ役割が含まれているためです。
Instana でのアラートチャネルの設定
ServiceNow のアラートチャネルを作成するには、 Instana UIの左側のナビゲーションバーで、 [設定] > [グローバル設定 ] > [イベントとアラート] > [アラートチャネル] の順にクリックします。
「アラートチャネルを追加」 をクリックし、 「 ServiceNow 」ITSMアプリを選択します。
新しいチャネルの名前を入力します。
この統合では、基本的な認証方法を使用して、 ServiceNow アプリケーションのスクリプト化された REST API と連携します。
URL フィールドは、 Instana が通信を行う ServiceNow インスタンスのエンドポイントを指す必要があります。 例えば、
https://example.service-now.comです。ユーザー名フィールドには、ServiceNowアプリケーションにアクセスするためのロールを持つ既存のServiceNowユーザーの名前を指定する必要があります。 ユーザー名には、ServiceNowで作成したユーザーのユーザーIDを使用します。
パスワードフィールドには、ユーザー名フィールドに入力されたユーザーIDを持つServiceNowユーザーのパスワードを入力する必要があります。
[詳細設定] をクリックします。 以下の2つのラジオボタンオプションを使用して、 Instana と ServiceNow 間の双方向通信機能を有効にしてください。
Instana が ServiceNow のインシデントテーブルにイベントを送信できるようにする (デフォルト): IBM Instana の中間テーブルにイベントを伝播した後、このラジオボタンが選択されている場合、 IBM Instana アプリケーションは ServiceNow 内のインシデントテーブルを更新します。 これにより、 ServiceNow のインシデントが、 Instana のインシデントと連動して開閉され、 Instana と ServiceNow の間でメモやアクティビティが同期されます。 ServiceNow のインシデントテーブルを変更するための既存のビジネスルールも、通常通り機能します。 ServiceNow のインシデントテーブルにアクセスできるすべての ServiceNow ユーザーは、以下の5つのロールを持っている必要があります:
- x_ibm_instana.ibm_instana_for_tenants_user
- x_ibm_instana.ibm_instana_for_incidents_user
- x_ibm_instana.ibm_instana_for_change_user
- x_ibm_instana.ibm_instana_for_issue_user
- x_ibm_instana.ibm_instana_for_monitoring_issue_user
Instana の中継テーブルへの伝播のみを制限する :このラジオボタンが選択されている場合、 Instana はイベントデータのみを IBM および Instana の中継テーブルに伝播し、 ServiceNow のインシデントテーブルへの更新は行いません。 ServiceNow のビジネスルールでは、これらの IBM および Instana の中間テーブルにアクセスできます。
「作成」 をクリックして、 ServiceNow のアラートチャンネルを作成します。

アラートの例
[ Instana が ServiceNow のインシデントテーブルにイベントを送信することを許可する] オプションがオンになっている場合、以下の情報が ServiceNow のインシデントチケットの対応するフィールドに追加されます:
インシデントの 「概要」 フィールドには、 Instana のUIに表示されるイベントのタイトルが設定されます。
担当者フィールドが空の場合、インシデントの状態フィールドは
Newに設定されます。 このServiceNowインシデントチケットがServiceNow,で特定のユーザーに割り当てられている場合、状態はIn Progressになります。Instana では、イベントの重大度に応じて Impact フィールドが設定されます。 タイプで検出されたイベントのインシデント
online、offline、 そしてchange持っている3 - Lowインパクト。 タイプissue、およびmonitoring issueincidentのイベントの場合、 「影響 」フィールドの値は、 Instana におけるそれらの深刻度によって決まります。 Instana において、深刻Warning度が のイベントは の影響2 - Mediumを受け、深刻度が のイベントCriticalは の影響1 - Highを受けます。の説明フィールドはイベントの種類に応じて設定されます。 一般的に、これには他の Instana アラートチャネルを通じて送信される情報のほとんどが含まれています。 情報は次のように表現されます
Key: Valueフォーマット、--キーと値のペアのネストを示します。 ServiceNow のインシデントチケットの 「説明 」フィールドに、以下の情報が追加されます:「Type 」フィールドは、 Instana
event type内の値に基づいて設定され、issue、change、incidentが含まれます。各イベントタイプは、対応monitoring_issueする中間テーブルに保存されます。「提案 」フィールドは、 Instana 内の
fixed suggestion値に基づいて設定されます。「深刻度 」フィールドは、定義されたマッピング Instana に基づいて設定されます。値 は
-1を表しChange、5は を表しWarning、10は を表しCritical、その他の値は を表しますInfo。 ServiceNow 重大度の上位分類に対応しています。 Instana のイベントの深刻度が「 Instana 」から上位のレベルに引き上げられると、 ServiceNow のインシデントにおける対応するフィールド(例:UrgencyおよびPriority)が変更されます。 また、には接頭辞Severity Upgraded -が追加Short Descriptionされて更新されます。
この Descriptionフィールドは編集可能なため、 Instana は深刻度の引き上げ後もフィールドの値を更新しませんSeverity。 そのSeverityフィールドは元の値のままになります。「リンク 」フィールドには、 Instana 内の現在のインシデントのページへリダイレクトするウェブサイトのリンクが含まれています。
[設定] > [グローバル設定 ] > [イベントとアラート ] > [アラート ] で定義したカスタムペイロードは、 ServiceNow のインシデントフィールドに値を入力するために使用されます。
snow.close.この動作を有効にするには、 キー 名が または でsnow.open.始まる必要があります。 イベントの開始時には プレフィックスを使用してsnow.open.値を設定し、イベントの終了時には プレフィックスを使用しますsnow.close.。 プレフィックスに続くテキストは、 ServiceNow のインシデントテーブル内の対応するフィールドにマッピングされるターゲットフィールドを指定します。 たとえば、snow.open.categoryイベントが開始されると、 「カテゴリ 」フィールドに値が入力されます。 一致するフィールドが存在しない場合、その値は 「説明 」フィールドに追加されます。 これらのカスタムペイロードフィールドの一部は、 ServiceNow のインシデント情報ページで確認できます。 フィールドマッピングでは、 「概要 」、「 説明」、および「 優先度 」フィールドはサポートされていません。 この機能は、課題のモニタリングイベントではサポートされていません。ServiceNow, では
assignment_group、グループ名sys_idまたはグループ名の「」を使用して値を設定します。ServiceNow, では
assigned_to、ユーザーのユーザー名、ユーザーsys_idID、または を使用して値を設定します。 「 カスタムペイロード 」に フィールドとassigned_toフィールドassignment_groupの両方が追加されている場合は、 ServiceNow において、 ユーザーがassigned_toグループassignment_groupのメンバーであることを確認してください。 それ以外の場合は、フィールドassigned_toのみが設定され、assignment_groupは空になります。 有効なassigned_to値が設定されている場合、 InstanaStateのインシデントの値は、In Progressではなくに設定されますNew。その他の項目については:
- key : 「 snow.open 」 という接頭辞が付いた、 ServiceName のインシデントテーブルの列名 または snow.close。
- value : フィールドの値。 指定された値は、フィールドの型に変換されます。
sys_idユーザー型やグループ型以外の参照型の値を指定するには、. を使用します。
たとえば、 IBM のDLAを 「Configuration Item 」フィールドに設定するには、キーとしてフィールド名である「Configuration Item」を使用
snow.open.cmdb_ciし、値として「 IBM 」のsys_idDLAを使用46a0583aa9fe1981002a20ec72ca72f3します。

ServiceNow UIページ
ServiceNow アプリのいくつかのUIページには、 Instana のイベントに関する情報が表示されています。
ServiceNow インシデント一覧画面
ServiceNowincident のインシデントテーブルUIでタイプが指定されたイベントに対応する、 Instana のインシデントの例を以下に示します:

IBM Instana タブUI
ServiceNow のインシデントテーブルUIで、「 IBM Instana 」と表示されたタブをクリックすると、「 IBM Instana 」タブのUIに情報が表示されます:

IBM Instana 中間テーブルのUI
ナビゲーションバーから 「すべて 」をクリックし、「 IBM Instana 」と検索してください。 イベントの種類に応じてオプションを選択します。 インシデントについては、 IBM Instana をご覧ください。 中間テーブルが見える。

「 Instana 」イベントID の列にあるハイパーリンクをクリックすると、 IBM Instana の中間テーブルUIに移動します:

同様に、 IBM ( Instana )の中間テーブルUIでテナントテーブルを確認することもできます。ナビゲーションバーから 「All」 をクリックし、 「 IBM 」( Instana )を検索してください。 入居者の皆様は、 IBM または Instana をクリックしてください。 中間テーブルが見える。

「 Instana ID」 列のハイパーリンクをクリックすると、 IBM Instana の中間テーブルのUIに遷移します:

未解決の問題やインシデントについて
次の例をご覧ください。説明イベントに対応するインシデントのフィールドincidentタイプ:

メモとアクティビティを同期する
Instana の ServiceNow ITSMアプリのアラートチャネルで、「 Instana が ServiceNow のインシデントテーブルにイベントを送信することを許可する 」ラジオボタンを選択した場合、 Instana の未解決インシデントに追加したメモは、 ServiceNow のインシデントテーブルにある対応するインシデントに送信され、同期されます。 さらに、 ServiceNow のインシデントテーブルに追加または編集した作業メモ、追加コメント、およびアクティビティは、対応する Instana のインシデントと同期されます。
以下のシナリオでは、ノートとアクティビティの同期機能について説明します:
Instana に追加されたノートは、 ServiceNow に向けて発音され、同期されます。
- Instana にインシデントが作成され、「Kevin Wu」というユーザーによって 「メモとアクティビティ 」ウィンドウにメモが
Note Test (NB Event #3)追加されました。
- このメモは、対応する ServiceNow インシデントテーブルのUIにある「メモ」タブで確認できます。そこには、メモの内容、 IBM、 Instana のインスタンス情報、 IBM、 Instana のユーザー名、およびタイムスタンプが含まれています。

ServiceNow で追加または生成された作業メモやアクティビティは、 Instana に送信され、同期されます。
- これは、 Instana によって生成された ServiceNow のインスタンスです。

- 影響フィールドを
1 - Highから2 - Mediumに変更し、このインシデントをAntony AlldisからTash Dubrovskaに割り当て直す。 「 優先度 」フィールドも、「影響度 」フィールドに基づいて、から3 - Moderateへと変化します2 - High。
- 作業メモを1件追加し、さらにステップ2でユーザー
Work Notes Test by System admin (From ServiceNow)が行った更新内容について、もう1System Administrator件の作業メモを追加してください。 次に、 「更新 」ボタンをクリックしてください。
- 更新が完了すると、次のようなメッセージが表示されます。

- Go Instana の該当するインシデントページへ。 「 メモとアクティビティ 」ウィンドウでは、同期された作業メモとアクティビティを確認できます。

重大な問題や事案について
「 Instana 」 の 「 ServiceNow 」ITSMアプリのアラートチャネルで、「 Instana が ServiceNow のインシデントテーブルにイベントを送信することを許可する」ラジオボタンを選択すると、 Instana で対応するイベントがクローズされると、 ServiceNow のインシデントも自動的にクローズされます。 また、 ServiceNow のインシデントテーブルにおいて、対応するインシデントが手動で解決またはクローズされると、 Instana のインシデントまたは問題もクローズされます。
以下のシナリオでは、インシデントのクローズ機能について説明する:
Instana で解決済みとなったインシデントは、 ServiceNow に反映されます
Instana にインシデントが作成され、そのステータスは「アクティブ」です。

ServiceNowインシデント・テーブルのNewステートでこのインシデントを見つけることができます。

Instana でインシデントがクローズされると、 ServiceNow のインシデントテーブルでインシデントのステータスが同期されます。

同じ Instana のインシデントが、解決情報が反映された状態で ServiceNow に閉じられます。

Instana で対応するインシデントがクローズされた際、 ServiceNow のインシデントに対して設定するクローズ状態を選択できます。 現在、以下のクロージャ状態がサポートされています: 6 - Resolved、 7 - Closed、および 8 - Canceled。 テーブル IBM Instana for Tenants でマッピングのクロージャ状態を設定できます。
Go … IBM Instana for Tenantsを使用して、テーブル内の対応するレコードを… Instana ID 列から検索します。この列は {tenant unit}-{tenant} …形式で表示されます(例えば、 Instana のテナントが…で instana 、テナント単位が test…の場合、 Instana ID …は…となります test-instana)。 「」というコラムがあります Map Instana Closure Event。 ServiceNow のインシデント終了ステータスは、ステータス番号を使用して設定できます。 6 は に対応し Resolved、 7 は に対応し Closed、 8 は に対応します Canceled。 デフォルト値は. です 7 - Closed。
たとえば、値を Map Instana Closure Event デフォルト 7 - Closed からに変更し 6 - Resolved 、 Instana でインシデントがクローズされると、 ServiceNow のインシデントステータスがからに更新されます ResolvedNew 。

状態の更新に関する詳細情報は、[ Notes セクション] でご確認いただけます。

「 Instana 」イベントがクローズされた際、「 ServiceNow 」のインシデントステータスの更新を無効にすることができます。 また、 Instana でインシデントが作成された後、 ServiceNow のユーザーがそのインシデントを変更した際に、 ServiceNow のインシデントステータスが更新されないようにすることもできます。 この機能により、 ServiceNow のユーザーがインシデントに積極的に対応している間、 ServiceNow がインシデントの状態を自動的に「完了」に変更することを防ぎます。
Go IBM Instana の「Tenants」 ページで、 Instana のID 列(形式 {tenant unit}-{tenant} は)を使用して、テーブル内の該当するレコードを検索します。 たとえば、 Instana のテナントが instana で、テナントユニット testが の場合、 は として Instana ID 表示されます test-instana。 「更新時に状態を維持する」 チェックボックスをオンにすると、 Instana がイベントを閉じても、 ServiceNow がインシデントの状態フィールドを更新しなくなります。
ServiceNow で解決済みとなったインシデントは、 Instana に反映されます
Instana にインシデントが作成され、そのステータスは です
Active。
このインシデントは、ServiceNowインシデント・テーブルの
Newステートで見つけることができます。
ServiceNow のユーザーは、解決情報とともにインシデントの状態を
ClosedまたはResolvedに変更し、インシデントを更新します。
ServiceNow のインスタンスではこのインシデントがクローズされ、 Instana のインスタンスにもこのインシデントのクローズが通知されます。以下のプロンプトに示されている通りです:

インシデントの状態がクローズに変更される。

ユーザーが ServiceNow のインシデントテーブルに入力した、解決済みのインシデントの解決情報が、 Instana に送信されます。

オンライン時、オフライン時、または変更イベント発生時
次の例をご覧ください。説明イベントに対応するインシデントのフィールドchangeタイプ:

アンインストール
ServiceNow インスタンスから Instana ( ServiceNow )アプリケーションをアンインストールした後、 Instana にアクセスし、対応する ServiceNow ITSMアラートチャネルを手動で削除してください。
アラートチャンネルを削除するには:
- 「設定」 >「 グローバル設定」 >「 イベントとアラート 」>「 アラート配信先 」の順に選択します。
- 「 ServiceNow 」ITSMアラートチャネルを検索してください。
- 右側のゴミ箱アイコンをクリックして、アラートチャンネルを削除してください。
「 Instana 」 ServiceNow アプリケーションを再インストールする場合は、前述の設定手順に従って、新しくインストールされたアプリケーションの設定を行ってください。
ServiceNow とITSMの統合に関するエラーのトラブルシューティング
エラー 1: 503 サービス利用不可
メッセージ:
Failed to save: failed to send message to ServiceNow ITSM Application Integration {{ServiceNow instance URL}} with status code: 503. Reason: Service Unavailable
原因: このエラーは、 Instana から設定済みの ServiceNow インスタンスへの ` HTTP ` リクエストが失敗した場合に発生します。 これは通常、 ServiceNow のインスタンスが更新されたこと( URL )が原因で発生し、元のインスタンスは削除または無効化されています。
解決策:
- ServiceNow のインスタンス URL が最近更新された場合は、このエラーを無視して構いません。
- 更新した設定をもう一度保存してみてください。
エラー 2: スコープ間のアクセスは許可されていません
メッセージ:
Error: /api/x_ibm_instana/instana_manager, Unable to create incident JavaException: com.glide.script.fencing.CrossScopeAccessNotAllowedException: Access to ScopedGlideRecordSecure from scope x_ibm_instana not allowed
解決手順:
- ServiceNow コンソールで、スコープを 「Global」 から「 IBM 」に変更します。 Instana
- 「アプリケーション間アクセス 」テーブルを開きます(
sys_scope_privilege.list)。 - 以下の詳細で新しいエントリを追加してください:
Source Scope: IBM Instana (編集不可)Target Scope: グローバルTarget Name: ScopedGlideRecordSecureTarget Type: スクリプト対応Application: IBM Instana (編集不可)Operation: ` API ` を実行するStatus: 許可
