Présentation

Utilisez ce guide pour résoudre les problèmes liés à l’intégration Datadog OCI 1.

Problèmes d’intégration

Consultez les problèmes de configuration de votre intégration OCI sous l’onglet Issues de la tuile de l’intégration OCI.

Identifiants de Datadog API ou de clé d’application non valides

Cela se produit lorsque la clé d’API ou la clé d’application Datadog configurée dans l’intégration OCI a expiré ou n’est pas valide. Les deux clés sont validées lors d’un stack apply. Recherchez l’erreur suivante dans les logs de jobs de votre pile ORM pour confirmer:

Error: unexpected response code '403': {"errors":["Forbidden"]}

  with module.integration[0].restapi_object.datadog_tenancy_integration,
  on modules/integration/main.tf line 15, in resource "restapi_object" "datadog_tenancy_integration":
  15: resource "restapi_object" "datadog_tenancy_integration" {

Pour remédier à cela, générez de nouveaux identifiants et mettez à jour votre déploiement d’intégration :

1. Accédez à API Keys dans les paramètres de votre organisation Datadog et générez une nouvelle clé d’API.
2. Accédez à Application Keys dans les paramètres de votre organisation Datadog et générez une nouvelle application key.
3. Mettez à jour votre déploiement d’intégration avec les nouvelles clés et réappliquez-le.

Les autorisations OCI IAM requises sont manquantes

Datadog a reçu 403 une erreur lors de l’interrogation d’OCI, indiquant que toutes les autorisations OCI IAM nécessaires n’ont pas été accordées. Vérifiez la page Policies dans OCI pour vous assurer que les politiques dd-svc-policy et dd-dynamic-group possèdent toutes les autorisations read-only correctement configurées.

OCI tenancy atteignant la limite du hub de connecteur de service

Pour chaque OCI tenancy, au moins un hub de connecteur de service est requis par tranche de cinq compartiments. Demandez une augmentation de la limite de service dans votre compte OCI.

Impossible de collecter des données à partir d’une ou plusieurs régions souscrites

La fonction d’application utilisée pour transférer les métriques et les logs Datadog est introuvable. Pour remédier à cela, réappliquez la pile ORM de l’intégration Datadog existante dans votre OCI tenancy.

Note : Si vous avez spécifié les subnet OCIDs dans la section de configuration optionnelle, assurez-vous qu’il y a un subnet OCID par région souscrite. N’apportez aucune autre modification à la pile existante avant de la réappliquer.

Métriques non collectées

Effectuez les vérifications suivantes pour chaque région surveillée :

1. Dans le compartiment d’intégration, vérifiez que l’application de fonction dd-function-app existe.
2. Dans dd-function-app, vérifiez que la fonction dd-metrics-forwarder existe.
3. Si vous utilisez des sous-réseaux personnalisés, vérifiez qu’ils répondent aux autorisations (détaillées dans la note après l’étape 5).
4. Pour chaque hub de connecteur de service de métriques créé par Datadog, confirmez que sa cible de fonction est la fonction dd-metrics-forwarder dans dd-function-app. Les hub de connecteurs de métriques créés par Datadog utilisent le format dd-metrics-connectorhub-<suffix>. Si un hub de connecteur cible une application de fonction de transfert différente, supprimez-le et laissez-le être automatiquement reprovisionné.

Problèmes de destruction de la pile OCI

Si le job destroy échoue ou ne peut pas être exécuté :

1. Clonez le dépôt de l’intégration OCI et accédez au répertoire du dépôt.

2. Utilisez le script de nettoyage de l’intégration OCI pour supprimer les ressources restantes.

3. Définissez les variables requises.

4. Examinez un dry run:

   export OCI_PROFILE="<YOUR_OCI_PROFILE>"
   export COMPARTMENT_OCID="<YOUR_COMPARTMENT_OCID>"
   export TENANCY_OCID="<YOUR_TENANCY_OCID>"
   
   python3 oci-integration-cleanup/integration_cleanup.py \
     --profile "$OCI_PROFILE" \
     --compartment-ocid "$COMPARTMENT_OCID" \
     --dry-run true
   

5. Examinez les ressources dont la suppression est prévue dans le résultat du dry run. Si le résultat semble correct, exécutez le nettoyage :

   python3 oci-integration-cleanup/integration_cleanup.py \
     --profile "$OCI_PROFILE" \
     --compartment-ocid "$COMPARTMENT_OCID" \
     --confirm-tenancy-id "$TENANCY_OCID" \
     --region-workers <number of regions to be processed in parallel> \
     --dry-run false
   

Version d’intégration obsolète

Cela se produit lorsque la pile ORM de votre intégration Datadog ou votre module Terraform est obsolète. Pour y remédier, mettez à jour votre déploiement vers la dernière version et réappliquez-le. Pour obtenir des instructions concernant à la fois QuickStart (pile ORM) et Terraform, consultez Mettre à jour l’intégration.

Besoin d’aide supplémentaire ? Contactez le Datadog support.