Cette traduction automatique est fournie pour votre commodité.
En cas d'incohérence entre la version anglaise et la version traduite, la version anglaise prévaudra. Veuillez visiter cette page pour plus d'informations.
Si vous rencontrez des problèmes avec l’intégration OCI, commencez ici.
Résoudre les problèmes liés aux logs
Si vos log OCI n’apparaissent pas, s’arrêtent de manière inattendue, s’affichent en double, ou affichent les noms de ressources de manière incorrecte, commencez par la vérification de l’état ci-dessous, puis trouvez votre problème spécifique dans les sections qui suivent.
Bilan de santé
Ces deux vérifications vous indiquent si le problème se situe en amont dans OCI (rien à vérifier dans New Relic pour le moment), ou si les logs ont réellement atteint New Relic :
Vérifiez votre connecteur dans OCI. Dans la console OCI, accédez à Connector Hub, et ouvrez le compartiment où vous avez déployé votre intégration New Relic. Recherchez un connecteur nommé newrelic-logs-<region>-audit (par exemple, newrelic-logs-us-ashburn-1-audit), et confirmez que son statut est Active. Si vous voyez un statut d’erreur, ouvrez le connecteur pour obtenir les détails de l’erreur.
Vérifiez que les logs arrivent dans New Relic. Exécutez cette requête dans Interrogez vos données:
SELECTcount(*)FROM Log WHERE oracle.loggroupid ='_Audit' SINCE 30 minutes ago
Un nombre supérieur à zéro signifie que les log d’audit sont transmis. Si vous effectuez le dépannage d’un autre type de log, vérifiez plutôt que vous voyez des résultats récents pour la fenêtre de temps correspondante.
Si les deux contrôles semblent sains, votre problème correspond probablement à l'un des scénarios spécifiques ci-dessous, plutôt qu'à une panne totale.
Faites correspondre ce que vous voyez à la cause probable :
Si vous voyez ceci
Essayez ceci
Vous venez de terminer la configuration et rien n’est encore apparu
Veuillez patienter un peu. Lorsque vous créez un connecteur pour la première fois, OCI peut mettre un certain temps à récupérer l’activité récente ; pour les logs d’audit, cela peut prendre jusqu’à 24 heures pour les événements historiques, bien que les nouveaux événements apparaissent généralement en quelques minutes.
Aucun connecteur n’apparaît dans Connector Hub du tout
Rouvrez votre configuration : si vous avez utilisé l’assistant de configuration guidée, confirmez que vous avez activé l’option correspondante et réexécutez-le. Si vous avez utilisé Terraform, confirmez que votre configuration inclut le connecteur de log et réappliquez-la.
Vous avez des ressources dans plus d’une région OCI
Confirmez que chaque région dispose de son propre connecteur, que vous vérifiez la région attendue, et répétez la configuration pour toutes les régions supplémentaires.
L’UI de New Relic affiche une erreur d’accès/autorisation lors du chargement des compartiments, ou des groupes de logs
Faites correspondre ce que vous voyez à la cause probable :
Si vous voyez ceci
Essayez ceci
Le connecteur dans OCI n’est plus Active
Ouvrez le connecteur dans Connector Hub, et vérifiez les détails de son erreur. Une modification des autorisations en est généralement la cause (voir Autorisations manquantes), ou quelqu’un a redéployé, ou remplacé l’intégration sous-jacente.
Le connecteur est Active, mais aucun nouveau log n’apparaît
Dans la console OCI, accédez à Functions et confirmez que la fonction d’intégration New Relic est déployée et ne présente pas d’état d’erreur. Si vous avez configuré l’observabilité du redirecteur de logs, consultez d’abord ce dashboard pour identifier la défaillance spécifique, par exemple une erreur de récupération de secret ou une erreur de distribution. Si elle semble toujours défectueuse et que vous ne pouvez pas résoudre le problème à partir d’OCI uniquement, contactez le support.
Quelqu’un a récemment modifié votre configuration (relancé l’assistant, modifié une configuration Terraform, désactivé une option)
Relancez la configuration avec l’option correcte activée pour restaurer le connecteur ; ce changement l’a probablement supprimé ou modifié.
Plus d’un connecteur envoie le même événement de log à New Relic. Cela signifie généralement que plus d’un connecteur dans OCI couvre les mêmes log : le plus souvent, quelqu’un a ajouté un connecteur "tous les compartiments" plus large sans supprimer un ancien connecteur qui ne couvrait qu’un seul compartiment.
Dans Connector Hub, listez tous les connecteurs liés à votre intégration New Relic, et vérifiez ce que chacun couvre. Supprimez tous ceux qui se chevauchent, en ne conservant que le seul connecteur qui couvre le périmètre que vous souhaitez réellement.
La portée de votre connecteur ne couvre pas tout ce que vous espériez.
La configuration couvre
Ce qui est inclus
L’intégralité de la location (tous les compartiments, y compris les futurs)
Tout, automatiquement : aucune action n’est requise à mesure que vous ajoutez de nouveaux compartiments.
Un compartiment spécifique et tout ce qui se trouve en dessous
Ce compartiment, et ses sous-compartiments, y compris les nouveaux sous-compartiments ajoutés ultérieurement.
Un seul compartiment spécifique uniquement
Uniquement ce compartiment : il n’inclut pas automatiquement de nouveaux sous-compartiments.
Si vous avez effectué la configuration via l’assistant guidé, votre connecteur couvre déjà l’ensemble de la location ; si des compartiments sont toujours manquants, cela indique un problème de connecteur (voir Aucun log n’apparaît du tout) plutôt qu’un problème de portée. Si vous avez effectué la configuration manuellement ou via Terraform, vérifiez la portée avec laquelle vous avez configuré votre connecteur, et recréez-le avec une portée plus large si nécessaire.
New Relic ne dispose pas des autorisations OCI requises ; cela peut bloquer entièrement la création du connecteur, ou le faire fonctionner sans l’intégralité de ses fonctionnalités.
Demandez à votre administrateur de location OCI de confirmer que les instructions de politique suivantes existent pour le groupe dynamique créé lors de la configuration :
Politique
À quoi cela sert
Allow dynamic-group your_dynamic_group_name to read log-content in tenancy
Lecture de vos données de log
Allow dynamic-group your_dynamic_group_name to use fn-function in tenancy
Exécution de l’intégration New Relic
Allow dynamic-group your_dynamic_group_name to use fn-invocation in tenancy
Exécution de l’intégration New Relic
Allow dynamic-group your_dynamic_group_name to read secret-bundles in tenancy where any { target.secret.id = 'your_ingest_secret_ocid', target.secret.id = 'your_user_secret_ocid' }
Accéder en toute sécurité à votre clé de licence New Relic
Allow dynamic-group your_dynamic_group_name to inspect dns-family in tenancy
Résolution des noms conviviaux pour les ressources DNS
Allow dynamic-group your_dynamic_group_name to inspect goldengate-family in tenancy
Résolution des noms conviviaux pour les ressources GoldenGate
Allow dynamic-group your_dynamic_group_name to inspect network-firewall-family in tenancy
Résolution des noms conviviaux pour les ressources de pare-feu réseau
Allow dynamic-group your_dynamic_group_name to inspect cloudevents-rules in tenancy
Résolution des noms conviviaux pour les ressources de règle d’événement
Allow dynamic-group your_dynamic_group_name to inspect integration-instance in tenancy
Résolution des noms conviviaux pour les ressources d’instance d’intégration
Si vous réexécutez l’assistant guidé ou le module de stratégie Terraform, il les réapplique automatiquement. Après avoir restauré les autorisations, si le connecteur n’est toujours pas Active, supprimez-le, et créez-le à nouveau.
Pour certains types de ressources OCI, New Relic recherche automatiquement un nom lisible par l’homme (comme un nom de VCN ou de pare-feu) peu de temps après l’arrivée du premier log, plutôt que d’afficher l’identifiant brut de la ressource. Cette recherche peut prendre quelques minutes la première fois que New Relic voit une ressource donnée.
Si vous voyez ceci
Ce que cela signifie
Une ressource affiche d'abord son ID, puis un nom convivial peu de temps après
Normal : c’est attendu la première fois qu’une nouvelle ressource apparaît.
Une ressource n’obtient jamais de nom convivial, même après un certain temps
Il s’agit généralement d’un problème d’autorisations ; voir ci-dessous.
Un type de ressource spécifique n’affiche jamais de nom convivial pour aucune ressource
Certains types de ressources n’ont pas la recherche de nom activée, et afficheront toujours leur ID. Il s’agit d’un comportement attendu, et non d’une erreur.
Si les noms ne se résolvent jamais, demandez à votre administrateur de location OCI de confirmer que le groupe dynamique possède les inspect politiques répertoriées sous Autorisations manquantes : une pour chacune des ressources DNS, GoldenGate, pare-feu réseau, règle d’événement, et instance d’intégration. Si les autorisations semblent correctes, et que les noms ne se résolvent toujours pas après une attente raisonnable, contactez le support avec un exemple de la ressource affectée, et l’horodatage du log.
Si vous avez activé le dashboard de monitoring du redirecteur de logs OCI, utilisez-le comme première étape pour tout ce qui va au-delà de "les log arrivent-ils" :
Si vous voyez ceci
Que faire
Chaque widget du dashboard est vide
Confirmez que vous avez activé l’option de métriques de l’intégration (il s’agit d’un paramètre que vous choisissez lors de la configuration), et que la fonction sous-jacente s’exécute dans OCI.
Le taux d’erreur augmente sur le dashboard
Vérifiez si cela a commencé juste après une modification récente de votre configuration. Si rien n’a changé, et que le problème persiste, vérifiez que vos règles de réseau/pare-feu OCI autorisent l’accès sortant vers New Relic, et confirmez que votre clé de licence New Relic est toujours valide.
Une métrique "records dropped" ou similaire affiche une valeur non nulle et reste ainsi
Contactez le support avec la plage horaire : certaines données de log ne parviennent pas à New Relic.
Une tuile affiche un tiret ou aucune valeur au lieu d’un nombre ou d’un pourcentage
Vérifiez une plage de temps plus large avant de supposer que quelque chose est en panne : il s’agit souvent juste d’un état "pas encore assez de données dans cette fenêtre de temps", et non d’une erreur.
Obtenir plus d'aide
Si vous avez effectué les vérifications ci-dessus, et que le problème n’est pas résolu, veuillez contacter le support New Relic avec :
La méthode de configuration que vous avez utilisée (assistant guidé, configuration manuelle, ou Terraform)
La région OCI, et, le cas échéant, le(s) compartiment(s) affecté(s)
La plage de temps approximative à laquelle le problème a commencé
Lesquelles des vérifications ci-dessus vous avez déjà essayées
Référence des métriques OCI: les espaces de nommage OCI à partir desquels New Relic collecte des données, le service auquel chacun appartient, et le type d’entité sur lequel il génère des rapports.
Monitorer votre redirecteur de logs OCI: activez les métriques d'auto-observabilité sur la fonction du redirecteur de logs et importez un dashboard pour monitorer son état de santé.