L’OCI QuickStart de Datadog est une expérience de configuration à flux unique entièrement gérée qui vous aide à surveiller votre infrastructure et vos applications OCI en quelques clics. OCI QuickStart crée l’infrastructure nécessaire pour transférer les métriques, les logs et les données de ressources vers Datadog, et découvre automatiquement les nouvelles ressources ou les compartiments OCI pour la collecte de données.

Choisissez la configuration QuickStart si…

• Vous configurez l’intégration OCI pour la première fois.
• Vous préférez un workflow basé sur l’interface utilisateur et souhaitez minimiser le temps nécessaire pour créer et configurer les ressources nécessaires.
• Vous souhaitez automatiser les étapes de configuration dans des scripts ou des pipelines CI/CD.

Prérequis de la configuration QuickStart

• Votre compte utilisateur OCI doit disposer du rôle Administrateur de domaine d’identité pour effectuer ces étapes.
• Vous devez être connecté à OCI dans le tenant avec lequel vous souhaitez effectuer l’intégration.
• Vous devez être connecté à OCI avec le Home Region sélectionné en haut à droite de l’écran.
• Votre compte utilisateur OCI doit être en mesure de créer un utilisateur, un groupe d’utilisateurs et un groupe dynamique dans le domaine d’identité auquel vous êtes connecté, ou dans le domaine cible si spécifié. Si vous fournissez un OCID de domaine cible, votre compte utilisateur OCI doit disposer de privilèges d’administrateur dans ce domaine.
• Votre compte utilisateur OCI doit être en mesure de créer des politiques dans le compartiment racine.

Instructions de configuration QuickStart

Pour configurer l’infrastructure de transfert de logs et de métriques vers Datadog :

• Configurer la tuile d’intégration Datadog OCI
• Déployer la pile ORM QuickStart
• Terminez la configuration dans Datadog
• Validez que les métriques circulent
• Configurez la collecte des métriques ou des logs (facultatif)
• Configurez la collecte des ressources (facultatif)

L’intégration nécessite l’utilisation d’Oracle Service Connector Hubs pour transférer les données vers Datadog. Il est recommandé de demander une augmentation de la limite de service avant de terminer la configuration. Le nombre approximatif de Service Connector Hubs dont vous avez besoin est :

$$\\text"Service Connector Hubs" = \\text"Nombre de compartiments dans le tenant" / \\text"5"$$

Configurez la tuile d’intégration Datadog OCI

1. Accédez à la tuile d’intégration Datadog OCI et cliquez sur Ajouter un nouveau tenant.

2. Sélectionnez ou créez une clé d’API Datadog à utiliser pour l’intégration.

3. Créez une clé d’application Datadog.

4. Activez ou désactivez les logs à l’aide du bouton bascule.

5. Activez ou désactivez la collecte d’événements à l’aide du bouton bascule.

6. Cliquez sur Créer une pile OCI. Cela vous redirige vers une pile Oracle Resource Manager (ORM) pour terminer le déploiement.
   Remarque : Déployez cette pile une seule fois par tenant.

Déployez la pile ORM QuickStart

1. Acceptez les conditions d’utilisation d’Oracle.

2. Laissez l’option d’utilisation de fournisseurs Terraform personnalisés décochée.

3. Utilisez le répertoire de travail par défaut pour déployer la pile, ou choisissez-en un autre en option.

4. Cliquez sur Suivant.

5. Datadog recommande de laisser la section (Optional) Choose specific subnet(s) vide pour créer un nouveau réseau cloud virtuel (VCN) et un sous-réseau dans chaque région de ce tenant.

   Facultativement, vous pouvez choisir des sous-réseaux existants (un maximum par région OCI) pour la pile Datadog QuickStart, auquel cas vous devez fournir à la pile les OCID des sous-réseaux. Entrez un OCID par ligne, sans virgules. La pile Datadog QuickStart est ensuite déployée dans la région correspondant à chaque sous-réseau. Chaque OCID de sous-réseau doit être au format : ocid1.subnet.oc[0-9].*. Par exemple, ocid1.subnet.oc1.iad.abcedfgh.
   Remarque : Si vous utilisez un VCN et des sous-réseaux existants, assurez-vous que le VCN dans chaque région :

   • Est autorisé à effectuer des appels de sortie HTTP via une passerelle NAT.
   • Dispose d’une passerelle de service qui prend en charge « All Services In Oracle Services Network ».
   • Possède les règles de table de routage pour autoriser la passerelle NAT et la passerelle de service.
   • Possède les règles de sécurité pour envoyer des requêtes HTTP.

6. Datadog recommande de laisser la section (Optional) Choose a User vide pour créer un nouvel utilisateur et un nouveau groupe. Le groupe et l’utilisateur sont créés dans le domaine d’identité OCI auquel vous êtes actuellement connecté (qui n’a pas besoin d’être le domaine par défaut).
   Facultativement, vous pouvez choisir un utilisateur et un groupe existants pour la pile Datadog QuickStart. Dans ce cas, Datadog déduit automatiquement le domaine de l’utilisateur et du groupe, et l’utilise pour créer des groupes dynamiques.
   a. ID de groupe : Fournissez l’OCID d’un groupe OCI existant pour l’authentification Datadog. S’il est fourni, l’ID utilisateur ne peut pas être laissé vide.
   b. ID utilisateur : Fournissez l’OCID d’un utilisateur OCI existant pour l’authentification Datadog. L’utilisateur doit être membre du groupe spécifié. S’il est fourni, l’ID de groupe ne peut pas être laissé vide.

7. Datadog recommande de laisser la section (Optional) Advanced configuration vide car ces cas d’utilisation sont rares.
   Facultativement, vous pouvez choisir un compartiment et un domaine existants pour la pile Datadog QuickStart.
   a. Compartiment : Choisissez un compartiment existant pour placer toutes les ressources créées par Datadog.
   b. Domaine : Fournissez l’OCID d’un domaine d’identité existant pour remplacer l’emplacement où l’utilisateur et le groupe sont créés. Ce champ n’est affiché que si un utilisateur et un groupe existants ne sont pas spécifiés à l’étape 6. S’il est fourni, l’adresse e-mail de l’utilisateur ne peut pas être laissée vide. Remarque : Votre compte utilisateur OCI doit disposer du rôle Administrateur de domaine d’identité dans le domaine cible.
   c. Tag de ressource : Fournissez une liste de balises définies à ajouter à toutes les ressources OCI déployées par la pile Datadog QuickStart. Saisissez une étiquette par ligne. N’ajoutez pas de virgules. Chaque étiquette définie doit être au format : namespace.key:value. Par exemple, CostCenter.Environment:prod. Si ce champ est laissé vide, aucune tag définie n’est ajoutée aux ressources OCI déployées par la pile Datadog QuickStart.
   

8. Cliquez sur Suivant.

9. Cliquez sur Créer et attendez jusqu’à 30 minutes que le déploiement se termine.

Terminez la configuration dans Datadog

Retournez sur la tuile d’intégration Datadog OCI et cliquez sur Ready!

Choisissez la configuration Terraform si…

• Vous gérez l’infrastructure en tant que code et souhaitez conserver l’intégration Datadog OCI sous contrôle de version.
• Vous devez configurer plusieurs dossiers ou projets de manière cohérente avec des blocs provider réutilisables.
• Vous souhaitez un processus de déploiement reproductible et auditable qui s’intègre dans votre environnement géré par Terraform.

Vous pouvez utiliser Terraform pour provisionner l’intégration Datadog OCI. Ce guide répertorie les prérequis, les variables requises et les étapes exactes pour initialiser, planifier et appliquer.

Prérequis de configuration Terraform

Disposez des éléments suivants avant de commencer :

• Terraform 1.x installé.
• Une clé d’API Datadog valide.
• Accès OCI avec le rôle d’administrateur de domaine d’identité sur le domaine cible.

Instructions de configuration Terraform

Pour configurer l’infrastructure de transfert de log et de métriques vers Datadog :

• Créer un fichier de configuration OCI
• Configurer le module Terraform
• Déployer avec Terraform
• Valider que les métriques circulent
• Configurer la collecte de métriques ou de log (facultatif)
• Configurer la collecte de ressources (facultatif)

Créer un fichier de configuration OCI

Le fichier ~/.oci/config accorde à Terraform les autorisations nécessaires pour créer des ressources dans OCI. Créez une clé d’API et ajoutez-la à votre configuration, ou suivez la documentation Oracle. Votre fichier devrait ressembler à ceci :

[DEFAULT]
user=<USER_OCID>
fingerprint=<USER_FINGERPRINT>
tenancy=<TENANCY_OCID>
region=<HOME_REGION>
key_file=<PATH_TO_PRIVATE_KEY_FILE>

Configurez le module Terraform

Les entrées suivantes configurent le module d’intégration Datadog OCI. Les champs obligatoires sont indiqués. Pour obtenir la liste complète des options de configuration disponibles, consultez la page d’ajout de tenancy.

1. Ajoutez une clé d’API Datadog.

Cliquez sur Sélectionner une clé d’API et sélectionnez une clé d’API à utiliser.

2. Créez une clé d’application Datadog.

Cliquez sur Créer ; une clé d’application est générée et ajoutée au champ. Assurez-vous de copier cette valeur et de l’enregistrer dans un emplacement sécurisé, car elle ne pourra plus être consultée après avoir quitté cet écran.

3. Ajoutez votre OCID de tenancy OCI.

1. Saisissez l’OCID de la tenancy à surveiller par Datadog. Vous le trouverez sur cloud.oracle.com/tenancy.
2. Optionnellement, choisissez un compartiment OCI et des sous-réseaux spécifiques. Datadog recommande de laisser cette section vide pour créer un nouveau compartiment OCI et un OCI Virtual Cloud Network (VCN) dans chaque région de la tenancy.

4. Ajoutez votre OCID d’utilisateur OCI.

Saisissez votre OCID d’utilisateur. Cet utilisateur doit disposer du rôle Administrateur de domaine d’identité. Trouvez-le sur cloud.oracle.com/identity/domains/my-profile.

5. Configurez la collecte des logs (facultatif).

Pour désactiver toute collecte de log depuis la tenancy, cliquez sur le bouton bascule. Si vous souhaitez désactiver la collecte de log pour des services OCI spécifiques, modifiez la configuration après l’installation dans la tuile d’intégration Datadog OCI.

6. Configurez la collecte des événements (facultatif).

Pour désactiver toute collecte d’événements depuis la tenancy, cliquez sur le bouton bascule. Pour désactiver la collecte d’événements après l’installation, modifiez la configuration dans la tuile d’intégration Datadog OCI.

7. Confirmez les détails de configuration du module Terraform généré.

Le module Terraform généré doit suivre le format indiqué ci-dessous :

module "datadog_oci" {
  source = "github.com/DataDog/oracle-cloud-integration//datadog-terraform-onboarding"

  datadog_api_key = <API_KEY>
  datadog_app_key = <APP_KEY>
  datadog_site    = <DATADOG_SITE>

  tenancy_ocid      = "<TENANCY_OCID>"
  current_user_ocid = "<CURRENT_USER_OCID>"

  logs_enabled              = true
  events_collection_enabled = true
}

Déployer avec Terraform

1. Copiez le module Terraform généré et collez-le dans un fichier .tf.
2. Exécutez terraform init && terraform apply pour initialiser Terraform et créer l’intégration. Si vous souhaitez prévisualiser les modifications, remplacez plan par apply.

Dépannage

Délais d’attente

Relancez la commande Terraform sans modifier la configuration.

Conflits de fournisseur

Si vous rencontrez des conflits de provider avec la commande terraform init, mettez à jour votre configuration de provider locale pour qu’elle corresponde aux versions requises par le module.

Avertissements dans Datadog immédiatement après la configuration

Prévoyez jusqu’à 15 minutes pour que les avertissements disparaissent.

Les sections Tags de compartiment et Limiter la collecte à des ressources spécifiques acceptent toutes deux des key:value tags OCI séparés par des virgules. Préfixez un tag avec ! pour l’inverser. Le séparateur virgule se comporte différemment selon les types de tags utilisés :

• Tags positifs uniquement : logique OU — inclus si l’objet OCI (compartiment ou ressource spécifique) possède l’un des tags listés.
• Tags négatifs uniquement (préfixés par !) : logique OU — exclu si l’un des tags négatifs est présent.
• Tags positifs et négatifs mixtes : logique ET — doit satisfaire toutes les conditions listées pour être inclus.

Exemple :

• datadog:monitored,env:prod* : inclure si l’un ou l’autre des tags est présent.
• !env:staging,!testing:true : exclure si l’une ou l’autre tag est présente.
• datadog:monitored,!region:us-phoenix-1 : inclure uniquement si la tag datadog:monitored est présente et que la balise region:us-phoenix-1 est absente.

Format de clé de tag : Datadog normalise les clés de tag OCI en minuscules snake_case avant d’effectuer la correspondance. Les clés définies dans OCI en camelCase ou PascalCase (par exemple, deploymentType ou DeploymentType) sont stockées et mises en correspondance sous leur équivalent en minuscules snake_case (deployment_type). Utilisez des minuscules snake_case lors de la spécification des filtres de tag dans la tuile d’intégration.

Prérequis : Avant d’appliquer la mise à jour, vérifiez que la clé d’application Datadog configurée dans votre pile OCI est toujours valide. Si la clé a expiré ou a été révoquée, la tâche de destruction échoue. Pour mettre à jour la clé, modifiez les variables de pile datadog_app_key dans la console OCI et fournissez une clé d’application valide avant de continuer.

Exécutez les commandes suivantes depuis OCI Cloud Shell pour mettre à jour votre pile vers la dernière version et appliquer les modifications :

curl -fL -o datadog-integration.zip \
  "https://github.com/DataDog/oracle-cloud-integration/releases/latest/download/datadog-integration.zip"

export STACK_ID="<YOUR_STACK_OCID>"
export OCI_CLI_REGION="<YOUR_HOME_OR_STACK_REGION>"

oci resource-manager stack update \
  --stack-id "$STACK_ID" \
  --config-source datadog-integration.zip \
  --region "$OCI_CLI_REGION" \
  --force

oci resource-manager job create-apply-job \
  --stack-id "$STACK_ID" \
  --execution-plan-strategy AUTO_APPROVED \
  --region "$OCI_CLI_REGION" \
  --wait-for-state SUCCEEDED

Remplacez les valeurs d’espace réservé :

• <YOUR_STACK_OCID> : L’OCID de votre pile ORM Datadog. Trouvez-le sur cloud.oracle.com/resourcemanager/stacks.

• <YOUR_HOME_OR_STACK_REGION> : La région d’origine de votre location (par ex. us-ashburn-1).

Prérequis : Avant de réappliquer Terraform, vérifiez que la variable datadog_app_key dans votre configuration Terraform contient une clé d’application Datadog valide. Si la clé a expiré ou a été révoquée, la commande de destruction échoue. Mettez à jour la valeur dans votre fichier .tf ou via un fichier terraform.tfvars avant de continuer.

Relancez Terraform pour initialiser le module mis à jour et appliquer les dernières modifications :

terraform init -upgrade && terraform apply

Optionnellement, exécutez terraform plan avant apply pour prévisualiser les modifications.

Prérequis : Avant d’exécuter la tâche de destruction, vérifiez que la clé d’application Datadog configurée dans votre pile OCI est toujours valide. Si la clé a expiré ou a été révoquée, la tâche de destruction échoue. Pour mettre à jour la clé, modifiez les variables de pile dans la console OCI et fournissez une clé d’application valide avant de continuer.

1. Accédez à Oracle Resource Manager (ORM) dans la console OCI.

2. Localisez la pile Datadog QuickStart qui a été créée lors de l’installation. Par défaut, la pile est étiquetée comme datadog-integration.zip-<NUMBER>, mais elle pourrait avoir été configurée avec un nom personnalisé lors du déploiement.

3. Exécutez une tâche Destroy sur la pile pour supprimer toutes les ressources créées par l’intégration dans toutes les régions.

   

4. Facultatif, supprimez la stack OCI Datadog une fois la destruction terminée.

Remarque : L’exécution de la tâche de suppression une fois sur la stack QuickStart nettoie automatiquement toutes les ressources dans toutes les régions où l’intégration a été déployée.

Prérequis : Avant d’exécuter la commande de suppression, vérifiez que la variable datadog_app_key dans votre configuration Terraform contient une clé d’application Datadog valide. Si la clé a expiré ou a été révoquée, la commande de suppression échoue. Mettez à jour la valeur dans votre fichier .tf ou via un fichier terraform.tfvars avant de continuer.

Assurez-vous que le profil DEFAULT dans ~/.oci/config dispose des identifiants utilisateur pour gérer les ressources dans la location correspondante, puis exécutez :

terraform destroy

- Allow dd-svc-admin to read all-resources in tenancy
- Allow dd-svc-admin to use tag-namespaces in tenancy
- Allow dd-svc-admin to manage serviceconnectors in Datadog compartment
- Allow dd-svc-admin to manage functions-family in Datadog compartment
- Allow dd-svc-admin to use fn-invocation in Datadog compartment
- Allow dd-svc-admin to manage buckets in Datadog compartment where target.bucket.name=/dd-*/
- Allow dd-svc-admin to manage object-family in Datadog compartment where target.bucket.name=/dd-*/
- Endorse dd-svc-admin to read objects in tenancy usage-report
- Allow dd-svc-admin to manage cloudevents-rules in tenancy where any {request.permission = 'EVENTRULE_CREATE', target.resource.tag.DatadogManaged.marker = 'true'}
- Allow dd-svc-admin to manage streams in Datadog compartment where any {request.permission = 'STREAM_CREATE', target.resource.tag.DatadogManaged.marker = 'true'}
- Allow service objectstorage-<REGION> to manage object-family in Datadog compartment where target.bucket.name=/dd-*/

Remarque : L’instruction Allow service objectstorage-<REGION> doit être ajoutée une fois par région souscrite (par exemple, objectstorage-us-ashburn-1, objectstorage-ap-batam-1). Cela permet à Datadog de nettoyer automatiquement les anciennes données dans les compartiments gérés par Datadog via des politiques de cycle de vie des objets.