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 でのユーザーの設定

Instana インスタンス内の ServiceNow ITSMアプリのアラートチャネルが、 ServiceNow 内の IBM Instana アプリケーションにアクセスするために使用するユーザーを作成する必要があります。

  1. クリック全て検索ユーザー管理。 クリックユーザー管理>ユーザー
  2. 「新規」をクリックして、新規ユーザーを作成します。
  3. を入力ユーザーID 。 これはユーザーがこのサイトにサインインするときのユーザー名ですServiceNow実例。
  4. ユーザー情報に基づいて他のフィールドを入力し、クリックします提出するユーザーを作成します。
  5. Go 新しく作成されたユーザーページに移動し、 「パスワードを設定」 をクリックします。 ポップアップウィンドウで、生成するユーザーのパスワードを作成します。 パスワードはユーザーが初めてログインするときに必要となるため、コピーして保存してください。
  6. デフォルトでは、 パスワードの作成と保存が正常に完了すると、「パスワードをリセットする」チェックボックスがオンになります。 このチェックボックスをオフにします。
  7. ID タイプ 」フィールドで 「マシン」 を選択します。 「 Identity タイプ 」フィールドが表示されない場合は、詳細について ServiceNow、 KB2420837、および KB2567879 を参照してください。
    図 1. ServiceNow ユーザーを作成する
    ServiceNow ユーザーを作成する
  8. をクリックして、ユーザーへのアプリケーションアクセスを許可します。役割タブ。
  9. 編集」 をクリックします。 「検索」タブで、 および sn_incident_writex_ibm_instana.user 役割を検索して選択します。 次に、それらをロール一覧に追加します。
    図 2. ServiceNow アクセス権を追加する
    ServiceNow アクセス権を追加する
  10. 「保存」をクリックして変更を保存します。
  11. クリックアップデート更新を保存します。 ユーザー ページで、ロールがロール リストに追加されます。 リストには3つ以上の役割が含まれています。 data_lookup_adminこれは、および sn_incident_write に複数のサブ役割が含まれているためです。 ServiceNowユーザーを保存

Instana でのアラートチャネルの設定

  1. ServiceNow のアラートチャネルを作成するには、 Instana UIの左側のナビゲーションバーで、 [設定] > [グローバル設定 ] > [イベントとアラート] > [アラートチャネル] の順にクリックします。

  2. 「アラートチャネルを追加」 をクリックし、 「 ServiceNow 」ITSMアプリを選択します。

  3. 新しいチャネルの名前を入力します。

  4. この統合では、基本的な認証方法を使用して、 ServiceNow アプリケーションのスクリプト化された REST API と連携します。

    • URL フィールドは、 Instana が通信を行う ServiceNow インスタンスのエンドポイントを指す必要があります。 例えば、https://example.service-now.comです。

    • ユーザー名フィールドには、ServiceNowアプリケーションにアクセスするためのロールを持つ既存のServiceNowユーザーの名前を指定する必要があります。 ユーザー名には、ServiceNowで作成したユーザーのユーザーIDを使用します。

    • パスワードフィールドには、ユーザー名フィールドに入力されたユーザーIDを持つServiceNowユーザーのパスワードを入力する必要があります。

  5. [詳細設定] をクリックします。 以下の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 の中間テーブルにアクセスできます。

  6. 「作成」 をクリックして、 ServiceNow のアラートチャンネルを作成します。 ServiceNow アラート・チャンネルの作成

アラートの例

[ Instana が ServiceNow のインシデントテーブルにイベントを送信することを許可する] オプションがオンになっている場合、以下の情報が ServiceNow のインシデントチケットの対応するフィールドに追加されます:

  • インシデントの 「概要」 フィールドには、 Instana のUIに表示されるイベントのタイトルが設定されます。

  • 担当者フィールドが空の場合、インシデントの状態フィールドはNewに設定されます。 このServiceNowインシデントチケットがServiceNow,で特定のユーザーに割り当てられている場合、状態In Progressになります。

  • Instana では、イベントの重大度に応じて Impact フィールドが設定されます。 タイプで検出されたイベントのインシデントonlineoffline 、 そしてchange持っている3 - Lowインパクト。 タイプ issue、および monitoring issueincidentのイベントの場合、 「影響 」フィールドの値は、 Instana におけるそれらの深刻度によって決まります。 Instana において、深刻 Warning 度が のイベントは の影響 2 - Medium を受け、深刻度が のイベント Critical は の影響 1 - High を受けます。

  • 説明フィールドはイベントの種類に応じて設定されます。 一般的に、これには他の Instana アラートチャネルを通じて送信される情報のほとんどが含まれています。 情報は次のように表現されますKey: Valueフォーマット、--キーと値のペアのネストを示します。 ServiceNow のインシデントチケットの 「説明 」フィールドに、以下の情報が追加されます:

    • Type 」フィールドは、 Instanaevent type 内の値に基づいて設定され、 issuechangeincidentが含まれます。各イベントタイプは、対応 monitoring_issueする中間テーブルに保存されます。

    • 提案 」フィールドは、 Instana 内の fixed suggestion 値に基づいて設定されます。

    • 深刻度 」フィールドは、定義されたマッピング Instana に基づいて設定されます。値 は -1 を表し Change5 は を表し Warning10 は を表し Critical、その他の値は を表します Info。 ServiceNow 重大度の上位分類に対応しています。 Instana のイベントの深刻度が「 Instana 」から上位のレベルに引き上げられると、 ServiceNow のインシデントにおける対応するフィールド(例: Urgency および Priority)が変更されます。 また、には接頭辞 Severity Upgraded - が追加 Short Description されて更新されます。 ServiceNow 深刻度の引き上げ ServiceNow 深刻度の引き上げ この 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_id ID、または を使用して値を設定します。 「 カスタムペイロード 」に フィールドと 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_id DLAを使用 46a0583aa9fe1981002a20ec72ca72f3 します。

    ServiceNow カスタム・ペイロード

ServiceNow UIページ

ServiceNow アプリのいくつかのUIページには、 Instana のイベントに関する情報が表示されています。

ServiceNow インシデント一覧画面

ServiceNowincident のインシデントテーブルUIでタイプが指定されたイベントに対応する、 Instana のインシデントの例を以下に示します:

ServiceNow インシデントUI

IBM Instana タブUI

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

ServiceNow IBM Instana タブ

IBM Instana 中間テーブルのUI

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

ServiceNow IBM 中間テーブル UI

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

ServiceNow IBM 中間テーブル UI

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

ServiceNow IBM 中間テナント テーブル UI

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

ServiceNow IBM 中間テナント テーブル UI

未解決の問題やインシデントについて

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

ServiceNowオンラインインシデントの説明

メモとアクティビティを同期する

Instana の ServiceNow ITSMアプリのアラートチャネルで、「 Instana が ServiceNow のインシデントテーブルにイベントを送信することを許可する 」ラジオボタンを選択した場合、 Instana の未解決インシデントに追加したメモは、 ServiceNow のインシデントテーブルにある対応するインシデントに送信され、同期されます。 さらに、 ServiceNow のインシデントテーブルに追加または編集した作業メモ、追加コメント、およびアクティビティは、対応する Instana のインシデントと同期されます。

以下のシナリオでは、ノートとアクティビティの同期機能について説明します:

Instana に追加されたノートは、 ServiceNow に向けて発音され、同期されます。

  1. Instana にインシデントが作成され、「Kevin Wu」というユーザーによって 「メモとアクティビティ 」ウィンドウにメモが Note Test (NB Event #3) 追加されました。 ServiceNow Instana 注記
  2. このメモは、対応する ServiceNow インシデントテーブルのUIにある「メモ」タブで確認できます。そこには、メモの内容、 IBM、 Instana のインスタンス情報、 IBM、 Instana のユーザー名、およびタイムスタンプが含まれています。 ServiceNow 注釈

ServiceNow で追加または生成された作業メモやアクティビティは、 Instana に送信され、同期されます。

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

重大な問題や事案について

「 Instana 」 「 ServiceNow 」ITSMアプリのアラートチャネルで、「 Instana が ServiceNow のインシデントテーブルにイベントを送信することを許可する」ラジオボタンを選択すると、 Instana で対応するイベントがクローズされると、 ServiceNow のインシデントも自動的にクローズされます。 また、 ServiceNow のインシデントテーブルにおいて、対応するインシデントが手動で解決またはクローズされると、 Instana のインシデントまたは問題もクローズされます。

以下のシナリオでは、インシデントのクローズ機能について説明する:

Instana で解決済みとなったインシデントは、 ServiceNow に反映されます

  1. Instana にインシデントが作成され、そのステータスは「アクティブ」です。

    ServiceNow 発生中の事案

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

    ServiceNow ニュー州で発生中の事件

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

    ServiceNow Instana により件が解決されました

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

    ServiceNow 解決済みインシデントの同期

Instana で対応するインシデントがクローズされた際、 ServiceNow のインシデントに対して設定するクローズ状態を選択できます。 現在、以下のクロージャ状態がサポートされています: 6 - Resolved7 - 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 は に対応し Resolved7 は に対応し Closed8 は に対応します Canceled。 デフォルト値は. です 7 - Closed

たとえば、値を Map Instana Closure Event デフォルト 7 - Closed からに変更し 6 - Resolved 、 Instana でインシデントがクローズされると、 ServiceNow のインシデントステータスがからに更新されます ResolvedNew

ServiceNow 解決済みインシデントの同期

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

ServiceNow 解決済みインシデントの同期

「 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 に反映されます

  1. Instana にインシデントが作成され、そのステータスは です Active

    ServiceNow 発生中の事案

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

    ServiceNow ServiceNow における New 状態のアクティブなインシデント

  3. ServiceNow のユーザーは、解決情報とともにインシデントの状態を Closed または Resolved に変更し、インシデントを更新します。

    ServiceNow インシデントを解決またはクローズする

  4. ServiceNow のインスタンスではこのインシデントがクローズされ、 Instana のインスタンスにもこのインシデントのクローズが通知されます。以下のプロンプトに示されている通りです:

    ServiceNow 重大な事故

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

    ServiceNow Instana でインシデントがクローズされました

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

    ServiceNow Instana 内の「インシデント解決済み」情報

オンライン時、オフライン時、または変更イベント発生時

次の例をご覧ください。説明イベントに対応するインシデントのフィールドchangeタイプ:

ServiceNowオンラインインシデントの説明

アンインストール

ServiceNow インスタンスから Instana ( ServiceNow )アプリケーションをアンインストールした後、 Instana にアクセスし、対応する ServiceNow ITSMアラートチャネルを手動で削除してください。

アラートチャンネルを削除するには:

  1. 「設定」 >「 グローバル設定」 >「 イベントとアラート 」>「 アラート配信先 」の順に選択します。
  2. 「 ServiceNow 」ITSMアラートチャネルを検索してください。
  3. 右側のゴミ箱アイコンをクリックして、アラートチャンネルを削除してください。

「 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
 

解決手順:

  1. ServiceNow コンソールで、スコープを 「Global」 から「 IBM 」に変更します。 Instana
  2. アプリケーション間アクセス 」テーブルを開きます(sys_scope_privilege.list)。
  3. 以下の詳細で新しいエントリを追加してください:
    • Source Scope: IBM Instana (編集不可)
    • Target Scope: グローバル
    • Target Name: ScopedGlideRecordSecure
    • Target Type: スクリプト対応
    • Application: IBM Instana (編集不可)
    • Operation: ` API ` を実行する
    • Status: 許可

ServiceNow トラブルシューティング