Salesforce との統合（パブリック・プレビュー）
Instanaを使用して、 Salesforce インシデントを作成できるようになりました。
Instana UI で Salesforce アラート チャネルを作成すると、Instana から送信されるすべてのアラート通知を SalesforceSalesforce インシデントオブジェクトモデルを通じて送信できます。
Salesforce アラート・チャンネルの設定
Instana でアラートチャネルを設定する前に、 Salesforce 組織内に接続アプリを作成する必要があります。 セットアッププロセスの詳細については、 OAuth 2.0 クライアント資格フロー用の接続アプリを構成するを参照してください。
Salesforce 接続アプリの作成
セットアップページで、Instana に接続する Salesforce 接続アプリを以下のオプションで設定する必要があります：
接続アプリ名：インスタナに接続するアプリの名前
連絡先メールアドレス：問題をデバッグするためにInstanaに精通している組織内の誰かの電子メール
OAuth 設定を有効にします：Instana は OAuth を使用して Salesforce で認証するため、OAuth を有効にする必要があります。
コールバック URL : Salesforce とのサーバー間統合のクライアント資格情報フローにクライアント資格情報を使用するため、Instana は認証にコールバック URL を使用しません。 組織のインスタナ URL を入力できます。
https://<instana_org_name>.instana.io選択されたOAuthスコープ：以下のスコープを追加する必要があります：
- API（アピ）によるユーザーデータの管理
- いつでもリクエスト可能（refresh_token、offline_access）
クライアント資格情報フローを有効にする: Instana は Salesforce 統合の一部としてクライアント資格情報 OAuth フローを使用するため、クライアント資格情報フローを有効にする必要があります。
以下の接続アプリの設定例を参照してください：
フローの実行ユーザーを設定する
Salesforce 組織に実行ユーザーを設定する必要があります。 ユーザーに割り当てられたプロファイルに、 Salesforce インシデント オブジェクトの作成、読み取り、更新、および削除の権限があることを確認します。
パーミッションを設定するには、以下の手順に従ってください：
Salesforce UIで Administration > Users > Profilesをクリックしてプロファイルを作成する。 新しいプロファイルを作成したら、 Editをクリックして設定を編集します。 次に、次のスクリーンショットにあるように、新しいプロファイルがインシデントを「すべて変更」できるように、「 標準オブジェクト権限」 セクションを変更します：
必要に応じて、ユーザープロファイルを制限またはオープンに編集することができます。
このプロファイルを使用するユーザーを作成します。 このユーザーは、先に作成された接続アプリの実行ユーザーとして割り当てられる。 ユーザーを作成するには、[ 管理] > [ ユーザー ] > [ ユーザー ] > [ 新規ユーザー ]をクリックし、必要なデータを入力してから、以前に作成したユーザープロファイルを選択します。
新しく作成した接続アプリを表示し、[ 管理] をクリックして、先に作成した接続アプリに実行ユーザーとして作成したユーザーを追加します。
App Managerページで、 Edit Policiesをクリックします。
接続アプリポリシーページで、 クライアント資格情報フロー セクションまでスクロールし、すべての Salesforce インシデントオブジェクトを変更する権限を持つユーザー名を入力します。 その後、「 保存 」をクリックする。
現在では、接続されたアプリを使用して、組織内で Salesforce インシデントを作成および変更することができます。
Salesforce アラートチャンネルの設定
Instana UI で [設定 ] > [ アラートチャンネル ] > [ アラートチャンネルの追加 ] をクリックして、 Salesforce アラートチャンネルを追加する必要があります。
インシデントのリクエストを行い、ベアラートークンを生成するには、 Salesforce 組織 URL フィールドを組織の Salesforce インスタンス URL に指定する必要があります。 そのような例として、 URL https://<salesforce_org>.my.salesforce.com がある。 詳細については、 マイ・ドメイン・ホスト名、特に「ログイン」ホスト名タイプを参照してください。
アラートペイロードの詳細
アラートは、Instana UIでイベントがトリガーされたときに受信されます。 Salesforce アラート・チャンネルを作成すると、 URL エンドポイントが提供される。 受信したアラートペイロードは、この URL エンドポイントに送信される。
アラートペイロードには以下の情報が含まれる：
- 件名イベントのタイトル
- 説明説明には以下のフィールドが含まれます：
- Instana へのリンク
- イベントの説明
- エンティティー
- ホスト
- カスタム・ゾーン
- アベイラビリティー・ゾーン
- カスタム・ペイロード
- インシデントID
- DetectedDateTime ：イベントの開始時刻
- EndDateTime : イベントの終了時刻
- 影響 ：クリティカルな重大度を持つ Instana イベントは、
highインパクトにマッピングされる。 警告の重大度を持つInstanaイベントは、mediumの影響にマッピングされ、それ以外のイベントは、lowの影響にマッピングされる。 - IsMajorIncident ：重要度が
criticalのInstanaイベントは、trueに設定される。 - 優先度 ：
criticalの重要度を持つ Instana イベントは、criticalの優先度にマッピングされます。 重要度がwarningのInstanaイベントはmoderateの優先度にマップされ、それ以外のイベントはlowの優先度にマップされる。 - ReportedMethod ：インシデントが作成されたソース。 情報は常にInstanaにプリフィルドされる。
- StartDateTime : イベントの開始時刻
- ステータス開かれているInstanaイベントは、
newにマッピングされます。 クローズされたインスタナのイベントは、closedにマッピングされる。 インスタナのテストイベントはresolvedにマッピングされている。 - 緊急度 ：
criticalの重要度を持つ Instana イベントは、highの緊急度にマッピングされます。 重要度がwarningであるインスタナのイベントは、medium緊急度にマッピングされ、それ以外のイベントは、low緊急度にマッピングされる。
Salesforce との統合の一環として、Instana でオープンされたインシデントは、Instana でもクローズする必要があります。 クローズアラート通知が発信されると、Instanaは Salesforce インシデントのステータスを New から Closed に変更するリクエストを Salesforce に送信する。 他のアラート・チャンネルでは、新しいアラートのように見える閉じたアラート通知が別途届きます。 クローズ通知を送信しないアラートタイプは、 Salesforce インシデントの開始ステータスが resolved となる。
Salesforce インスタナで作成されたインシデントの例
次の例は、タイプ Issue でステータスが Resolved のテストイベントのアラートペイロードを示しています：
