• /
  • EnglishEspañolFrançais日本語한국어Português
  • Se connecterDémarrer

Cette traduction automatique est fournie pour votre commodité.

En cas d'incohérence entre la version anglaise et la version traduite, la version anglaise prévaudra. Veuillez visiter cette page pour plus d'informations.

Créer un problème

Configuration de l'agent Ruby

Vous pouvez configurer l'agent Ruby New Relic avec des paramètres dans un fichier de configuration, des variables d'environnement ou par programmation avec une configuration côté serveur. Ce document résume les options de configuration disponibles pour l'agent Ruby.

Si la valeur par défaut d'une option de configuration est (Dynamic), cela signifie que l'agent Ruby calcule la valeur par défaut au moment de l'exécution. La valeur du paramètre de configuration par défaut correspond à la valeur d'un autre paramètre, le cas échéant.

Méthodes de configuration et priorité

La méthode principale (par défaut) pour configurer l'agent Ruby s'effectue via le fichier de configuration (newrelic.yml) dans le sous-répertoire config . Pour définir les valeurs de configuration à l’aide de variables d’environnement :

  1. Ajoutez le préfixe NEW_RELIC_ au nom du paramètre.
  2. Remplacez tous les points . par des traits de soulignement _.

Vous pouvez également configurer quelques valeurs dans l'UI via configuration côté serveur.

L'agent Ruby suit cet ordre de priorité pour la configuration :

  1. Variables d'environnement
  2. Configuration côté serveur
  3. Fichier de configuration (newrelic.yml)
  4. Paramètres de configuration par défaut

En d'autres termes, les variables d'environnement remplacent tous les autres paramètres et informations de configuration, la configuration côté serveur remplace le fichier de configuration et les paramètres de configuration par défaut, et ainsi de suite.

Afficher et modifier les options du fichier de configuration

Le newrelic.yml de l'agent Ruby est un fichier de configuration YAML standard. Il comprend généralement une section Defaults en haut, ainsi que des sections en dessous pour chaque environnement d'application (Development, Test, Staging et Production).

L'agent Ruby détermine la section du fichier de configuration newrelic.yml à lire en examinant certaines variables d'environnement pour dériver l'environnement de l'application. Cela peut être utile lorsque vous souhaitez utiliser info pour le paramètre de configuration log_level dans votre environnement de production et que vous souhaitez des paramètres de configuration log_level plus détaillés (tels que debug) dans votre environnement de développement.

Voici un exemple de fichier de configuration newrelic.yml :

common: &default_settings
license_key: 'YOUR_LICENSE_KEY'
app_name: 'My Application Name'
production:
<<: *default_settings
log_level: info
development:
<<: *default_settings
log_level: debug

L'agent Ruby recherche les variables d'environnement suivantes, dans cet ordre, pour trouver l'environnement de l'application :

  1. NEW_RELIC_ENV
  2. RUBY_ENV
  3. RAILS_ENV
  4. APP_ENV
  5. RACK_ENV

Si l'agent Ruby ne détecte aucune valeur pour aucune de ces variables d'environnement, il définira par défaut l'environnement d'application sur development et lira à partir de la section development du fichier de configuration newrelic.yml .

Lors de l'exécution de l'agent Ruby dans une application Rails, l'agent recherche d'abord la variable d'environnement NEW_RELIC_ENV pour trouver l'environnement de l'application et la section de newrelic.yml à utiliser. Si NEW_RELIC_ENV n'est pas présent, l'agent utilise l'environnement Rails (RAILS_ENV).

Lorsque vous modifiez le fichier de configuration, assurez-vous de :

  • Indenter uniquement avec deux espaces.
  • Indentez uniquement si cela est pertinent, dans des sections telles que error_collector.

Si vous n'effectuez pas l'indentation correctement, l'agent peut générer une erreur Unable to parse configuration file au démarrage.

Pour afficher la liste la plus récente des options de configuration de l'agent Ruby disponibles, utilisez la commande rake newrelic:config:docs . Ce document décrit les options les plus courantes.

Mettre à jour le fichier de configuration

Cette documentation s'applique à la dernière sortie de l'agent Ruby . Pour plus de détails sur les versions antérieures, reportez-vous aux commentaires dans newrelic.yml lui-même.

Pour mettre à jour le fichier newrelic.yml après une nouvelle sortie, utilisez le modèle dans le répertoire de base du gem agent. Lorsque vous effectuez une mise à jour vers de nouvelles versions de gems, examinez ou comparez config/newrelic.yml et newrelic.yml dans le répertoire d'installation pour profiter des nouvelles options de configuration.

Important

La mise à jour de la gem ne met pas automatiquement à jour config/newrelic.yml.

Général

Ces paramètres sont disponibles pour la configuration de l'agent. Certains paramètres dépendent de votre niveau d'abonnement New Relic.

Traceur de transaction

La fonctionnalité de trace de transaction collecte des informations détaillées à partir d'une sélection de transactions, y compris un résumé de la séquence d'appel, une répartition du temps passé et une liste des requêtes SQL et de leurs plans de requête (sur MySQL et postgresql). Les fonctionnalités disponibles dépendent de votre niveau d’abonnement New Relic.

Collectord'erreurs

Par défaut, l'agent collecte et signale toutes les exceptions non détectées. Ces options de configuration vous permettent de personnaliser la collecte des erreurs.

Pour plus d'informations sur les erreurs ignorées et les erreurs attendues, consultez cette page sur l'analyse des erreurs dans APM. Pour définir l'erreur attendue via la méthode Ruby NewRelic::Agent.notice_error, consultez l'API de l'agent Ruby.

Monitoring de navigateurs

La fonctionnalitéde synchronisation de chargement des pages (parfois appelée monitoring des utilisateurs réels ou RUM) vous donne des informations détaillées sur les performances des utilisateurs réels avec votre site Web. Cela se fait en mesurant le temps qu'il faut au navigateur de votre utilisateur pour télécharger et restituer vos pages Web en injectant une petite quantité de code JavaScript dans l'en-tête et le pied de page de chaque page.

Événement de transaction

Logging des applications

L'agent Ruby prend en charge les logs APM dans ce contexte. Pour quelques conseils sur la configuration du log pour l'agent Ruby , voir Configurer les logs Ruby en contexte.

Les options de configuration liées au logging disponibles incluent :

Monitoring de l'IA

Cette section comprend la configuration de l'agent Ruby pour la mise en place monitoring de l'IA.

Important

Vous devez activer le tracing distribué pour capturer les données trace et de commentaires. Il est activé par défaut dans les agents Ruby 8.0.0 et supérieurs.

Attributs

Les attributs sont des paires valeur clé contenant des informations qui déterminent les propriétés d'un événement ou d'une transaction. Ces paires valeur-clé peuvent être visualisées dans la trace de transaction dans APM, la trace des erreurs dans APM, l'événement de transaction dans le dashboard et les pages vues dans le dashboard. Vous pouvez personnaliser exactement quel attribut sera envoyé à chacune de ces destinations

Log d'audit

Démarrage automatique

Cloud

niveau du code Métriques

traceur inter-applications

attribut personnalisé

événement personnalisé

Traceur de datastore

Désactiver

Utilisez ces paramètres pour basculer entre les types d’instrumentation lors du démarrage de l’agent.

Tracing distribué

Elasticsearch

Heroku

Infinite Tracing

Instrumentation

Traceur de messages

Mongo

Recherche ouverte

Hôte de processus

Râteau

Règles

Sécurité

Mode Serverless

Sidekiq

SQL lent

Événement de span

Supprimer les messages d'exception

Stripe

Profileur de filetage

Utilisation

Droits d'auteur © 2025 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.