Avec notre agent Node.js APM, vous pouvez obtenir des logs en contexte, ce qui vous permet de voir le log de votre application dans le contexte de vos autres données New Relic. Pour des informations générales sur cette fonctionnalité, consultez Logs en contexte APM.
Conseil
Vous avez beaucoup de logs Node.js ? Consultez notre tutoriel pour savoir comment les optimiser et les gérer.
Options de logs en contexte automatiques
Avec le logging des applications, votre agent APM collecte et contextualise automatiquement votre log.
Si vous utilisez un framework pris en charge, vous disposez de trois options pour configurer les logs APM afin d'envoyer automatiquement le log et les métadonnées de liaison de votre application à New Relic.
Les frameworks pris en charge pour les logs automatiques dans le contexte incluent :
- Winston 3.0.0 ou supérieur.
- Pino 7.0.0 ou supérieur.
- Bunyan 1.8.12 ou supérieur (depuis la version de l'agent 9.3.0)
Si vous n'utilisez pas de framework pris en charge, vous pouvez utiliser à la place la méthode API de transfert de logde l'agent pour effectuer votre propre instrumentation. Pour plus de détails, consultez la documentation de l'API de l'agent Node.js
Important
Agent sortie 8.16.0 et versions ultérieures ont cette fonctionnalité activée dans le fichier configuration de l'agent par défaut.
L'agent de transfert de logentraînera une augmentation de la consommation de données lorsqu'un framework pris en charge est détecté. Le montant dépend de l'application et de la quantité de logs produits. Cette fonctionnalité peut être désactivée. Consultez Désactiver le logging automatique pour plus d’informations sur vos options.
Si vous disposez déjà d'une solution de transfert de log , vous devez désactiver cette fonctionnalité.
Ce document vous a-t-il aidé lors de votre installation ?
Sécurisez vos données
Votre log peut inclure des informations sensibles protégées par la loi HIPAA ou d’autres protocoles de conformité. Par défaut, nous masquons les modèles de numéros qui semblent correspondre à des éléments tels que des cartes de crédit ou des numéros de sécurité sociale, mais vous devrez peut-être hacher ou masquer des informations supplémentaires.
Pour plus d'informations, consultez notre documentation sur l'expression d'obfuscation et les règles. Vous pouvez hacher ou masquer vos données log en utilisant l'interface utilisateur de New Relic ou en utilisant NerdGraph, notre API GraphQL .
Explorez vos données
Pour tirer le meilleur parti de vos données de logging :
- Sur la page APM Summary , cliquez sur votre graphique Web transaction time pour afficher le log associé à un moment précis.
- Vérifiez Errors inbox de votre application pour afficher le log associé à vos erreurs.
- Utilisez le tracing distribué pour voir le log associé à une trace individuelle.
- Explorez davantage de données de logging sur votre plateforme avec notre interface utilisateur de logs.
- Configurez des alertes en fonction de la sortie log et de la gravité.
- Interrogez vos données à l'aide de notre interface utilisateur spécialisée pour les données de log et créez des dashboards avec les résultats.
Conseils de dépannage
En règle générale, votre log commencera à apparaître moins d'une minute après avoir activé logs dans ce contexte. Vérifiez la section Triage > Logs de votre application. Vous commencerez également à voir log patterns liés à l’erreur.
Si vous ne voyez aucun log d'erreurs ou de trace, il se peut qu'il n'y en ait pas pour votre application. Essayez d'actualiser la page de l'interface utilisateur ou de modifier la période sélectionnée.
Désactiver le logging automatique
Les logs APM dans le contexte transmettent automatiquement les données log de l'agent APM. Il est activé par défaut. Si vous activez le logging des applications, cela peut avoir un impact négatif sur votre sécurité, votre conformité, votre facturation ou les performances de votre système. Pour plus d'informations, ou si vous devez ajuster le paramètre par défaut, suivez les procédures pour désactiver le logging automatique.
Quelle est la prochaine étape ?
Après avoir configuré logs dans le contexte, tirez le meilleur parti de vos données de logging :
- Explorez les données de logging sur votre plateforme avec notre interface utilisateur de logs.
- Consultez vos logs en contexte des performances de votre application dans l' interface utilisateur APM. Résolvez les erreurs avec le tracing distribué, le suivi des appels, le log d'application et bien plus encore.
- Obtenez une visibilité plus approfondie sur les données de performances de votre application et de votre plateforme en transmettant vos logs à notre agent d'infrastructure. Consultez vos logs d’infrastructure dans l’interface utilisateur.
- Configurer des alertes.
- interrogez vos données et créez un dashboard.