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

Remarques :

• Seules les métriques sont envoyées par défaut. Activez la collecte de logs et la collecte de données de ressources depuis le carré d’intégration OCI Datadog une fois la configuration terminée.
• Toutes les régions commerciales OCI existant au 15 juillet 2025 sont prises en charge. Les régions OCI ajoutées après cette date ne sont pas actuellement prises en charge.

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

• Configurer le carré d’intégration OCI Datadog
• Déployer la stack QuickStart
• Finaliser la configuration dans Datadog
• Vérifier que les métriques sont transmises
• Configurer la collecte de métriques (facultatif)
• Configurer la collecte de logs (facultatif)

L’intégration nécessite l’utilisation d’Oracle Service Connector Hubs pour transférer des 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 nécessaires est le suivant :

$$\text"Service Connector Hubs" = \text"Nombre de compartiments dans la tenancy" / \text"5"$$

Carré d’intégration OCI Datadog

1. Accédez au carré d’intégration OCI Datadog et cliquez sur Add New Tenancy.
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. Cliquez sur Create OCI Stack. Vous accédez alors à une stack Oracle Resource Manager (ORM) pour terminer le déploiement.
   Note : ne déployez cette stack qu’une seule fois par tenancy.

Stack ORM

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 stack, ou choisissez-en un autre si vous le souhaitez.
4. Cliquez sur Next, puis de nouveau sur Next.
   
5. Cliquez sur Create et attendez jusqu’à 15 minutes que le déploiement se termine.

Terminer la configuration dans Datadog

Revenez au carré d’intégration OCI Datadog et cliquez sur Ready!

Validation

Consultez les métriques oci.* dans le dashboard de présentation de l’intégration OCI ou sur la page Metrics Explorer dans Datadog.

Configuration

Une fois la configuration terminée, un onglet de configuration pour la tenancy devient disponible sur le côté gauche du carré d’intégration OCI Datadog. Appliquez les configurations de collecte de données à l’échelle de la tenancy comme indiqué dans les sections ci-dessous.

Ajouter des régions

Dans l’onglet General, sélectionnez les régions pour la collecte de données dans la liste de cases à cocher Regions. Les sélections de régions s’appliquent à l’ensemble de la tenancy, pour les métriques et les logs.

Remarque : si vous avez utilisé la méthode de configuration QuickStart et que vous avez ensuite souscrit à une nouvelle région OCI, réappliquez la stack de configuration initiale dans ORM. La nouvelle région est alors disponible dans le carré OCI Datadog.

Collecte de métriques et de logs

Utiliser les onglets Metric collection et Log collection pour configurer les métriques et les logs envoyés à Datadog :

• Activer ou désactiver la collecte de métriques ou de logs pour l’ensemble de la tenancy
• Inclure ou exclure des compartiments spécifiques en fonction des tags de compartiment au format key:value. Par exemple :
  • datadog:monitored,env:prod* inclut les compartiments si l’un ou l’autre de ces tags est présent
  • !env:staging,!testing exclut les compartiments uniquement si les deux tags sont présents
  • datadog:monitored,!region:us-phoenix-1 inclut les compartiments qui ont à la fois le tag datadog:monitored et n’ont pas le tag region:us-phoenix-1
• Activer ou désactiver la collecte pour des services OCI spécifiques

Remarques :

• Après avoir modifié des tags dans OCI, les modifications peuvent prendre jusqu’à 15 minutes pour s’afficher dans Datadog
• Dans OCI, les tags ne sont pas hérités par les compartiments enfants ; chaque compartiment doit être tagué individuellement

Collecte de ressources

Dans l’onglet Resource Collection du carré d’intégration OCI Datadog, cliquez sur le bouton Enable Resource Collection. Les ressources sont visibles dans le Catalogue de ressources Datadog.

Pour transférer vos métriques OCI vers Datadog :

• Saisir les informations de la tenancy
• Déployer la stack de stratégies OCI dans la région d’origine de votre tenancy pour créer un utilisateur, un groupe et des stratégies en lecture seule Datadog
• Saisir les informations de DatadogROAuthUser dans Datadog
• Déployer la stack de transfert de métriques OCI pour chaque région de tenancy à partir de laquelle vous souhaitez transférer des métriques
• Finaliser la configuration dans Datadog
• Vérifier que les métriques sont transmises
• Configurer la collecte de métriques (facultatif)
• Configurer la collecte de logs (facultatif)

Pour une représentation visuelle de cette architecture, consultez la section Architecture.

Saisir les informations de la tenancy

Saisissez l’OCID et la région d’origine de la tenancy que vous souhaitez surveiller dans le carré d’intégration OCI Datadog.

• Vous pouvez trouver ces informations sur la page de détails de la tenancy.
• Saisissez la région d’origine à l’aide de la valeur Region Identifier de la page des régions et domaines de disponibilité OCI.

Créer une stack de stratégies OCI

Cette stack de stratégies Oracle Resource Manager (ORM) ne doit être déployée qu’une seule fois par tenancy.

1. Cliquez sur le bouton Create Policy Stack dans le carré d’intégration OCI Datadog.
2. Acceptez les conditions d’utilisation d’Oracle.
3. Laissez l’option d’utilisation de fournisseurs Terraform personnalisés décochée.
4. Utilisez le nom et le compartiment par défaut de la stack, ou indiquez éventuellement votre propre nom descriptif ou compartiment.
5. Cliquez sur Next.
6. Laissez les champs de tenancy et d’utilisateur actuel tels quels.
7. Cliquez sur Next.
8. Cliquez sur Create.

Saisir les informations de DatadogROAuthUser

1. Dans la barre de recherche de la console OCI, recherchez DatadogROAuthUser et cliquez sur la ressource User qui s’affiche.
2. Copiez la valeur OCID de l’utilisateur.
3. Collez la valeur dans le champ User OCID du carré d’intégration OCI Datadog.
4. De retour dans la console OCI, générer une clé d’API en suivant ces étapes :
   a. Dans le coin inférieur gauche de l’écran, sous Resources, cliquez sur API keys.
   b. Cliquez sur Add API key.
   c. Cliquez sur Download private key.
   d. Cliquez sur Add.
   e. Une fenêtre contextuelle Configuration file preview s’affiche, mais aucune action n’est nécessaire. Fermez cette fenêtre.

5. Copiez la valeur de l’empreinte et collez-la dans le champ Fingerprint du carré d’intégration OCI Datadog.
6. Copier la valeur de la clé privée en suivant ces étapes : a. Ouvrez le fichier de clé privée .pem téléchargé dans un éditeur de texte, ou utilisez une commande de terminal telle que cat pour afficher le contenu du fichier. b. Copiez l’intégralité du contenu, y compris -----BEGIN PRIVATE KEY----- et -----END PRIVATE KEY-----.
7. Collez la valeur de la clé privée dans le champ Private Key du carré d’intégration OCI Datadog.

Créer une stack de transfert de métriques OCI

La stack de transfert de métriques doit être déployée pour chaque combinaison de tenancy et de région à surveiller. Pour une configuration plus simple, Datadog recommande de créer toutes les ressources OCI nécessaires avec la stack Oracle Resource Manager (ORM) fournie ci-dessous. Vous pouvez également utiliser votre infrastructure réseau OCI existante.

Toutes les ressources créées par la stack ORM de Datadog sont déployées dans le compartiment spécifié et pour la région actuellement sélectionnée en haut à droite de l’écran.

1. Cliquez sur le bouton Create Metric Stack dans le carré d’intégration OCI Datadog.
2. Acceptez les conditions d’utilisation d’Oracle.
3. Laissez l’option Custom providers décochée.
4. Nommez la stack et sélectionnez le compartiment dans lequel la déployer.
5. Cliquez sur Next.
6. Dans le champ Datadog API Key, saisissez la valeur de votre clé d’API Datadog.
7. Dans la section Network options, laissez l’option Create VCN cochée.

8. Dans la section Metrics settings, supprimez éventuellement des namespaces de métriques de la collecte.
9. Dans la section Metrics compartments, saisissez une liste d’OCID de compartiments à surveiller, séparés par des virgules. Les filtres de namespaces de métriques sélectionnés à l’étape précédente sont appliqués à chaque compartiment.
10. Dans la section Function settings, sélectionnez GENERIC_ARM. Sélectionnez GENERIC_X86 si vous effectuez un déploiement dans une région japonaise.
11. Cliquez sur Next.
12. Cliquez sur Create.
13. Revenez au carré d’intégration OCI Datadog et cliquez sur Create Configuration.

Remarques :

• Par défaut, seul le compartiment racine est sélectionné et tous les espaces de nommage de métriques de l’étape 8 présents dans le compartiment sont activés (jusqu’à 50 espaces de nommage sont pris en charge par connector hub). Si vous choisissez de surveiller des compartiments supplémentaires, les espaces de nommage qui leur sont ajoutés sont une intersection des espaces de nommage sélectionnés et des espaces de nommage présents dans le compartiment.
• Vous devez gérer les personnes ayant accès aux fichiers d’état Terraform des stacks du gestionnaire de ressources. Pour plus d’informations, consultez la section Terraform State Files de la page Securing Resource Manager.

1. Suivez les étapes de la section de configuration pour créer l’infrastructure nécessaire au transfert des métriques et des logs vers Datadog.
2. Cliquez sur le bouton Enable Log Collection dans l’onglet Log Collection du carré d’intégration OCI Datadog.

1. Configurez un log OCI.
2. Créez une fonction OCI.
3. Configurez un Service Connector OCI.

Les instructions ci-dessous utilisent le portail OCI pour configurer l’intégration.

Journalisation OCI

1. Depuis le portail OCI, accédez à Logging -> Log Groups.
2. Sélectionnez votre compartiment et cliquez sur Create Log Group. Un panneau latéral s’ouvre.
3. Saisissez data_log_group comme nom, et indiquez éventuellement une description et des tags.
4. Cliquez sur Create pour configurer votre nouveau groupe de logs.
5. Sous Resources, cliquez sur Logs.
6. Cliquez sur Create custom log ou Enable service log selon vos besoins.
7. Cliquez sur Enable Log pour créer un log OCI.

Pour plus d’informations sur les logs OCI, consultez Activation de la journalisation pour une ressource.

Fonciton OCI

1. Depuis le portail OCI, accédez à Functions.
2. Sélectionnez une application existante ou cliquez sur Create Application.
3. Créez une nouvelle fonction OCI dans votre application. Pour plus de détails, consultez Oracle Overview of Functions.
4. Il est recommandé de créer d’abord une fonction Python générique et de remplacer les fichiers générés automatiquement par le code source de Datadog :
   • Remplacer func.py par le code du référentiel OCI Datadog
   • Remplacer func.yaml par le code du référentiel OCI Datadog. DATADOG_TOKEN et DATADOG_HOST doivent être remplacés par votre clé d’API Datadog et le lien d’intake de logs de la région
   • Remplacer requirements.txt par le code du référentiel OCI Datadog

Service Connector Hub OCI

1. Depuis le portail OCI, accédez à Logging -> Service Connectors.
2. Cliquez sur Create Service Connector pour être redirigé vers la page Create Service Connector.
3. Sélectionnez Logging dans le champ Source et Functions dans le champ Target.
4. Sous Configure Source Connection, sélectionnez un Compartment name, un Log Group, et un Log. Le Log Group et le Log sont ceux créés au cours de la première étape.
5. Si vous souhaitez également envoyer des Audit Logs, cliquez sur +Another Log et sélectionnez le même Compartment tout en remplaçant « _Audit » comme Log Group.
6. Sous Configure target, sélectionnez un Compartment, une Function application et une Function. (Function Application et Function créées à l’étape précédente)
7. Si vous êtes invité à créer une stratégie, cliquez sur Create depuis l’invite.
8. Cliquez sur Create en bas de la page pour terminer la création de votre Service Connector.

Pour plus d’informations sur OCI Object Storage, consultez l’article de blog Oracle sur Service Connector.

1. Configurez un log OCI.
2. Créez un stockage d’objets OCI et autorisez l’accès en lecture/écriture pour les logs OCI.
3. Créez une fonction OCI.
4. Configurez un événement OCI.

Les instructions ci-dessous utilisent le portail OCI pour configurer l’intégration.

Journalisation OCI

1. Depuis le portail OCI, accédez à Solutions and Platform -> Logging -> Logs.
2. Cliquez sur Create Custom Log pour être redirigé vers la page Create Custom Log.
3. Nommez votre nouveau log OCI.
4. Sélectionnez un Compartment et un Log Group. Ces sélections resteront inchangées tout au long de l’installation.
5. Cliquez sur Create Custom Log pour être redirigé vers la page Create Agent Config.
6. Cliquez sur Create new configuration.
7. Nommez votre nouvelle configuration. Votre compartiment est déjà sélectionné.
8. Définissez le type de groupe sur Dynamic Group et définissez le groupe sur l’un de vos groupes existants.
9. Définissez le type d’entrée sur Log Path, indiquez le nom d’entrée de votre choix et utilisez “/” pour les chemins d’accès des fichiers.
10. Après avoir cliqué sur Create Custom Log, votre log OCI est créé et devient disponible sur la page des logs.

Pour plus d’informations sur les logs OCI, consultez Activation de la journalisation pour une ressource.

Object Storage OCI

1. Depuis le portail OCI, accédez à Core Infrastructure -> Object Storage -> Object Storage.
2. Cliquez sur Create Bucket pour être redirigé vers le formulaire Create Bucket.
3. Définissez le niveau de stockage sur Standard, puis cochez Emit Object Events.
4. Complétez le reste du formulaire selon vos préférences.
5. Après avoir cliqué sur Create Bucket, votre compartiment est créé et devient disponible dans la liste des compartiments.
6. Sélectionnez votre nouveau compartiment dans la liste des compartiments actifs et cliquez sur Logs dans la section Resources.
7. Activez read, ce qui vous dirige vers un menu latéral Enable Log.
8. Sélectionnez le même Compartment et le même Log Group que pour votre log OCI.
9. Saisissez un nom via le champ Log Name, puis sélectionnez la rétention des logs de votre choix.

Pour plus d’informations sur OCI Object Storage, consultez Stockage de données dans Object Storage.

Fonciton OCI

1. Depuis le portail OCI, accédez à Solutions and Platform -> Developer Services -> Functions.
2. Sélectionnez une application existante ou cliquez sur Create Application.
3. Créez une nouvelle fonction OCI dans votre application. Pour plus de détails, consultez Présentation de Functions.
4. Il est recommandé de créer d’abord une fonction Python générique et de remplacer les fichiers générés automatiquement par le code source de Datadog :
   • Remplacer func.py par le code du référentiel OCI Datadog
   • Remplacer func.yaml par le code du référentiel OCI Datadog. DATADOG_TOKEN et DATADOG_HOST doivent être remplacés par votre clé d’API Datadog et le lien d’intake de logs de la région
   • Remplacer requirements.txt par le code du référentiel OCI Datadog

Événement OCI

1. Depuis le portail OCI, accédez à Solutions and Platform -> Application Integration -> Event Service.
2. Cliquez sur Create Rule pour être redirigé vers la page Create Rule.
3. Saisissez un nom et une description pour la règle de votre événement.
4. Définissez la condition sur Event Type, le nom de service sur Object Storage, et le type d’événement sur Object - Create.
5. Définissez votre type d’action sur Functions.
6. Assurez-vous que le compartiment de votre fonction correspond à celui que vous avez sélectionné pour le log OCI, le compartiment OCI et la fonction OCI.
7. Sélectionnez votre application de fonctions et votre fonction (conformément à l’étape d’installation précédente).
8. Après avoir cliqué sur Create Rule, votre règle est créée et devient disponible dans la liste des règles.

Pour plus d’informations sur OCI Object Storage, consultez Introduction à Events.

Ressources de transfert de métriques et de logs

Pour chaque région surveillée, cette option de configuration crée l’infrastructure suivante dans cette région pour transférer les métriques et les logs vers Datadog :

• Application de fonctions (dd-function-app)
• Deux fonctions :
  • Redirecteur de métriques (dd-metrics-forwarder)
  • Redirecteur de logs (dd-logs-forwarder)
• VCN (dd-vcn) avec une infrastructure réseau sécurisée :
  • Sous-réseau privé (dd-vcn-private-subnet)
  • Passerelle NAT (dd-vcn-natgateway) pour l’accès externe à Internet
  • Passerelle de service (dd-vcn-servicegateway) pour l’accès interne aux services OCI
• Coffre-fort Key Management Service (KMS) (datadog-vault) pour stocker la clé d’API Datadog
• Compartiment Datadog dédié (Datadog)

Toutes les ressources sont taguées avec ownedby = "datadog".

Ressources IAM

Cette option de configuration crée les ressources IAM suivantes pour activer le transfert de données vers Datadog :

• Utilisateur de service (dd-svc)
• Groupe (dd-svc-admin) auquel appartient l’utilisateur de service
• Paire de clés RSA pour l’authentification à l’API
• Clé d’API OCI pour l’utilisateur de service
• Groupe dynamique (dd-dynamic-group-connectorhubs) qui inclut tous les connecteurs de service dans le compartiment Datadog
• Groupe dynamique (dd-dynamic-group-function) qui inclut toutes les fonctions dans le compartiment Datadog
• Stratégie (dd-svc-policy) pour accorder à l’utilisateur de service un accès en lecture aux ressources de la tenancy, ainsi que l’accès pour gérer les OCI Service Connector Hubs et les fonctions OCI dans le compartiment créé et géré par Datadog

- Allow dd-svc-admin to read all-resources in tenancy
- Allow dd-svc-admin to manage serviceconnectors in Datadog compartment
- Allow dd-svc-admin to manage functions-family in Datadog compartment with specific permissions:
     * FN_FUNCTION_UPDATE
     * FN_FUNCTION_LIST
     * FN_APP_LIST
- Endorse dd-svc-admin to read objects in tenancy usage-report

• Stratégie dd-dynamic-group-policy pour permettre aux connecteurs de service de lire les données (logs et métriques) et d’interagir avec les fonctions. Cette stratégie permet également aux fonctions de lire les secrets dans le compartiment Datadog (les clés d’API et d’application Datadog stockées dans le coffre-fort KMS)

   - Allow dd-dynamic-group-connectorhubs to read log-content in tenancy
   - Allow dd-dynamic-group-connectorhubs to read metrics in tenancy
   - Allow dd-dynamic-group-connectorhubs to use fn-function in Datadog compartment
   - Allow dd-dynamic-group-connectorhubs to use fn-invocation in Datadog compartment
   - Allow dd-dynamic-group-functions to read secret-bundles in Datadog compartment

Ressources de transfert de métriques

Cette option de configuration crée un connector hub OCI, une application de fonctions et une infrastructure réseau sécurisée pour transférer les métriques OCI vers Datadog. La stack ORM pour ces ressources crée un référentiel de conteneurs de fonctions pour la région dans la tenancy, et l’image Docker y est envoyée pour être utilisée par la fonction.

Ressources IAM

Cette option de configuration crée :

• Groupe dynamique avec resource.type = 'serviceconnectors', pour activer l’accès au connector hub
• Utilisateur nommé DatadogROAuthUser, utilisé par Datadog pour lire les ressources de la tenancy
• Groupe auquel l’utilisateur créé est ajouté pour l’accès aux stratégies
• Utilisateur nommé DatadogAuthWriteUser, utilisé pour envoyer des images Docker pour la fonction
• Groupe d’accès en écriture auquel DatadogAuthWriteUser est ajouté, pour l’envoi d’images via l’accès aux stratégies
• Stratégie dans le compartiment racine pour permettre aux connector hubs de lire les métriques et d’invoquer des fonctions. Cette stratégie accorde également au groupe d’utilisateurs créé un accès en lecture aux ressources de la tenancy et au groupe d’accès en écriture, pour l’envoi d’images

Allow dynamic-group Default/<GROUP_NAME> to read metrics in tenancy
Allow dynamic-group Default/<GROUP_NAME> to use fn-function in tenancy
Allow dynamic-group Default/<GROUP_NAME> to use fn-invocation in tenancy
Allow group Default/<USER_GROUP_NAME> to read all-resources in tenancy
Allow group Default/<WRITE_USER_GROUP_NAME> to manage repos in tenancy where ANY {request.permission = 'REPOSITORY_READ', request.permission = 'REPOSITORY_UPDATE', request.permission = 'REPOSITORY_CREATE'}