Options de configuration du Collector

Le collector peut être configuré au démarrage à l’aide de variables d’environnement ou d’un fichier de configuration. 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’AppSignal Collector via un fichier de configuration ou des variables d’environnement, consultez notre section configuration.

​

Options disponibles

• Options requises
  • push_api_key
• Options
  • cpu_count
  • enable_host_metrics
  • files_world_accessible
  • hostname
  • http_port
  • log_level
  • push_api_endpoint
  • running_in_container
  • working_directory_path

​

push_api_key

​

Description

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

​

cpu_count

​

Description

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

​

enable_host_metrics

​

Description

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

​

files_world_accessible

​

Description

Si cette option est définie sur true, le répertoire de travail AppSignal créé est accessible à tous les utilisateurs (permissions Unix 0666). Cela est souvent nécessaire car les processus d’une même application s’exécutent sous des utilisateurs différents. Définissez sur false pour désactiver ce comportement (permissions Unix 0644).

​

hostname

​

Description

Cette option 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 non descriptif est généré pour vous sur les services d’hébergement.

​

http_port

​

Description

Le port utilisé par le serveur HTTP du collecteur pour recevoir les requêtes d’exportation OpenTelemetry.

​

log_level

​

Description

Définissez le niveau de gravité du logger 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 aux 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 les E/S, en particulier sur les sites à fort trafic. La surcharge CPU est minime lorsque l’option de débogage est activée. Valeurs acceptées :

• error
• warning
• info
• debug
• trace

​

push_api_endpoint

​

Description

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

​

running_in_container

​

Description

AppSignal s’attend à s’exécuter sur la même machine entre 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 l’environnement conteneurisé, 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.

​

working_directory_path

​

Description

Remplacez l’emplacement où le collecteur AppSignal peut stocker les fichiers temporaires. Utilisez cette option si l’emplacement par défaut ne convient pas. Consultez notre page comment fonctionne AppSignal pour plus d’informations sur le but de ce répertoire de travail. Si vous exécutez plusieurs applications utilisant AppSignal sur le même serveur, utilisez cette option de configuration pour sélectionner des répertoires de travail différents pour chaque instance AppSignal, sinon les deux instances pourraient entrer en conflit. Pour plus d’informations sur ce scénario, consultez notre documentation sur l’exécution de plusieurs applications sur un même hôte.