Skip to main content
La liste suivante inclut toutes les options de configuration avec le nom de la variable d’environnement et le nom de la clé dans le fichier de configuration. Pour plus d’informations sur la configuration de l’agent autonome AppSignal via un fichier de configuration ou des variables d’environnement, consultez notre section configuration.

​
Options disponibles

​
app_name

​
Description

Nom de votre application tel qu’il doit être affiché sur AppSignal.com.
Remarque : Modifier le nom ou l’environnement d’une application existante créera une nouvelle application sur AppSignal.com.

​
environment

​
Description

L’environnement de l’application à signaler à AppSignal.
Remarque : Modifier le nom ou l’environnement d’une application existante créera une nouvelle application sur AppSignal.com.

​
push_api_key

​
Description

La clé d’authentification au niveau de l’organisation pour s’authentifier auprès de notre Push API. Pour en savoir plus sur la clé Push API d’AppSignal.

​
bind_address

​
Description

Une adresse IPv4 valide que l’agent AppSignal utilise comme liaison pour ses serveurs TCP et UDP. Utilisez une adresse spécifique si vous souhaitez que l’agent n’écoute que les requêtes faites à cette adresse. Définissez cette option sur 0.0.0.0 pour autoriser la réception de requêtes depuis des hôtes utilisant n’importe quelle adresse IP. Par défaut, il n’écoute que les requêtes faites sur le même hôte. Cette option s’applique à tous les serveurs de l’agent (StatsD, OpenTelemetry et NGINX).

​
ca_file_path

​
Description

  • Configurez le chemin du fichier de certificat SSL.
Utilisez cette option pour pointer vers un autre fichier de certificat s’il y a un problème de connexion à notre API.
Remarque : Le chemin spécifié ne peut pas contenir d’abstractions du système de fichiers spécifiques au système d’exploitation, telles que le symbole du répertoire personnel ~ pour les systèmes *NIX. Cela sera considéré comme un chemin mal formé.

​
cpu_count

​
Description

La capacité CPU disponible de l’hôte, exprimée en nombre de CPUs. Elle est utilisée pour calculer le pourcentage d’utilisation du CPU dans les métriques d’hôte. Si elle n’est pas définie, l’agent tentera de la détecter automatiquement à partir des cgroups. Le nombre de CPUs peut être une fraction, par exemple 0.5.

​
dns_servers

​
Description

Configurez les serveurs DNS à utiliser par l’agent AppSignal.
YAML
Si vous êtes concerné par nos timeouts DNS, essayez de définir manuellement un serveur DNS à l’aide de cette option, dont le nom de serveur ne contient pas plus de 4 points.
  • Valeurs acceptables : 8.8.8.8, my.custom.local.server.
  • Valeurs non acceptables : foo, my.awesome.custom.local.dns.server.
Si le serveur DNS ne peut pas être joint, l’agent se rabattra sur la configuration DNS de l’hôte et affichera un message dans le fichier appsignal.log : A problem occurred while setting DNS servers.

​
enable_host_metrics

​
Description

Définissez cette option sur false pour désactiver la collecte des métriques d’hôte. Sur Heroku et Dokku, les métriques d’hôte sont désactivées par défaut. Cela est dû au fait que ces systèmes signalent des métriques inexactes depuis les conteneurs. La collecte des métriques d’hôte ne peut pas être activée sur ces systèmes. Pour Heroku, utilisez plutôt le drain de logs Heroku.

​
enable_http

​
Description

Définissez cette option sur true pour activer le serveur HTTP OpenTelemetry. Lorsqu’elle est activée, l’agent AppSignal écoutera un serveur lié à localhost sur le port 8099. Si vous exécutez plusieurs applications instrumentées par AppSignal sur le même serveur, cette option de configuration ne peut être activée que dans l’une d’elles. Ceci est requis pour les applications utilisant l’exportateur HTTP OpenTelemetry pour signaler les données à AppSignal.

​
enable_nginx_metrics

​
Description

Définissez sur true pour activer le serveur de métriques NGINX. Consultez la documentation des métriques NGINX pour plus de détails. Lorsqu’elle est activée, l’agent AppSignal écoutera un serveur lié à localhost sur le port 27649. Si vous exécutez plusieurs applications instrumentées par AppSignal sur le même serveur, cette option de configuration ne peut être activée que dans l’une d’elles.

​
enable_opentelemetry_http

​
Description

Définissez cette option sur true pour activer le serveur HTTP OpenTelemetry. Lorsqu’elle est activée, l’agent AppSignal écoutera un serveur lié à localhost sur le port 8099. Si vous exécutez plusieurs applications instrumentées par AppSignal sur le même serveur, cette option de configuration ne peut être activée que dans l’une d’elles. Ceci est requis pour les applications utilisant l’exportateur HTTP OpenTelemetry pour signaler les données à AppSignal.

​
enable_statsd

​
Description

Active le serveur StatsD dans l’agent AppSignal. Lorsqu’elle est activée, l’agent AppSignal écoutera un serveur lié à localhost sur le port 8125. Si vous exécutez plusieurs applications instrumentées par AppSignal sur le même serveur, cette option de configuration ne peut être activée que dans l’une d’elles.

​
filter_parameters

​
Description

Liste des clés de paramètres qui doivent être ignorées via le filtrage AppSignal. Leurs valeurs seront remplacées par [FILTERED] lors de la transmission à AppSignal.
TOML
Pour en savoir plus sur le filtrage des paramètres.

​
filter_session_data

​
Description

Liste des clés de données de session qui doivent être ignorées via le filtrage AppSignal. Leurs valeurs seront remplacées par [FILTERED] lors de la transmission à AppSignal.
TOML
Pour en savoir plus sur le filtrage des données de session.

​
host_role

​
Description

Groupez les hôtes par rôle et générez des métriques basées sur ce rôle. L’une de ces métriques est la métrique de compteur reporting_hosts. Un bon rôle indique le rôle principal du serveur, par exemple « webserver », « processor », « api », « database », « loadbalancer », etc.

​
hostname

​
Description

Cela remplace le nom d’hôte du serveur. Utile lorsque vous ne pouvez pas définir un nom d’hôte personnalisé ou lorsqu’un identifiant peu descriptif est généré pour vous sur les services d’hébergement.

​
http_proxy

​
Description

Si vous avez besoin que l’agent se connecte à Internet via un proxy, définissez l’URL complète du proxy dans cette clé de configuration.

​
ignore_actions

​
Description

Avec cette option de configuration, vous pouvez spécifier une liste d’actions qui seront ignorées par AppSignal. Tout ce qui se passe, y compris les exceptions, ne sera pas transmis à AppSignal. Cela peut être utile pour ignorer les points de terminaison de contrôle de santé ou d’autres actions que vous ne souhaitez pas surveiller. Pour en savoir plus sur l’ignorement des actions.

​
ignore_errors

​
Description

Liste des classes d’erreur qui seront ignorées. Toute exception levée avec cette classe d’erreur ne sera pas transmise à AppSignal. Pour en savoir plus sur l’ignorement des erreurs.

​
ignore_namespaces

​
Description

Liste des namespaces qui seront ignorés. Toute erreur levée ou requête lente qui se produit dans cet namespace ne sera pas envoyée à AppSignal. Pour en savoir plus sur les namespaces.

​
log_level

​
Description

Cette option définit le niveau de gravité du journaliseur interne d’AppSignal et n’affecte pas la fonctionnalité de journalisation.
Définit le niveau de gravité du journaliseur interne d’AppSignal. S’il est configuré sur « info », il enregistrera tous les messages d’erreur, d’avertissement et d’information, mais pas les messages de débogage. Le définir sur les niveaux « debug » ou « trace » n’est généralement nécessaire qu’à la demande du support. Définir le niveau sur « debug »/« trace » peut avoir un léger impact sur l’utilisation du disque et des E/S, en particulier sur les sites à fort trafic. La surcharge CPU est minimale lorsque l’option de débogage est activée. Valeurs acceptées :
  • error
  • warning
  • info
  • debug
  • trace

​
nginx_port

​
Description

Configurez le port sur lequel le serveur de métriques NGINX est exposé. Lorsque AppSignal reçoit des métriques NGINX, il écoute sur un serveur lié à localhost, par défaut sur le port 27649. Si vous exécutez plusieurs applications instrumentées par AppSignal sur le même serveur avec les métriques NGINX activées, utilisez cette option pour configurer chaque application de manière à écouter sur un port différent.

​
opentelemetry_port

​
Description

Définissez cette option pour configurer le port du serveur HTTP OpenTelemetry du processus d’agent AppSignal. Configurez ce port si un autre processus est déjà en cours d’exécution sur la machine et utilise également ce port, afin d’éviter les conflits.

​
push_api_endpoint

​
Description

Configurez le point de terminaison pour envoyer des données à AppSignal. Ce paramètre n’aura pas à être modifié.

​
running_in_container

​
Description

AppSignal s’attend à être exécuté sur la même machine entre les différents déploiements. Définissez cette clé sur true si l’application s’exécute dans un conteneur, par exemple avec Docker. Les versions plus récentes de l’intégration AppSignal détectent automatiquement leur environnement de conteneur, aucune configuration manuelle n’est donc nécessaire. Si vous rencontrez des problèmes avec la détection automatique, veuillez contacter le support. Cette option est automatiquement définie sur true sur Heroku.

​
send_environment_metadata

​
Description

Envoie des métadonnées d’environnement concernant l’application. Pour plus d’informations, veuillez consulter la documentation sur les métadonnées d’environnement.

​
send_params

​
Description

Indique s’il faut ignorer l’envoi des paramètres de requête à AppSignal. Pour plus d’informations, veuillez consulter la documentation sur send_params dans le filtrage des paramètres de requête.

​
send_session_data

​
Description

Définissez cette option sur false pour ne pas envoyer de données de session avec les traces d’exception et les échantillons de problèmes de performance. Pour plus d’informations, veuillez consulter la documentation sur le filtrage des données de session de requête.

​
statsd_port

​
Description

Définissez cette option pour configurer le port du serveur HTTP StatsD du processus d’agent AppSignal. Configurez ce port si un autre processus est déjà en cours d’exécution sur la machine et utilise également ce port, afin d’éviter les conflits.

​
working_dir_path

​
Description

Remplace l’emplacement où l’agent autonome AppSignal peut stocker des fichiers temporaires. Utilisez cette option si l’emplacement par défaut ne convient pas. Consultez notre page comment AppSignal fonctionne pour plus d’informations sur le rôle de ce répertoire de travail.
Remarque : Le chemin spécifié ne peut pas contenir d’abstractions du système de fichiers spécifiques au système d’exploitation, telles que le symbole du répertoire personnel ~ pour les systèmes *NIX. Cela sera considéré comme un chemin mal formé.