Datadog/Amazon CloudFormation

​ AWS CloudFormation vous fournit des modèles afin de décrire, de configurer et de provisionner simultanément toutes les ressources AWS de votre environnement. Les ressources Datadog/AWS CloudFormation vous permettent d’interagir avec les ressources Datadog prises en charge, d’envoyer des ressources à un datacenter Datadog et d’ajouter de façon privée une extension dans n’importe quelle région possédant des ressources Datadog.

Pour accéder à ces ressources, utilisez AWS Management Console (IU) ou l’interface de ligne de commande AWS (CLI).

AWS Management Console

Pour commencer :

1. Connectez-vous à AWS Management Console à l’aide de votre compte et accédez à CloudFormation.

2. Sélectionnez Public extensions dans le volet de gauche, puis filtrez l’option Publisher sur Third Party.

3. Utilisez la barre de recherche pour appliquer un filtre basé sur le préfixe « Datadog ».

Remarque : toutes les ressources Datadog officielles commencent par Datadog::. Elles comportent également le message Published by Datadog.

4. Sélectionnez le nom de ressource de votre choix pour afficher plus d’informations sur son schéma, puis cliquez sur Activate.

5. Sur la page Extension details, indiquez les éléments suivants :

• Le nom de l’extension
• L’ARN du rôle d’exécution
• Les mises à jour automatiques pour les versions mineures
• La configuration

6. Pour la configuration de la ressource, il est fortement recommandé d’utiliser AWS Secrets Manager ou un service similaire afin de stocker vos clés d’API et d’application Datadog au lieu d’utiliser du texte en clair.

Avec AWS Secrets Manager, vous pouvez pointer de façon dynamique vers vos clés d’API et d’application dans la configuration. Pour en savoir plus, consultez la [documentation AWS18 (en anglais).

Par exemple :

{
  "DatadogCredentials": {
      "ApiKey": "{{resolve:secretsmanager:MySecret:SecretString:SecretAPIKey}}",
      "ApplicationKey": "{{resolve:secretsmanager:MySecret:SecretString:SecretAppKey}}"
  }
}

7. Une fois votre ressource configurée, créez une pile AWS qui comprend une ou plusieurs des ressources Datadog activées.

Pour en savoir plus sur les commandes et les workflows disponibles, consultez la documentation AWS officielle (en anglais).

Interface de ligne de commande AWS

Pour commencer :

1. Dans votre terminal, utilisez l’outil aws-cli pour ajouter une ressource Datadog :

   aws cloudformation register-type \
       --region "<REGION>" \
       --type RESOURCE \
       --type-name "<DATADOG_RESOURCE_NAME>" \
       --schema-handler-package "<LINK_TO_S3>"
   

2. Pour visualiser la version de la ressource que vous venez d’ajouter, exécutez ce qui suit dans votre terminal :

   aws cloudformation list-type-versions \
   --region "<REGION>" \
   --type RESOURCE \
   --type-name "<DATADOG_RESOURCE_NAME>"
   

3. Définissez cette version comme version default en exécutant ce qui suit dans votre terminal :

   aws cloudformation set-type-default-version \
       --region "<REGION>" \
       --type RESOURCE \
       --version-id <VERSION_ID> \
       --type-name "<DATADOG_RESOURCE_NAME>"
   

   Assurez-vous de remplacer les paramètres fictifs suivants :

   • <REGION> : votre région AWS.
   • <DATADOG_RESOURCE_NAME> : le nom de la ressource à ajouter. Consultez le tableau ci-dessous pour vérifier les ressources prises en charge.
   • <LINK_TO_S3> : le lien S3 vers la ressource.
     • S3 link : s3://datadog-cloudformation-resources/<DOSSIER_RESSOURCE>/<DOSSIER_RESSOURCE>-<VERSION_RESSOURCE>.zip
     • Consultez la section Ressources disponibles pour obtenir des exemples de liens S3 récents pris en charge.
   • VERSION_ID : la version sous-jacente de la ressource, telle que spécifiée dans la sortie de la commande à l’étape 2.

4. Définissez la nouvelle configuration de ressource ajoutée en exécutant ce qui suit dans votre terminal :

   aws cloudformation set-type-configuration \
       --type-name "<DATADOG_RESOURCE_NAME>" \
       --type RESOURCE \
       --configuration '{"DatadogCredentials": {"ApiKey": "{{resolve:secretsmanager:MySecret:SecretString:SecretAPIKey}}", "ApplicationKey": "{{resolve:secretsmanager:MySecret:SecretString:SecretAppKey}}"}}'
   

5. Dans votre compte AWS, créez une pile AWS qui comprend les ressources Datadog ajoutées.

Pour en savoir plus sur les commandes et les workflows disponibles, consultez la documentation AWS officielle (en anglais).

Ressources disponibles

Les ressources Datadog suivantes peuvent être ajoutées à votre compte AWS. Consultez la documentation à leur sujet pour découvrir comment les configurer :

Régions prises en charge

Les ressources Datadog/Amazon CloudFormation sont disponibles dans le registre public de CloudFormation dans les régions suivantes :

Remarque : pour ajouter de façon privée une ressource dans une autre région, utilisez les packages fournis.

Dépannage

Besoin d’aide ? Contactez l’assistance Datadog.