Paramètres des logs en contexte de l'agent Java

Les paramètres de Logs en contexte configurent le transfert de logs d’application, la décoration des logs, et le comportement de logging propre à l’agent.

Les logs en contexte

À partir de la version 7.6.0 agent Java, la prise en charge des logs en contexte a été ajoutée à l'agent, le rendant facile à utiliser pour le framework de logging pris en charge. Pour des conseils sur l'utilisation de l'agent Java pour les logs en contexte, voir Java logs en contexte.

La modification de ces paramètres dans votre fichier de configuration d'agent local se produit de manière dynamique et ne nécessite pas de redémarrage de l'agent pour que ces modifications prennent effet. Un exemple de configuration :

application_logging:
  enabled: true
  forwarding:
    enabled: true
    max_samples_stored: 10000
    labels:
      enabled: false
      exclude:
    context_data:
      enabled: false
      include:
      exclude:
    log_level_denylist: debug
  metrics:
    enabled: true
  local_decorating:
      enabled: false

Définissez les logs dans le contexte configuration dans la section application_logging. Cela peut être remplacé par une propriété système préfixée par newrelic.config.application_logging . La seule option disponible est :

Transfert de logs

Si vous utilisez un framework de logging pris en charge et que vous souhaitez utiliser l'agent pour envoyer votre log d'application à New Relic, vous pouvez contrôler cela via les paramètres de la section forwarding. Ces paramètres peuvent être remplacés par la propriété système préfixée newrelic.config.application_logging.forwarding . Les options disponibles sont :

Étiquettes de log (tags)

L'agent Java prend en charge l'ajout d'étiquettes personnalisées (tag) aux logs transmis par l'agent. Les étiquettes proviennent de la section étiquettes au niveau supérieur de la configuration de l'agent. Cette fonctionnalité peut être activée dans la section labels , imbriquée sous la section forwarding . Vous pouvez remplacer ces paramètres à l’aide de la propriété système préfixée newrelic.config.application_logging.forwarding.labels . Les options disponibles incluent :

Données de contexte du log

L'agent Java peut capturer des données de contexte (Mapped Diagnostic Context dans logback/slf4j, ThreadContext dans log4j2) et ajouter son contenu comme attribut dans le log transmis à New Relic. Vous pouvez contrôler cela via les paramètres de la section context_data, imbriquée sous la section forwarding . Ces paramètres peuvent être remplacés par la propriété système préfixée newrelic.config.application_logging.forwarding.context_data . Les options disponibles sont :

Liste de refus des niveaux de log

L'agent Java peut exclure des niveaux de log spécifiques de la génération de LogEvents qui sont transmis à New Relic.

Vous pouvez contrôler cela via l'option de configuration log_level_denylist, imbriquée sous la section forwarding. Ce paramètre vous permet de définir une liste de chaînes séparées par des virgules représentant des niveaux de log (par ex. log_level_denylist: "info, debug") dont les événements de log ne doivent pas être transmis. Les noms de niveau de log ne sont pas sensibles à la casse, mais doivent par ailleurs correspondre exactement. Ces paramètres peuvent être remplacés par la propriété système préfixée newrelic.config.application_logging.forwarding.log_level_denylist. La seule option disponible est :

Métriques de Log

En plus de vous permettre de décorer et d'envoyer des lignes log individuelles, l'agent Java peut capturer des données métriques de logging. Vous pouvez trouver ces données dans le graphique du log dans l'UI de New Relic. Vous pouvez configurer les paramètres des métriques log dans la section metrics. Vous pouvez remplacer ces paramètres avec la propriété système préfixée newrelic.config.application_logging.metrics . La seule option disponible est :

Décoration de logs

Vous pouvez configurer les paramètres de décoration log dans la section local_decorating. Vous pouvez l'utiliser pour contrôler la manière dont les lignes log locales sont décorées. Vous pouvez remplacer ces paramètres par une propriété système préfixée par newrelic.config.application_logging.local_decorating . La seule option disponible est :

Configuration du logging

Ceux-ci font partie des variables de configuration générales. Ils sont présentés ici car ils sont fréquemment modifiés à des fins de débogage.

Certaines des variables de configuration de logging sont dynamiques et ne nécessitent pas de redémarrage de l'hôte pour prendre effet. Par instance, si les fichiers log augmentent trop rapidement, log_level peut être défini sur un paramètre moins détaillé pour réduire le taux de rapports.

Voici l'ordre de priorité et l'explication des variables configuration affectant la rotation log .

• Si log_daily est true:

  • Une valeur log_limit_in_kbytes supérieure à zéro entraînera une politique de déclenchement composite, où le log sera renouvelé une fois par jour ou lorsque la taille définie sera atteinte, conservant jusqu'à log_file_count fichiers
  • Une valeur log_limit_in_kbytes de zéro entraînera un roulement du log une fois par jour conservant jusqu'à log_file_count fichiers

• Si log_daily est false et log_limit_in_kbytes > 0, une politique basée sur la taille sera configurée, où les logs seront reconduits lorsque la taille définie sera atteinte, conservant jusqu'à log_file_count fichiers

• Si log_daily est false et log_limit_in_kbytes = 0, aucune logique de roulement de fichier de log ne sera configurée

En fonction du taux de croissance, il est possible que la taille du fichier log dépasse légèrement la valeur configurée.