Plugin Kubernetes pour le transfert de log

Le plugin Kubernetes de New Relic pour le transfert de logsimplifie l'envoi des logs de votre cluster vers New Relic Logs. Il utilise une image Docker autonome et fonctionne comme un DaemonSet, collectant de manière transparente les logs pour une analyse et un dépannage centralisés. La transmission de votre Kubernetes log vers New Relic vous offrira des gestion des logscapacités améliorées pour collecter, traiter, explorer, interroger et alerter sur vos log données .

Activer Kubernetes pour la gestion des log

Pour transférer votre log Kubernetes vers New Relic avec notre plugin :

1. Installez l'intégration New Relic Kubernetes. Cette intégration inclut le plugin Kubernetes pour le log.

2. En option, vous pouvez affiner davantage votre installation dans l'installation guidée en utilisant les nombreuses options de configuration disponibles dans le référentielnewrelic-logging . Cependant, nous recommandons la configuration standard, car elle est valable pour la plupart des utilisateurs.

   

   Important

   Si vous utilisez un secret Kubernetes pour stocker le New Relic clé de licence, le graphique newrelic-logging envoie par défaut le log aux points de terminaison d'API américains. Si la clé de licence appartient à un compte UE ou FedRAMP et qu'un secret est utilisé pour le stockage de la clé, vous devez mettre à jour le paramètre de point de terminaison avec la valeur appropriée à partir des documents de référence de l'API. Voici un exemple de configuration pour les comptes de l'UE :

   newrelic-logging:
     enabled: true
     endpoint: https://log-api.eu.newrelic.com/log/v1

   Copier

3. Générez du trafic et attendez quelques minutes, puis vérifiez les données de votre compte .

Plugin de sortie Fluent Bit

New Relic dispose d'un Fluent Bit plugin de sortie pour transmettre votre log à New Relic gestion des log . Ce plugin est également fourni dans une image Docker autonome qui peut être installée dans un cluster Kubernetes sous la forme d'un DaemonSet, également connu sous le nom de plugin Kubernetes.

Voir le pluginFluent Bit pour le transfert de log pour plus de détails à ce sujet.

Détails métriques supplémentaires

À partir de la version 1.24.0 du graphique Helm newrelic-logging , les métriques internes sont envoyées par défaut à l'aide du plug-in d'entrée prometheus_scrape en conjonction avec le plug-in de sortie prometheus_remote_write . L'option de configuration sendMetrics: true est désormais uniquement responsable de l'envoi des métriques du plug-in de sortie de newrelic-fluent-bit-output:

• Fluent Bit internal métriques: écrites par Fluent Bit au format Prometheus et livrées au point de terminaison d'export Prometheus de New Relic. Ils peuvent être facettés par cluster_name, node_name et pod_name.

  Nous capturons les métriques internes de Fluent Bit en utilisant son plugin d'entréeprometheus_scrape avec le plugin de sortieprometheus_remote_write . Toutes les métriques Prometheus counter sont des compteurs cumulatifs, mais nous effectuons automatiquement une conversion delta lorsqu'elles sont ingérées chez New Relic pour faciliter leur interrogation ultérieure à l'aide de NRQL. Plus de détails peuvent être trouvés ici.

• Métriques de plugin internes de newrelic-fluent-bit-output: ces métriques sont collectées par le plugin de sortie et envoyées à l'API métrique de New Relic lorsque sendMetrics: true est activé. Ils incluent la dimension cluster_name , ce qui leur permet d'être limités à un cluster particulier mais pas à un hôte ou à un pod spécifique. Ces métriques sont utiles pour évaluer la latence globale lors de la livraison du log à l'API New Relic Logs ou pour identifier les problèmes potentiels de packaging.

Dépannez votre installation de plug-in Kubernetes pour le transfert de log

Parfois, malgré Kubernetes l'installation correcte du plugin de transfert logde (newrelic-logging Helm chart), vous pouvez rencontrer des problèmes de performances affectant la livraison correcte des logs. Dans de tels cas, l'examen des métriques internes du redirecteur de logpeut aider à identifier la cause du problème.

Le graphique Helm newrelic-logging fournit un paramètre de configuration permettant de collecter ces métriques pour un cluster Kubernetes donné. Nous fournissons également un modèle dashboard au format JSON pour afficher facilement toutes ces métriques dans New Relic.

Pour configurer votre cluster Kubernetes pour envoyer les métriques internes du redirecteur de loget les afficher dans un dashboard, suivez ces étapes :

1. Installez le graphique Helm avec le paramètre de configuration supplémentaire suivant :

   newrelic-logging:
     fluentBit:
       sendMetrics: true

   Copier

   Vous devez uniquement activer le paramètre newrelic-logging.fluentBit.sendMetrics lors du dépannage d’un cluster Kubernetes. Nous vous recommandons de l'activer pour un seul cluster Kubernetes à la fois afin de faciliter le dépannage.

2. Le graphique Helm newrelic-logging peut être configuré pour transmettre les métriques internes du plugin à New Relic. Cela aide à monitoring et à dépanner le processus de transfert des log .

Afficher les données log

Une fois que vous avez tout configuré et collecté les données, vous devriez voir les données log à ces deux endroits :

• Notre UI de logs

• Nos outils pour exécuter des requêtes NRQL . Par exemple, vous pouvez exécuter une requête comme celle-ci :

  SELECT *
  FROM Log

  Copier

Si vous ne voyez aucune donnée après avoir activé nos fonctionnalités de gestion des log , suivez nos procédures standard de dépannage log .

Désactiver le transfert de log

Pour désactiver les fonctionnalités de transfert de log , vous pouvez désinstaller le plugin Kubernetes en suivant ces étapes. Vous n'avez rien d'autre à faire dans New Relic.

Choisissez votre prochaine étape