Ce guide s'applique aux clients qui ont déjà configuré le transfert de log ou les logs en contexte; si vous n'avez configuré aucune de ces fonctionnalités, nous vous recommandons de mettre à niveau vers la dernière version de l'agent pour profiter du transfert automatique de loget de la décoration locale.
Si vous envoyez actuellement un log d'application à New Relic, il est possible d'envoyer un log en double si vous effectuez une mise à niveau vers le dernier agent de langue APM sans réviser votre stratégie de logging actuelle. Le chemin de migration optimal dépendra de votre application et de son environnement.
Si vous disposez d'une logique de traitement ou d'enrichissement de données étendue dans votre configuration de transfert de logs existante, l'envoi de logs directement à partir des agents APM ignorera cette étape.
Conseil
Vous avez beaucoup de logs Go ? Consultez notre tutoriel pour savoir comment les optimiser et les gérer.
Nous recommandons deux chemins de mise à niveau principaux pour éviter d'envoyer des logs en double :
Mettez à jour vers le dernier agent APM, qui transfère automatiquement les logs, puis désactivez les redirecteurs de log :
- Mettez à jour de logging de votre application framework configuration pour vous assurer que votre application n'écrit pas de log pour la simulation ou la production. Cela peut être vers un fichier sur le disque ou vers STDOUT si vous collectez le log à l'aide d'un sidecar
- Désactivez le redirecteur de logsitué à la fin du fichier log de votre application. Désactiver le(s) conteneur(s) utilisé(s) pour collecter le log d'application
- Désactiver le transfert de logavec votre fournisseur cloud
- Redémarrez l'agent APM/déployez vos modifications
Utiliser l'agent APM avec un redirecteur de log (recommandé uniquement si un redirecteur est déjà en place) :
- Mettre à jour l'agent APM
- Configurez l'agent APM pour garantir que la décoration log locaux est activée et que le transfert des logest désactivé.
- Annulez les modifications précédentes apportées à la de logging de framework configuration l'application pour activer les logs manuels dans ce contexte .
- Confirmez que framework de logging de l'application est configuré pour écrire le log de l'application sur STDOUT ou dans un fichier monitoré par un redirecteur de log .
- Redémarrez l'agent APM/déployez vos modifications
Activation de la décoration locale
La documentation sur la configuration de la décoration locale sur la dernière version des agents de langue se trouve ci-dessous :
Mise à niveau avec Kubernetes
Si les logs en contexte ont été configurés, les clients utilisant notre Kubernetes log intégration de transfert de devront annuler les modifications apportées au logging de l'application framework configuration lors de l'implémentation manuelle des logs en contexte. Cela est nécessaire pour préserver l'enrichissement des métadonnées Kubernetes effectué par notre intégration.
Notez que le framework de logging de l'application doit être configuré pour écrire le log de l'application sur STDOUT.
La décoration locale doit être activée sur l'agent pour garantir que vos logs sont contextualisés. Aucune modification ne doit être apportée à de votre transfert de log configuration.
Suivez les étapes ci-dessous pour mettre à niveau votre Kubernetes monitoring:
- Mettre à jour l'agent APM.
- Configurez l'agent APM pour garantir que la décoration log locaux est activée et que le transfert des logest désactivé.
- Annulez les modifications précédentes apportées à la framework configuration de logging de l'application pour activer manuellement les logs en contexte.
- Confirmez que framework de logging de l'application est configuré pour écrire le log de l'application sur STDOUT ou dans un fichier monitoré par un redirecteur de log .
- Redémarrez l'agent APM/déployez vos modifications.