Instana と OAuth 認証の統合

  • リリースバージョン: Australia
  • 更新日 2026年06月17日
  • 所要時間：5分

    • OAuth 認証を使用して、Instana を イベント管理 と ServiceNow と統合します。

    始める前に

    イベント管理 Connectors (sn_em_connector) プラグインが ServiceNow AI Platform インスタンスにインストールされていることを確認します。

    必要なロール：evt_mgmt_admin

    手順

    1. ServiceNow インスタンスで設定します。
      1. OAuth インバウンド統合にクライアント認証情報の権限許可タイプを使用するには、「glide.oauth.inbound.client.credential.grant_type.enabled」システムプロパティを作成します。
        • タイプ：true|false
        • 値：true
        注:
        evt_mgmt_adminロールには作成権限がないため、アドミニストレーターはこのシステムプロパティを作成する必要があります。
      2. インスタンスにアクセスするクライアント用の OAuth エンティティエンドポイントを作成します。
        1. 移動先 すべて > システム OAuth > アプリケーションレジストリー [ New (新規)] を選択します。
        2. インターセプターページで、[外部クライアント用の OAuth API エンドポイントを作成します] を選択し、フォームに入力します。
        3. OAuth クライアントレコードを作成するには、[送信] を選択します。
      3. 作成した OAuth クライアントレコードに、OAuth アプリケーションユーザーとデフォルトの権限許可タイプを追加します。
        1. OAuth インバウンド統合にクライアント認証情報の権限許可タイプを使用するには、OAuth エンティティフォームに [OAuth アプリケーションユーザー] フィールドと [デフォルトの権限許可タイプ (Default Grant Type)] フィールドを追加します。
        2. 作成された OAuth クライアントレコードを開きます。
        3. ページヘッダーの [その他のオプション] アイコンを選択します。
        4. 選択 構成 > フォームレイアウト
        5. [フォームレイアウト] ページで、フィールドのリストから [OAuth アプリケーションユーザーとデフォルトの権限許可タイプ (OAuth Application User and Default Grant Type)] を追加します。
        6. フォームを保存または更新します。
        7. [OAuth アプリケーションユーザー] フィールドでユーザーを選択します。
          ユーザーには、Grafana によって送信されるイベントの作成に使用される evt_mgmt_integration ロールが必要です。
          注:
          適切な認証を確実に行うには、高い権限を持つユーザーではなく、evt_mgmt_integration ロールを持つ最小権限のユーザーを使用します。
        8. [デフォルトの権限許可タイプ (Default Grant Type)] フィールド値を [クライアント認証情報] に設定します。
    2. Instana コンソールで、 設定 > イベントとアラート > アラートチャネル.
    3. [ アラートチャネルを追加 ] ドロップダウンリストを開き、[ 汎用 Webhook ] オプションを選択します。
    4. [Webhook URL] フィールドに、次の URL を入力してアラートチャネルを作成します。
      https://<instance>.service-now.com/api/sn_em_connector/em/inbound_event?source=instana。
    5. [ OAuth を有効にする] 切り替えスイッチを有効にして、 ServiceNow URL を認証します。
      1. [ クライアント ID] フィールドに、 ServiceNow インスタンスで作成された OAuth エンティティクライアントのクライアント ID 値を入力します。
      2. [ クライアントシークレット ] フィールドに、 ServiceNow インスタンスで作成された OAuth エンティティクライアントのクライアントシークレット値を入力します。
      3. [トークン URL] フィールドに「https://<instance_name>.servicenow.com/oauth_token.do」と入力します。
      4. 統合をテストするには、[テストチャネル] を選択します
      5. [Save (保存)] を選択します。
    6. イベントタイプまたはイベントのアラートを作成するように Instana を設定します。
      1. 移動先 設定 > イベントとアラート > アラート.
      2. [新規アラート (New Alert)] を選択します。
      3. [イベント (Events)] セクションで、次のいずれかを選択します。
        • イベントタイプに関するアラート
        • イベントに関するアラート
      4. イベントタイプのアラートを作成する場合：
        1. [重大な問題 (Critical Issues)]、 [すべてのインシデント (All Incidents)]、[警告 (Warning issues)] の問題など、アラートを作成するイベントのタイプを選択します。
        2. [アラート (Alerting)] セクションで、servicenow アラートチャネルを選択します。
      5. イベントのアラートを作成する場合：
        1. アラートを作成するイベントを選択します。
        2. [アラート (Alerting)] セクションで、servicenow アラートチャネルを選択します。
      Instana でアラートが作成されると、アラートは ServiceNow インスタンスに送信されます。ホストエンティティに対して作成されたアラートはサーバー (cmdb_ci_server) テーブルにバインドされ、Web サイトエンティティに対して作成されたアラートは HTTP(S) (cmdb_ci_endpoint_http) テーブルにバインドされます。

      Instana - ci_type イベントフィールドマッピングテーブルに他のエンティティタイプを追加して、エンティティが ServiceNow インスタンスの正しい CI にバインドされるようにします。

    7. Instana ソースシステムでイベントを表示するには、ServiceNow インスタンスからアクセスします。
      1. 移動先 すべて > イベント管理 > サービスオペレーションワークスペース.
      2. [すべてのアラート (All Alerts)] を選択します。
      3. 関連するアラートを選択します。
      4. [詳細 (Details)] タブで、ページの右側にある [アクション (Actions)] セクションを見つけて、[Instana UI にイベントを表示 (Show Event on Instana UI)] セルで [アプリを起動] を選択します。