インテグレーションコネクション

概要

インテグレーションコネクションを使用すると、Datadog インテグレーションにすでに構成されている資格情報を Datadog Workflows および Actions で使用できます。これにより、アクションごとに個別のコネクションを構成する必要がなくなり、外部サービスへのアクセスが簡素化されます。

サポートされているユースケース

インテグレーションコネクションは以下でサポートされています。

  • ServiceNow: 既存の ServiceNow インテグレーションインスタンスの資格情報を使用して、ServiceNow アクションを実行します。
  • AWS: 既存の AWS インテグレーションアカウントの資格情報を使用して、サポートされている読み取り専用の AWS アクションを実行します。サポートされている AWS アクションと権限の詳細については、AWS インテグレーションコネクションを参照してください。

その他のインテグレーションや操作については、コネクションを作成 してください。

構成

開始する前に、インテグレーションがアクティブであること、および使用するインテグレーションアカウントまたはインスタンスの編集権限があることを確認してください。

次の例では、ServiceNow インテグレーションコネクションを構成します。サポートされている AWS アクションについても、AWS の追加要件に従い、同様の一般的なプロセスを実行できます。

1. インテグレーション権限を構成する

ServiceNow インテグレーションインスタンスの Executor 権限を構成するには、以下の手順を実行します。

  1. Datadog で、Integrations に移動します。
  2. ServiceNow インテグレーションをクリックします。
  3. アクションの実行に使用する ServiceNow インスタンスを選択します。
  4. Set Permissions をクリックします。
    • Set Permissions ボタンではなく Request Edit Access ボタンが表示されている場合は、Datadog 組織の管理者に連絡し、インスタンスのエディターとして追加してもらいます。
  5. ユーザー、チーム、または組織を選択し、Add をクリックします。
  6. People with access で、Executor 権限を選択します。
  7. Save をクリックします。

2. アクションにインテグレーションを追加する

  1. Workflow Automation で、編集するワークフローをクリックします。
  2. ServiceNow アクションを追加します。
  3. 構成ペインで Connection ドロップダウンをクリックし、Existing ServiceNow Integrations までスクロールします。
  4. 前のステップで構成した ServiceNow インスタンスを選択します。
  5. Save をクリックします。

AWS インテグレーションコネクション

Datadog Workflows and Actions は、既存の Datadog AWS インテグレーション資格情報を使用して、AWS 環境で読み取り専用の操作を実行できます。Datadog は、Amazon EC2、RDS、S3 モニタリングなどのインテグレーションと同じ AWS 認証情報を使用して、サポートされている読み取り専用アクションを安全に実行します。

環境内で AWS アクションを実行するには、次の 2 つの方法があります。

  • ViewOnlyAccess 権限 ポリシーで許可されている読み取り専用アクションを実行するには、Datadog AWS インテグレーションを使用します。
  • ViewOnlyAccess 権限 に含まれていない操作については、特定の権限を持つ専用の AWS IAM ロールにリンクされたカスタム AWS コネクションを使用します。

サポートされている AWS アクション

例:

  • AWS リソース (ListECSClusters、DescribeInstances、GetBucketPolicy など) の一覧表示または記述
  • AWS サービス (GetFunctionConfiguration や ListSecrets など) からの構成またはメタデータの読み取り
  • リソースタグ、メトリクス、またはログの検査

その他の AWS アクションについては、代わりに 専用コネクション を使用してください。

AWS 要件

AWS インテグレーションコネクションでアクションを正常に実行するには、以下の手順に従います。

  • ロールの委任用に構成された AWS インテグレーション IAM ロールには、ecs:ListClusters など、目的の操作に必要な権限が必要です。
  • 選択されるアクションは読み取り専用でなければなりません。Put*、Delete*、Update* などの書き込みまたは変更アクションはサポートされておらず、実行時に失敗します。
  • アクションを実行するユーザー、チーム、または組織は、Datadog の AWS インテグレーションアカウントに対する明示的な Executor 権限を持っている必要があります。
Datadog AWS インテグレーションを使用したアクションの実行は、ロールの委任を通じて Datadog AWS インテグレーションをセットアップしたユーザーのみが利用できます。さらに、ViewOnlyAccess 権限に基づく操作は許可されていますが、Datadog AWS インテグレーションに関連付けられた IAM ロールに必要な権限がない場合があります。問題が発生した場合は、ロールに正しい権限があることを確認してください。

AWS インテグレーションコネクションを構成する前に、以下を確認してください。

  • AWS インテグレーションがターゲット AWS アカウントに対して有効であり、Datadog が AWS インテグレーションの問題を検出していないこと。AWS インテグレーションをまだ設定していない場合は、AWS インテグレーションの設定ガイド に従ってください。
  • インテグレーションに関連付けられた IAM ロールに、ecs:ListClusters などの必要な操作に対する権限があること。
  • 使用する AWS アカウントの権限を編集するアクセス権があること。

AWS インテグレーションアカウントの Executor 権限を構成するには、構成手順に従い、ServiceNow ではなく Amazon Web Services インテグレーションと関連する AWS アカウントを選択します。

アクションに AWS インテグレーションを追加するには、以下の手順を実行します。

  1. Workflow Automation で、編集するワークフローをクリックします。
  2. List ECS Clusters などの AWS アクションを追加します。
  3. 構成ペインで Connection ドロップダウンをクリックし、Existing AWS Integrations までスクロールします。
  4. 構成した AWS アカウントを選択します。
  5. Save をクリックします。