> ## Documentation Index > Fetch the complete documentation index at: https://docs.appsignal.com/llms.txt > Use this file to discover all available pages before exploring further. # Options de configuration du package Node.js La liste suivante comprend 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 façon de configurer AppSignal avec un fichier de configuration ou des variables d'environnement système, consultez notre rubrique [Configuration](/nodejs/3.x/configuration). ## Options disponibles * Options requises * [`active`](#option-active) * [`environment`](#option-environment) * [`name`](#option-name) * [`pushApiKey`](#option-pushapikey) * Options * [`additionalInstrumentations`](#option-additionalinstrumentations) * [`bindAddress`](#option-bindaddress) * [`caFilePath`](#option-cafilepath) * [`cpuCount`](#option-cpucount) * [`debug`](#option-debug) * [`disableDefaultInstrumentations`](#option-disabledefaultinstrumentations) * [`dnsServers`](#option-dnsservers) * [`enableHostMetrics`](#option-enablehostmetrics) * [`enableMinutelyProbes`](#option-enableminutelyprobes) * [`enableNginxMetrics`](#option-enablenginxmetrics) * [`enableOpentelemetryHttp`](#option-enableopentelemetryhttp) * [`enableStatsd`](#option-enablestatsd) * [`filesWorldAccessible`](#option-filesworldaccessible) * [`filterParameters`](#option-filterparameters) * [`filterSessionData`](#option-filtersessiondata) * [`hostname`](#option-hostname) * [`hostRole`](#option-hostrole) * [`httpProxy`](#option-httpproxy) * [`ignoreActions`](#option-ignoreactions) * [`ignoreErrors`](#option-ignoreerrors) * [`ignoreLogs`](#option-ignorelogs) * [`ignoreNamespaces`](#option-ignorenamespaces) * [`log`](#option-log) * [`logLevel`](#option-loglevel) * [`logPath`](#option-logpath) * [`nginxPort`](#option-nginxport) * [`opentelemetry_port`](#option-opentelemetry_port) * [`requestHeaders`](#option-requestheaders) * [`revision`](#option-revision) * [`runningInContainer`](#option-runningincontainer) * [`sendEnvironmentMetadata`](#option-sendenvironmentmetadata) * [`sendParams`](#option-sendparams) * [`sendSessionData`](#option-sendsessiondata) * [`statsdPort`](#option-statsdport) * [`workingDirectoryPath`](#option-workingdirectorypath) ## active | Champ | Valeur | | ------------------------------- | -------------------------- | | Clé du fichier de configuration | `active` | | Clé d'environnement système | `APPSIGNAL_ACTIVE` | | Requis | oui | | Type | Booléen (`true` / `false`) | | Valeur par défaut | `false` | ### Description Configure AppSignal pour qu'il soit actif ou non dans un environnement donné. Utilisé le plus souvent dans la [configuration par fichier](/nodejs/3.x/configuration) pour chaque environnement. ## environment | Champ | Valeur | | ------------------------------- | -------------------------------------------------------------------------------- | | Clé du fichier de configuration | `environment` | | Clé d'environnement système | `APPSIGNAL_APP_ENV` | | Requis | oui | | Type | `String` | | Valeur par défaut | `Lu depuis la variable d'environnement `NODE\_ENV`, par défaut « development ».` | ### Description L'environnement de l'application qui sera signalé à AppSignal. **Remarque** : Modifier le [nom](#option-name) ou l'environnement d'une application existante créera une nouvelle application sur AppSignal.com. ## name | Champ | Valeur | | --------------------------------------- | -------------------- | | Clé du fichier de configuration | `name` | | Clé de variable d'environnement système | `APPSIGNAL_APP_NAME` | | Requis | oui | | Type | `String` | | Valeur par défaut | `nil` | ### Description Nom de votre application tel qu'il doit être affiché sur AppSignal.com. **Note** : Modifier le nom ou [l'environnement](#option-env) d'une application existante créera une nouvelle application sur AppSignal.com. ## pushApiKey | Champ | Valeur | | --------------------------------------- | ------------------------------------------------------------------------------------------------- | | Clé du fichier de configuration | `pushApiKey` | | Clé de variable d'environnement système | `APPSIGNAL_PUSH_API_KEY` | | Requis | oui | | Type | `String` | | Valeur par défaut | `null` (non défini par défaut) | | Disponible depuis la version | `2.2.5` | | | | ### 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 AppSignal](/appsignal/terminology#push-api-key). ## additionalInstrumentations | Champ | Valeur | | ------------------------------- | ---------------------------- | | Clé du fichier de configuration | `additionalInstrumentations` | | Requis | non | | Type | `list(String)` | | Valeur par défaut | `[]` | | Disponible depuis la version | `3.0.0` | ### Description Liste d'instrumentations OpenTelemetry supplémentaires à utiliser avec AppSignal, via des bibliothèques tierces ou vos propres intégrations. ## bindAddress | Champ | Valeur | | ------------------------------- | ------------------------ | | Clé du fichier de configuration | `bindAddress` | | Clé d'environnement système | `APPSIGNAL_BIND_ADDRESS` | | Requis | non | | Type | `String` | | Valeur par défaut | `127.0.0.1` | | Disponible depuis la version | `3.0.15` | ### 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 envoyées à 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 écoute uniquement les requêtes effectuées sur le même hôte. Cette option s'applique à tous les serveurs de l'agent ([StatsD](#option-enable_statsd), [OpenTelemetry](#option-enable_opentelemetry_http) et [NGINX](#option-enable_nginx_metrics)). ## caFilePath | Champ | Valeur | | ------------------------------- | -------------------------------------- | | Clé du fichier de configuration | `caFilePath` | | Clé d'environnement système | `APPSIGNAL_CA_FILE_PATH` | | Requis | non | | Type | `String` | | Valeur par défaut | Chemin du fichier `cacert.pem` fourni. | ### Description Utilisez cette option pour pointer vers un autre fichier de certificat en cas de problème de connexion à notre API. **Remarque** : Le chemin spécifié ne peut pas contenir d'abstractions de système de fichiers propres au système d'exploitation, comme le symbole de répertoire personnel `~` pour les systèmes \*NIX. Cela sera considéré comme un chemin mal formé. ## cpuCount | Champ | Valeur | | ------------------------------- | --------------------- | | Clé du fichier de configuration | `cpuCount` | | Clé d'environnement système | `APPSIGNAL_CPU_COUNT` | | Requis | non | | Type | `Float` | | Valeur par défaut | `undefined` | | Disponible depuis la version | `3.3.2` | ### Description La capacité CPU disponible de l'hôte, exprimée en nombre de CPU. Cette valeur est utilisée pour calculer le pourcentage d'utilisation 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 CPU peut être fractionnaire, par exemple `0.5`. ## debug | Champ | Valeur | | ------------------------------- | -------------------------------------------------------------------------------------------------------------------------- | | Clé du fichier de configuration | `debug` | | Clé d'environnement système | `APPSIGNAL_DEBUG` | | Requis | non | | Type | Booléen (`true` / `false`) | | Valeur par défaut | `false` | | Disponible depuis la version | `1.0.0` | | | | ### Description **Avertissement** : Cette option de configuration est dépréciée dans le package Node.js 2.2.6. Veuillez utiliser l'option [`logLevel`](#option-loglevel) à la place pour le package Node.js 2.2.6 et versions ultérieures. Active la journalisation de débogage ; cela n'est généralement nécessaire qu'à la demande du support. Avec cette option activée, AppSignal enregistrera beaucoup plus d'informations sur les décisions prises pendant la collecte de métriques et lors de l'envoi des données aux serveurs d'AppSignal.com. Activer la journalisation de débogage peut avoir un léger impact sur l'utilisation du disque et les I/O, en particulier sur les sites à fort trafic. La surcharge CPU est minimale lorsque l'option de débogage est activée. Cette option définit le niveau de gravité du logger interne d'AppSignal. Cette option de configuration n'affecte pas la [fonctionnalité de logging](/logging). ## disableDefaultInstrumentations | Champ | Valeur | | ------------------------------- | -------------------------------------------- | | Clé du fichier de configuration | `disableDefaultInstrumentations` | | Clé d'environnement système | `APPSIGNAL_DISABLE_DEFAULT_INSTRUMENTATIONS` | | Requis | non | | Type | `list(String)` ou Booléen (`true` / `false`) | | Valeur par défaut | `false` | | Disponible depuis la version | `3.0.0` | ### Description Vous permet de désactiver l'instrumentation automatique des intégrations par défaut : * @appsignal/opentelemetry-instrumentation-bullmq * @opentelemetry/instrumentation-amqplib * @opentelemetry/instrumentation-express * @opentelemetry/instrumentation-fastify * @opentelemetry/instrumentation-graphql * @opentelemetry/instrumentation-http * @opentelemetry/instrumentation-ioredis * @opentelemetry/instrumentation-knex * @opentelemetry/instrumentation-koa * @opentelemetry/instrumentation-mongodb * @opentelemetry/instrumentation-mongoose * @opentelemetry/instrumentation-mysql2 * @opentelemetry/instrumentation-mysql * @opentelemetry/instrumentation-nestjs-core * @opentelemetry/instrumentation-pg * @opentelemetry/instrumentation-redis * @opentelemetry/instrumentation-redis-4 * @opentelemetry/instrumentation-restify * @opentelemetry/instrumentation-undici * @prisma/instrumentation Pour désactiver toutes les instrumentations, définissez la valeur sur `true`. ## dnsServers | Champ | Valeur | | ------------------------------- | ----------------------- | | Clé du fichier de configuration | `dnsServers` | | Clé d'environnement système | `APPSIGNAL_DNS_SERVERS` | | Requis | non | | Type | `list(String)` | | Valeur par défaut | `[]` | ### Description Configurez les serveurs DNS à utiliser par l'agent AppSignal. ```sh Shell theme={null} # Dans l'environnement de l'hôte export APPSIGNAL_DNS_SERVERS="8.8.8.8,8.8.4.4" ``` Si vous êtes affecté par nos [délais d'attente DNS](/support/known-issues#dns-timeouts), essayez de définir manuellement un serveur DNS à l'aide de cette option, en utilisant un serveur dont le nom 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`. ## enableHostMetrics | Champ | Valeur | | ------------------------------- | ----------------------------------- | | Clé du fichier de configuration | `enableHostMetrics` | | Clé d'environnement système | `APPSIGNAL_ENABLE_HOST_METRICS` | | Requis | non | | Type | Booléen (`true` / `false`) | | Valeur par défaut | \`\`true` / détecté par le système` | ### Description Définissez cette option sur `false` pour désactiver la collecte des [métriques d'hôte](/metrics/host-metrics). 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](/heroku/host-metrics). ## enableMinutelyProbes | Champ | Valeur | | ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Clé du fichier de configuration | `enableMinutelyProbes` | | Clé d'environnement système | `APPSIGNAL_ENABLE_MINUTELY_PROBES` | | Requis | non | | Type | Booléen (`true` / `false`) | | Valeur par défaut | `true` | | Disponible depuis la version | `0.4.0` | | | | ### Description Active le système de [sondes à la minute](/nodejs/3.x/instrumentation/minutely-probes). ## enableNginxMetrics | Champ | Valeur | | ------------------------------- | -------------------------------- | | Clé du fichier de configuration | `enableNginxMetrics` | | Clé d'environnement système | `APPSIGNAL_ENABLE_NGINX_METRICS` | | Requis | non | | Type | Booléen (`true` / `false`) | | Valeur par défaut | `false` | | Disponible depuis la version | `3.0.8` | ### Description Définissez sur `true` pour activer le serveur de métriques NGINX. [Consultez la documentation sur les métriques NGINX pour plus de détails.](/metrics/nginx) Lorsqu'il est activé, l'agent AppSignal écoutera sur 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'entre elles. ## enableOpentelemetryHttp | Champ | Valeur | | ------------------------------- | ------------------------------------- | | Clé du fichier de configuration | `enableOpentelemetryHttp` | | Clé d'environnement système | `APPSIGNAL_ENABLE_OPENTELEMETRY_HTTP` | | Requis | non | | Type | Booléen (`true` / `false`) | | Valeur par défaut | `true` | | Disponible depuis la version | `3.1.0` | ### Description Définissez cette option sur `true` pour activer le [serveur HTTP OpenTelemetry](/standalone-agent/installation). Lorsqu'il est activé, l'agent AppSignal écoutera sur 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'entre elles. Cela est requis pour les applications utilisant l'exporteur OpenTelemetry HTTP pour signaler des données à AppSignal. ## enableStatsd | Champ | Valeur | | ------------------------------- | -------------------------- | | Clé du fichier de configuration | `enableStatsd` | | Clé d'environnement système | `APPSIGNAL_ENABLE_STATSD` | | Requis | non | | Type | Booléen (`true` / `false`) | | Valeur par défaut | `false` | | Disponible depuis la version | `2.2.2` | ### Description Active le [serveur StatsD](/standalone-agent/statsd) dans l'agent AppSignal. Lorsqu'il est activé, l'agent AppSignal écoutera sur 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'entre elles. ## filesWorldAccessible | Champ | Valeur | | ------------------------------- | ---------------------------------- | | Clé du fichier de configuration | `filesWorldAccessible` | | Clé d'environnement système | `APPSIGNAL_FILES_WORLD_ACCESSIBLE` | | Requis | non | | Type | Booléen (`true` / `false`) | | Valeur par défaut | `true` | | Disponible depuis la version | `2.2.4` | ### Description Si cette option est définie sur `true`, le [répertoire de travail AppSignal](/appsignal/how-appsignal-operates#working-directory) 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`). ## filterParameters | Champ | Valeur | | ------------------------------- | ----------------------------- | | Clé du fichier de configuration | `filterParameters` | | Clé d'environnement système | `APPSIGNAL_FILTER_PARAMETERS` | | Requis | non | | Type | `list(String)` | | Valeur par défaut | `[]` | | Disponible depuis la version | `2.2.5` | ### 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. Pour en savoir plus sur le [filtrage des paramètres](/application/parameter-filtering). ## filterSessionData | Champ | Valeur | | ------------------------------- | ------------------------------- | | Clé du fichier de configuration | `filterSessionData` | | Clé d'environnement système | `APPSIGNAL_FILTER_SESSION_DATA` | | Requis | non | | Type | `list(String)` | | Valeur par défaut | `[]` | | Disponible depuis la version | `2.2.5` | ### 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. Pour en savoir plus sur le [filtrage des données de session](/application/session-data-filtering). ## hostname | Champ | Valeur | | ------------------------------- | ------------------------- | | Clé du fichier de configuration | `hostname` | | Clé d'environnement système | `APPSIGNAL_HOSTNAME` | | Requis | non | | Type | `String` | | Valeur par défaut | détecté depuis le système | ### 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 non descriptif est généré pour vous sur des services d'hébergement. ## hostRole | Champ | Valeur | | ------------------------------- | ------------------------------ | | Clé du fichier de configuration | `hostRole` | | Clé d'environnement système | `APPSIGNAL_HOST_ROLE` | | Requis | non | | Type | `String` | | Valeur par défaut | `null` (non défini par défaut) | | Disponible depuis la version | `3.0.19` | ### Description Regroupe les hôtes par rôle et génère des métriques basées sur ce rôle. L'une de ces métriques est le compteur `reporting_hosts`. Un bon rôle indique quel est le rôle principal du serveur, comme « webserver », « processor », « api », « database », « loadbalancer », etc. ## httpProxy | Champ | Valeur | | ------------------------------- | ------------------------------ | | Clé du fichier de configuration | `httpProxy` | | Clé d'environnement système | `APPSIGNAL_HTTP_PROXY` | | Requis | non | | Type | `String` | | Valeur par défaut | `null` (non défini par défaut) | ### Description Si vous avez besoin que l'agent se connecte à Internet via un proxy, indiquez l'URL complète du proxy dans cette clé de configuration. ## ignoreActions | Champ | Valeur | | ------------------------------- | -------------------------- | | Clé du fichier de configuration | `ignoreActions` | | Clé d'environnement système | `APPSIGNAL_IGNORE_ACTIONS` | | Requis | non | | Type | `list(String)` | | Valeur par défaut | `[]` | ### Description Avec cette option de configuration, vous pouvez spécifier une liste d'actions qui seront ignorées par AppSignal. Tout ce qui s'y passe, y compris les exceptions, ne sera pas transmis à AppSignal. Cela peut être utile pour ignorer les endpoints de vérification d'état (health check) ou d'autres actions que vous ne souhaitez pas surveiller. Pour en savoir plus sur [l'ignorance des actions](/guides/filter-data/ignore-actions). ## ignoreErrors | Champ | Valeur | | ------------------------------- | ------------------------- | | Clé du fichier de configuration | `ignoreErrors` | | Clé d'environnement système | `APPSIGNAL_IGNORE_ERRORS` | | Requis | non | | Type | `list(String)` | | Valeur par défaut | `[]` | ### Description Liste des classes d'erreurs qui seront ignorées. Toute exception levée avec cette classe d'erreur ne sera pas transmise à AppSignal. Pour en savoir plus sur [l'ignorance des erreurs](/guides/filter-data/ignore-errors). ## ignoreLogs | Champ | Valeur | | ------------------------------- | ----------------------- | | Clé du fichier de configuration | `ignoreLogs` | | Clé d'environnement système | `APPSIGNAL_IGNORE_LOGS` | | Requis | non | | Type | `list(String)` | | Valeur par défaut | `[]` | | Disponible depuis la version | `3.4.0` | ### Description Liste des messages de log qui seront ignorés. Tout message de log contenant l'un des éléments de la liste ne sera pas transmis à AppSignal. Un petit sous-ensemble de la syntaxe regex est pris en charge ; pour en savoir plus, consultez notre guide [Ignorer les logs](/guides/filter-data/ignore-logs). ## ignoreNamespaces | Champ | Valeur | | --------------------------------------- | ----------------------------- | | Clé du fichier de configuration | `ignoreNamespaces` | | Clé de variable d'environnement système | `APPSIGNAL_IGNORE_NAMESPACES` | | Requis | non | | Type | `list(String)` | | Valeur par défaut | `[]` | ### Description Liste des espaces de noms qui seront ignorés. Toute erreur déclenchée ou requête lente survenant dans cet espace de noms ne sera pas envoyée à AppSignal. En savoir plus sur les [espaces de noms](/application/namespaces). ## log | Champ | Valeur | | --------------------------------------- | --------------- | | Clé du fichier de configuration | `log` | | Clé de variable d'environnement système | `APPSIGNAL_LOG` | | Requis | non | | Type | `String` | | Valeur par défaut | `file` | ### Description Cette option configure le logger utilisé par la fonctionnalité de journalisation interne d'AppSignal et n'affecte pas la [fonctionnalité de journalisation](/logging). **Note** : L'[agent AppSignal](/appsignal/how-appsignal-operates), qui est utilisé par l'intégration, écrira toujours dans le fichier "appsignal.log". Sélectionnez le logger que l'intégration AppSignal utilisera. Les valeurs acceptées sont `file` et `stdout`. Voir également la configuration `log_path`. * `file` (par défaut) * Écrit tous les logs AppSignal sur le système de fichiers. * `stdout` (par défaut sur [Heroku](https://heroku.com)) * Affiche les logs AppSignal dans la STDOUT du processus parent plutôt que dans un fichier. Utile avec des solutions d'hébergement telles que les systèmes de conteneurs et Heroku. ## logLevel | Champ | Valeur | | --------------------------------------- | --------------------- | | Clé du fichier de configuration | `logLevel` | | Clé de variable d'environnement système | `APPSIGNAL_LOG_LEVEL` | | Requis | non | | Type | `String` | | Valeur par défaut | `info` | | Disponible depuis la version | `2.2.6` | ### Description Cette option définit le niveau de sévérité du logger interne d'AppSignal et n'affecte pas la [fonctionnalité de journalisation](/logging). Définit le niveau de sévérité 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. Définir le niveau sur "debug" ou "trace" n'est généralement nécessaire qu'à la demande du support. Définir le niveau sur "debug"/"trace" pourrait 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 avec l'option debug activée. Valeurs acceptées : * error * warning * info * debug * trace ## logPath | Champ | Valeur | | --------------------------------------- | -------------------- | | Clé du fichier de configuration | `logPath` | | Clé de variable d'environnement système | `APPSIGNAL_LOG_PATH` | | Requis | non | | Type | `String` | | Valeur par défaut | `/tmp` | ### Description Cette option configure l'emplacement du fichier de journalisation interne d'AppSignal et n'affecte pas la [fonctionnalité de journalisation](/logging).
**Note** : 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 de répertoire personnel `~` pour les systèmes \*NIX. Cela sera considéré comme un chemin mal formé. Remplacez l'emplacement du chemin (répertoire) où le fichier `appsignal.log` peut être écrit. ## nginxPort | Champ | Valeur | | --------------------------------------- | ---------------------- | | Clé du fichier de configuration | `nginxPort` | | Clé de variable d'environnement système | `APPSIGNAL_NGINX_PORT` | | Requis | non | | Type | `Integer` | | Valeur par défaut | `27649` | | Disponible depuis la version | `3.6.7` | ### 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 afin qu'elle écoute sur un port différent. ## opentelemetry\_port | Champ | Valeur | | --------------------------------------- | ------------------------------ | | Clé du fichier de configuration | `opentelemetry_port` | | Clé de variable d'environnement système | `APPSIGNAL_OPENTELEMETRY_PORT` | | Requis | non | | Type | `String` | | Valeur par défaut | `8099` | | Disponible depuis la version | `3.1.0` | ### Description Définissez cette option pour configurer le port du serveur HTTP OpenTelemetry du processus de l'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. ## requestHeaders | Champ | Valeur | | --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ | | Clé du fichier de configuration | `requestHeaders` | | Clé de variable d'environnement système | `APPSIGNAL_REQUEST_HEADERS` | | Requis | non | | Type | `list(String)` | | Valeur par défaut | `["accept", "accept-charset", "accept-encoding", "accept-language", "cache-control", "connection", "content-length", "range"]` | | Disponible depuis la version | `2.2.5` | ### Description L'option de configuration `requestHeaders` contient une liste d'en-têtes de requête HTTP qui sont lus et stockés par le package AppSignal Node.js. Cette option de configuration `requestHeaders` est une *liste d'autorisation*, ce qui signifie qu'elle ne prendra que les en-têtes spécifiés par cette option de configuration. Si cette option de configuration n'est pas définie, elle utilisera la valeur par défaut d'AppSignal. La liste suivante est la valeur par défaut du package AppSignal. ```javascript Node.js theme={null} client = Appsignal.new( // ...Other config opts requestHeaders: [ "accept", "accept-charset", "accept-encoding", "accept-language", "cache-control", "connection", "content-length", "range" ] ) ``` Pour configurer AppSignal afin qu'il ne stocke aucun en-tête de requête HTTP sur les transactions AppSignal, configurez l'option avec une liste vide. ```javascript Node.js theme={null} client = Appsignal.new( // ...Other config opts requestHeaders: [] ) ``` ## revision | Champ | Valeur | | --------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | | Clé du fichier de configuration | `revision` | | Clé de variable d'environnement système | `APP_REVISION` | | Requis | non | | Type | `String` | | Valeur par défaut | `null` (non défini par défaut) | | Disponible depuis la version | `1.0.0` | | | | ### Description Définissez la révision de l'application pour signaler la version actuellement en cours d'exécution de votre application. AppSignal créera un marqueur de déploiement lorsque cette valeur change et étiquettera toutes les données entrantes avec la révision actuelle. Lorsque votre application est déployée à l'aide de Kamal, ou lorsqu'elle est déployée sur Render, ou lorsqu'elle est déployée sur Heroku et que la fonctionnalité [Heroku Labs : Dyno Metadata](https://devcenter.heroku.com/articles/dyno-metadata) est activée, l'intégration AppSignal détectera automatiquement le commit Git du déploiement actuel et l'utilisera comme révision. Vous pouvez remplacer les révisions détectées automatiquement sur Heroku, Render ou Kamal en définissant manuellement l'option de configuration `revision` sur une valeur personnalisée. En savoir plus sur les marqueurs de déploiement dans la [rubrique des marqueurs de déploiement](/application/markers/deploy-markers). ## runningInContainer | Champ | Valeur | | --------------------------------------- | -------------------------------- | | Clé du fichier de configuration | `runningInContainer` | | Clé de variable d'environnement système | `APPSIGNAL_RUNNING_IN_CONTAINER` | | Requis | non | | Type | Booléen (`true` / `false`) | | Valeur par défaut | détectée par l'agent | ### Description AppSignal s'attend à fonctionner 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 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](mailto:support@appsignal.com). Cette option est définie sur `true` automatiquement sur [Heroku](http://heroku.com/). ## sendEnvironmentMetadata | Champ | Valeur | | --------------------------------------- | ------------------------------------- | | Clé du fichier de configuration | `sendEnvironmentMetadata` | | Clé de variable d'environnement système | `APPSIGNAL_SEND_ENVIRONMENT_METADATA` | | Requis | non | | Type | Booléen (`true` / `false`) | | Valeur par défaut | `true` | | Disponible depuis la version | `2.2.6` | ### Description Envoie les métadonnées d'environnement concernant l'application. Pour plus d'informations, veuillez consulter les [métadonnées d'environnement](/application/environment-metadata). ## sendParams | Champ | Valeur | | --------------------------------------- | -------------------------- | | Clé du fichier de configuration | `sendParams` | | Clé de variable d'environnement système | `APPSIGNAL_SEND_PARAMS` | | Requis | non | | Type | Booléen (`true` / `false`) | | Valeur par défaut | `true` | | Disponible depuis la version | `2.2.8` | ### Description Indique s'il faut ne pas envoyer les paramètres de requête à AppSignal. Pour plus d'informations, veuillez consulter [send\_params](/application/parameter-filtering) dans le filtrage des paramètres de requête. ## sendSessionData | Champ | Valeur | | --------------------------------------- | ----------------------------- | | Clé du fichier de configuration | `sendSessionData` | | Clé de variable d'environnement système | `APPSIGNAL_SEND_SESSION_DATA` | | Requis | non | | Type | Booléen (`true` / `false`) | | Valeur par défaut | `true` | | Disponible depuis la version | `2.2.9` | ### Description Définissez cette option sur `false` pour ne pas envoyer de données de session avec les traces d'exceptions et les échantillons de problèmes de performances. Pour plus d'informations, veuillez consulter le [filtrage des données de session des requêtes](/application/session-data-filtering). ## statsdPort | Champ | Valeur | | --------------------------------------- | ----------------------- | | Clé du fichier de configuration | `statsdPort` | | Clé de variable d'environnement système | `APPSIGNAL_STATSD_PORT` | | Requis | non | | Type | `Integer` | | Valeur par défaut | `8125` | | Disponible depuis la version | `3.0.16` | ### Description Définissez cette option pour configurer le port du serveur HTTP StatsD du processus de l'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. ## workingDirectoryPath | Champ | Valeur | | --------------------------------------- | ---------------------------------- | | Clé du fichier de configuration | `workingDirectoryPath` | | Clé de variable d'environnement système | `APPSIGNAL_WORKING_DIRECTORY_PATH` | | Requis | non | | Type | `String` | | Valeur par défaut | détectée par l'agent | | Disponible depuis la version | `1.0.0` | ### Description Remplacez l'emplacement où AppSignal pour Node.js peut stocker des fichiers temporaires. Utilisez cette option si l'emplacement par défaut ne convient pas. Consultez notre page [comment fonctionne AppSignal](/appsignal/how-appsignal-operates) pour plus d'informations sur le rôle 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 différents répertoires de travail pour chaque instance AppSignal, sinon les deux instances pourraient entrer en conflit l'une avec l'autre. Pour plus d'informations sur ce scénario, consultez notre documentation [exécution de plusieurs applications sur un seul hôte](/guides/application/multiple-applications-on-one-host). ```javascript Node.js theme={null} // Example: appsignal.js const { Appsignal } = require("@appsignal/nodejs"); const appsignal = new Appsignal({ // Other config workingDirectoryPath: "/tmp/project_1" }); ``` **Note** : 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 de répertoire personnel `~` pour les systèmes \*NIX. Cela sera considéré comme un chemin mal formé.