Lorsque vous intégrez votre compte OCI pour envoyer des logs à New Relic, OCI est votre source de données, et New Relic est la destination. Entre les deux, une fonction New Relic (le redirecteur de logs) récupère les logs d’OCI, et les transmet à New Relic. Si cette fonction rencontre un problème, par exemple un secret qu’elle ne peut pas lire, un lot qu’elle ne peut pas décoder, ou une livraison qu’elle ne peut pas terminer, vos logs OCI cessent de circuler, mais rien dans OCI, ni dans New Relic, ne vous indique pourquoi.
Pour détecter ce type de défaillance avant qu'elle ne vous coûte des données de log, le redirecteur de logs peut émettre des métriques sur son propre état de santé. Ce document couvre :
- Activez les métriques d’auto-observabilité sur la fonction du redirecteur de logs, afin qu’elle commence à remonter des signaux tels que le nombre d’invocations, les erreurs de remise, et la latence du pipeline, le genre de détail qui vous indique où une défaillance s’est produite dans le pipeline.
- Importez un dashboard préconçu qui transforme ces signaux en graphiques, afin que vous puissiez repérer une anomalie d’un coup d’œil au lieu de fouiller dans les données de métriques brutes.
Prérequis
Avant de commencer, assurez-vous d'avoir :
- La fonction de redirecteur de logs OCI que vous avez déjà déployée avec Resource Manager, Terraform, ou une configuration manuelle
- Votre ID de compte New Relic, à utiliser lorsque vous importez le dashboard
Activer les métriques d’auto-observabilité
Dans les variables de configuration de la fonction de log, au même endroit où vous définissez VAULT_REGION, SECRET_OCID, et les autres variables de logging, ajoutez :
FORWARDER_METRICS_TIER: contrôle quelles métriques d'auto-observabilité le redirecteur émet. Consultez les niveaux de métriques pour savoir ce que chaque paramètre collecte.
Si vous configurez l'intégration avec Resource Manager ou Terraform, FORWARDER_METRICS_TIER est la seule variable que vous devez ajouter : TENANCY_NAME et COMPARTMENT_NAME sont résolues automatiquement.
Si vous configurez l’intégration manuellement, ajoutez également :
TENANCY_NAME: identifie votre location OCI par son nom d’affichage, en ajoutant un tag aux métriques du forwarder, afin que vous puissiez différencier les locations si vous en monitorez plus d’une.COMPARTMENT_NAME: identifie, par nom d’affichage, le compartiment où vous avez déployé la fonction de log, permettant le tag des métriques pour les répartitions par compartiment. Si vous avez déployé dans le compartiment racine de la location, utilisez la même valeur queTENANCY_NAME.
Important
New Relic facture ces métriques d’auto-observabilité lors de l’ingestion, comme toute autre donnée de métrique.
Niveaux de métriques
FORWARDER_METRICS_TIER vous permet de trouver un compromis entre la visibilité et le coût. Il accepte l’une des valeurs suivantes :
none: désactive entièrement les métriques d'auto-observabilité.basic(par défaut) : collecte les métriques de santé principales : nombres d’invocations, enregistrements reçus, livrés, et abandonnés, durée de livraison, et retard du pipeline.advanced: collecte tout ce qui se trouve dansbasic, ainsi que des métriques d’optimisation plus approfondies : les volumes d’octets, le nombre d’erreurs de décodage et de sérialisation, le comportement de traitement par lots, les catégories d’erreurs de remise, la durée d’exécution de la fonction, les échecs de récupération de secrets, et le taux d’accès au cache client.
Importer le dashboard d’observabilité
Important
Définissez FORWARDER_METRICS_TIER sur basic, ou advanced avant d’importer le dashboard. Si vous le définissez sur none, le dashboard n’aura aucune donnée à afficher.
Pour importer le dashboard :
- Ouvrez le fichier
oci-log-forwarder-metrics-dashboard-template.jsondans le référentiel GitHuboci-log-integration, et copiez son contenu. - Dans le JSON copié, trouvez et remplacez chaque occurrence de
YOUR_ACCOUNT_IDpar votre ID de compte New Relic. - Allez à one.newrelic.com > All capabilities > Dashboards.
- Dans le coin supérieur droit, cliquez sur Import dashboard.
- Collez le JSON modifié.
- Choisissez le compte et les paramètres d’autorisation pour le dashboard, puis cliquez sur Save.
Le dashboard se remplit une fois que la fonction de log a traité au moins une invocation avec les métriques activées.
Dépannage avec le dashboard
Si les log OCI cessent d’arriver dans New Relic, vérifiez d’abord ce dashboard. Un pic d’échecs de récupération de secrets, ou d’erreurs de distribution, indique un problème dans le pipeline du forwarder, tel que le hub du connecteur de service, les groupes de log, ou la fonction, plutôt que dans OCI, ou New Relic lui-même. Après que vous avez résolu le problème sous-jacent, par exemple une politique, ou une permission de coffre de clés, les log reprennent sans rien redéployer.
Si vous ne voyez aucune donnée de log du tout, et que vous n’avez pas encore confirmé que l’intégration de base fonctionne, commencez plutôt par nos procédures standard de dépannage de log.
Prochaines étapes
Continuez à explorer votre intégration OCI :
- Consultez la liste complète des métriques que New Relic collecte depuis OCI.
- Consultez le dépannage général de l’intégration OCI si l’intégration de base elle-même ne fonctionne pas.