Configuración del Amazon Q Developer Datadog complemento

Datadog es una plataforma de monitoreo y seguridad que proporciona monitoreo y análisis de infraestructura, aplicaciones y redes. Si usa Datadog para supervisar sus AWS aplicaciones, puede utilizar el Datadog complemento en el chat de desarrolladores de Amazon Q para acceder a la información de monitoreo sin salir del AWS Management Console.

Puede utilizar el Datadog complemento para obtener información Datadog, comprenda cómo funciona con AWS los servicios y pregunte por su Datadog estuches y monitores. Tras recibir una respuesta, puede hacer preguntas de seguimiento, por ejemplo, sobre cómo abordar un problema o para obtener más información sobre Datadog recursos.

Para configurar el complemento, debe proporcionar las credenciales de autenticación de su Datadog cuenta para habilitar una conexión entre Amazon Q y Datadog. Después de configurar el complemento, puede acceder a Datadog métricas @datadog añadiéndolas al principio de la pregunta en el chat de Amazon Q.

Requisitos previos

Agregar permisos

Para configurar los complementos, se requieren los siguientes permisos de nivel de administrador:

Adquiera credenciales

Antes de empezar, anote la siguiente información de su Datadog account. Estas credenciales de autenticación se almacenarán en AWS Secrets Manager secreto al configurar el complemento.

Secretos y funciones de servicio

AWS Secrets Manager secreto

Cuando configuras el complemento, Amazon Q crea un nuevo AWS Secrets Manager secreto para que lo guardes Datadog credenciales de autenticación. Como alternativa, puede usar un secreto existente que haya creado usted mismo.

Si crea un secreto usted mismo, asegúrese de que incluya las siguientes credenciales y utilice el siguiente formato JSON:

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

Para obtener más información sobre la creación de secretos, consulte Crear un secreto en la Guía del AWS Secrets Manager usuario.

Roles de servicio

Para configurar el Datadog en Amazon Q Developer, necesitas crear un rol de servicio que dé permiso a Amazon Q para acceder a tu secreto de Secrets Manager. Amazon Q asume esta función para acceder al secreto donde su Datadog se almacenan las credenciales.

Al configurar el complemento en la AWS consola, tiene la opción de crear un nuevo secreto o utilizar uno existente. Si creas un secreto nuevo, el rol de servicio asociado se crea automáticamente. Si utilizas un secreto existente y un rol de servicio existente, asegúrate de que tu rol de servicio contenga los siguientes permisos y tenga adjunta la siguiente política de confianza. El rol de servicio necesario depende del método de cifrado secreto.

Si el secreto está cifrado con una clave de KMS AWS administrada, se requiere la siguiente función de servicio de IAM:

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

Si el secreto está cifrado con una AWS KMS clave gestionada por el cliente, se requiere el siguiente rol de servicio de 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"
                }
            }
        }
    ]
}

Para permitir que Amazon Q asuma la función de servicio, la función de servicio necesita la siguiente política de confianza:

{
  "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}}"
        }
      }
    }
  ]
}

Para obtener más información sobre las funciones de servicio, consulte Crear una función para delegar permisos a un AWS servicio en la Guía del AWS Identity and Access Management usuario.

Configure el Datadog complemento

Los complementos se configuran en la consola de Amazon Q Developer. Amazon Q utiliza las credenciales almacenadas en AWS Secrets Manager para permitir las interacciones con Datadog.

Para configurar el Datadog complete el siguiente procedimiento:

Si quieres actualizar las credenciales de un complemento, debes eliminar el complemento actual y configurar uno nuevo. Al eliminar un complemento, se eliminan todas las especificaciones anteriores. Cada vez que configura un nuevo complemento, se genera un nuevo ARN de complemento.

Configure los permisos de usuario

Para usar los complementos, se requieren los siguientes permisos:

Cuando concedes acceso a una identidad de IAM a una entidad configurada Datadog complemento, la identidad obtiene acceso a todos los recursos del Datadog cuenta recuperable mediante el complemento. Datadog el plugin no detecta los permisos de usuario. Si desea controlar el acceso a un complemento, puede hacerlo especificando el ARN del complemento en una política de IAM.

Cada vez que se crea o se elimina y se vuelve a configurar un complemento, se le asigna un nuevo ARN. Si utilizas un ARN de complemento en una política, tendrás que actualizarlo si quieres conceder acceso al complemento recién configurado.

Para localizar el Datadog complemento ARN, vaya a la página de complementos de la consola de desarrolladores de Amazon Q y elija el configurado Datadog el complemento. En la página de detalles del plugin, copia el ARN del plugin. Puede agregar este ARN a una política para permitir o denegar el acceso al Datadog el complemento.

Si crea una política para controlar el acceso a Datadog complementos, especifique Datadog el nombre del complemento en la política.

Para ver ejemplos de políticas de IAM que controlan el acceso a los complementos, consultePermita a los usuarios chatear con complementos de un proveedor.

Chatea con el Datadog complemento

Para utilizar el Datadog plugin, introduce @datadog al principio de una pregunta sobre Datadog o los monitores y estuches de su AWS aplicación. También se deben incluir las preguntas de seguimiento o las respuestas a las preguntas de Amazon @datadog Q.

A continuación, se muestran algunos ejemplos de casos de uso y las preguntas asociadas que puede hacer para aprovechar al máximo Amazon Q Datadog el complemento: