Amazon Q Developer Datadog プラグインの設定

Datadog は、インフラストラクチャ、アプリケーション、ネットワークのモニタリングと分析を提供するモニタリングおよびセキュリティプラットフォームです。Datadog を使用して AWS アプリケーションをモニタリングする場合は、Amazon Q Developer チャットの Datadogプラグインを使用して、 を離れることなくモニタリング情報にアクセスできます AWS Management Console。

Datadog プラグインを使用して、 について学びDatadog、 AWS サービスとの連携方法を理解し、Datadogケースやモニターについて質問できます。回答を受け取ったら、問題に対処する方法やDatadogリソースの詳細など、フォローアップの質問をすることができます。

プラグインを設定するには、Datadogアカウントから認証情報を指定して、Amazon Q と 間の接続を有効にしますDatadog。プラグインを設定したら、Amazon Q チャットで質問の先頭@datadogに を追加してDatadogメトリクスにアクセスできます。

前提条件

アクセス許可を追加する

プラグインを設定するには、次の管理者レベルのアクセス許可が必要です。

認証情報を取得する

開始する前に、 Datadog アカウントの次の情報を書き留めます。これらの認証情報は、プラグインを設定するときに AWS Secrets Manager シークレットに保存されます。

シークレットとサービスロール

AWS Secrets Manager シークレット

プラグインを設定すると、Amazon Q はDatadog認証情報を保存するための新しい AWS Secrets Manager シークレットを作成します。または、自分で作成した既存のシークレットを使用することもできます。

シークレットを自分で作成する場合は、次の認証情報が含まれ、次の JSON 形式を使用していることを確認してください。

{ 
   "ApiKey": "<your-api-key>", 
   "AppKey": "<your-applicaiton-key>" 
}

シークレットの作成の詳細については、「 AWS Secrets Manager ユーザーガイド」の「シークレットの作成」を参照してください。

サービス役割

Amazon Q Developer でDatadogプラグインを設定するには、Secrets Manager シークレットへのアクセス許可を Amazon Q に付与するサービスロールを作成する必要があります。Amazon Q は、Datadog認証情報が保存されているシークレットにアクセスするためにこのロールを引き受けます。

AWS コンソールでプラグインを設定する場合、新しいシークレットを作成するか、既存のシークレットを使用するかを選択できます。新しいシークレットを作成すると、関連するサービスロールが作成されます。既存のシークレットと既存のサービスロールを使用する場合は、サービスロールに次のアクセス許可が含まれ、次の信頼ポリシーがアタッチされていることを確認します。必要なサービスロールは、シークレットの暗号化方法によって異なります。

シークレットが マネージド KMS キーで暗号化されている場合は AWS 、次の IAM サービスロールが必要です。

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "secretsmanager:GetSecretValue"
            ],
            "Resource": [
                "arn:aws:secretsmanager:{{your-region}}:{{your-account-id}}:secret:[[secret-id]]"
            ]
        }
    ]
}

シークレットがカスタマーマネージド AWS KMS キーで暗号化されている場合は、次の IAM サービスロールが必要です。

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "secretsmanager:GetSecretValue"
            ],
            "Resource": "arn:aws:secretsmanager:{{region}}:{{accountId}}:secret:{{secretId}}"
        },
        {
            "Effect": "Allow",
            "Action": [
                "kms:Decrypt"
            ],
            "Resource": "arn:aws:kms:{{region}}:{{accountId}}:key/{{keyId}}",
            "Condition": {
                "StringEquals": {
                    "kms:ViaService": "secretsmanager.{{region}}.amazonaws.com"
                }
            }
        }
    ]
}

Amazon Q がサービスロールを引き受けることを許可するには、サービスロールに次の信頼ポリシーが必要です。

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "q.amazonaws.com"
      },
      "Action": ["sts:AssumeRole", "sts:SetContext"],
      "Condition": {
        "StringEquals": {
          "aws:SourceAccount": "{{accountId}}",
          "aws:SourceArn": "arn:aws:codewhisperer:{{region}}:{{accountId}}:profile/{{profileId}}"
        }
      }
    }
  ]
}

サービスロールの詳細については、「 AWS Identity and Access Management ユーザーガイド」の「 AWS サービスにアクセス許可を委任するロールの作成」を参照してください。

Datadog プラグインを設定する

Amazon Q Developer コンソールでプラグインを設定します。Amazon Q は、 に保存されている認証情報 AWS Secrets Manager を使用して、 とのやり取りを有効にしますDatadog。

Datadog プラグインを設定するには、次の手順を実行します。

プラグインの認証情報を更新する場合は、現在のプラグインを削除し、新しいプラグインを設定する必要があります。プラグインを削除すると、以前の仕様がすべて削除されます。新しいプラグインを設定するたびに、新しいプラグイン ARN が生成されます。

ユーザーアクセス許可を設定する

プラグインを使用するには、次のアクセス許可が必要です。

IAM ID に設定されたDatadogプラグインへのアクセスを許可すると、ID はプラグインによって取得可能なDatadogアカウント内のリソースへのアクセスを取得します。 Datadogユーザーのアクセス許可はプラグインによって検出されません。プラグインへのアクセスを制御する場合は、IAM ポリシーでプラグイン ARN を指定することで制御できます。

プラグインを作成または削除して再設定するたびに、新しい ARN が割り当てられます。ポリシーでプラグイン ARN を使用する場合は、新しく設定されたプラグインへのアクセスを許可する場合は、そのプラグインを更新する必要があります。

Datadog プラグイン ARN を見つけるには、Amazon Q Developer コンソールのプラグインページに移動し、設定されたDatadogプラグインを選択します。プラグインの詳細ページで、プラグイン ARN をコピーします。この ARN をポリシーに追加して、Datadogプラグインへのアクセスを許可または拒否できます。

Datadog プラグインへのアクセスを制御するポリシーを作成する場合は、ポリシーのプラグイン名Datadogに を指定します。

プラグインアクセスを制御する IAM ポリシーの例については、「」を参照してください1 つのプロバイダーのプラグインとのチャットをユーザーに許可する。

Datadog プラグインとチャットする

Datadog プラグインを使用するには、 Datadog または AWS アプリケーションモニターとケースに関する質問の冒@datadog頭に「」と入力します。Amazon Q からのフォローアップの質問または質問への回答には、 も含める必要があります@datadog。

以下は、Amazon Q Datadogプラグインを最大限に活用するためのユースケースの例と関連する質問です。