Aller au contenu

Variables d'environnement d'exécution

Les variables d'environnement qui configurent Elide lui-même, comme ELIDE_HOME, ELIDE_LOG, ELIDE_ERROR_FORMAT et ELIDE_EDITOR, ainsi que les variables de diagnostic et les variables d'autres outils qu'Elide prend en compte.

Sur cette page

Ces variables configurent Elide. Les programmes les voient aussi dans process.env.

VariableRôle
ELIDE_HOMERépertoire d’installation des versions d’Elide. Par défaut $XDG_DATA_HOME/elide ou ~/.local/share/elide.
ELIDE_AUTO_INSTALL1 télécharge sans demander la version épinglée dans .elideversion.
ELIDE_LOCALELangue de la CLI, comme --locale.
ELIDE_LOGFiltre des journaux, par exemple debug.
ELIDE_LOG_STYLECouleur des journaux : auto, always ou never.
ELIDE_ERROR_FORMATplain force une sortie brute des erreurs non interceptées, comme --error-format=plain.
ELIDE_REPL_HISTORYBase de données de l’historique du REPL. Par défaut ~/.local/share/elide/repl/history.db (Linux).
ELIDE_EDITORcode ou idea lie les emplacements d’erreur à VS Code ou IntelliJ. Utilise EDITOR si elle n’est pas définie.
ELIDE_CRASH_ROOTRépertoire des rapports de plantage.
ELIDE_AGENT1 force la sortie pour agents ; 0 désactive la détection des agents. Voir Pour les agents IA.
ELIDE_MCP_TOKENJeton pour elide mcp --mode http. Aléatoire si elle n’est pas définie.
ELIDE_DEFER_EXITLinux : 0 fait libérer sa mémoire au processus avant sa sortie.
ELIDE_SYS_TMPDéfinie par Elide : le répertoire temporaire du système.
ELIDE_HTTP_USER_AGENTUser-Agent pour fetch. Par défaut Elide/<version>.
ELIDE_HTTP_NATIVE_WORKERSWorkers du transport v2 pour un serveur hors d’un contexte d’application (par défaut cœurs ÷ 4, de 1 à 8). run, serve et dev l’ignorent ; leurs threads d’E/S suivent le nombre de contextes.
ELIDE_NETTY_EVENT_LOOPSThreads d’E/S du client et du serveur HTTP. Par défaut min(4, cores).
ELIDE_TRANSPORT_V21, true, yes ou on sélectionne --transport=v2 quand aucune option n’est donnée.
ELIDE_HTTP_FALLBACKv1 sert les requêtes sur socket de domaine Unix via nio ; none (par défaut) les fait échouer.
NODE_TLS_REJECT_UNAUTHORIZED0 désactive la vérification des certificats TLS pour fetch. Avertit une fois.
NODE_USE_SYSTEM_CA1 fait confiance au magasin de certificats du système pour fetch.
NODE_EXTRA_CA_CERTSFichier PEM de certificats d’AC supplémentaires pour fetch.
ELIDE_MAVEN_TLS_EXTRA_CAFichier PEM de certificats d’AC supplémentaires pour les téléchargements Maven.
ELIDE_MAVEN_<NAME>_USERNAME, ELIDE_MAVEN_<NAME>_PASSWORDIdentifiants pour elide publish --to <NAME> ; <NAME> est le nom du dépôt en majuscules, les autres caractères étant remplacés par _. Voir Publication Maven.
ELIDE_GPG_PASSPHRASEPhrase de passe permettant à elide publish de signer avec gpg en CI. Voir Publication Maven.
ELIDE_PKGST_NPM_ENDPOINTURL du proxy npm pour --pkgst. Par défaut https://npm.pkg.st.
ELIDE_PKGST_PYPI_ENDPOINTURL du proxy PyPI pour --pkgst. Par défaut https://pypi.pkg.st.
ELIDE_REMOTE_CACHEURL du cache de build partagé. Voir Cache de build.
ELIDE_REMOTE_CACHE_TOKENJeton Bearer pour le cache partagé.
ELIDE_REMOTE_CACHE_USERNAMEUtilisateur d’authentification Basic pour le cache partagé.
ELIDE_REMOTE_CACHE_PASSWORDMot de passe d’authentification Basic pour le cache partagé.
ELIDE_REMOTE_CACHE_POLICYeager (par défaut) ou smart.
ELIDE_REMOTE_CACHE_PULLfalse arrête les téléchargements depuis le cache partagé.
ELIDE_REMOTE_CACHE_PUSHfalse arrête les envois vers le cache partagé.
ELIDE_BUILD_TELEMETRY1, un fichier ou un répertoire écrit une trace de build (Tâches de build).
ELIDE_KOTLINC_ABI_STRIP1 avec kotlinc --abi-only supprime aussi le corps des fonctions.
ELIDE_WORKER_CLASSPATH_CACHE0 désactive javac --classpath-cache.
ELIDE_WORKER_CLASSPATH_CACHE_MAX_HANDLESNombre maximal de JAR du classpath que javac --classpath-cache garde ouverts. Par défaut un par Mio de tas, entre 512 et 65536.

Diagnostic

VariableRôle
ELIDE_ENGINE_LOGAffiche sur stderr les entrées de journal bas niveau de l’environnement d’exécution.
ELIDE_DIAG_STARTUPAffiche sur stderr la durée de chaque phase du démarrage.
ELIDE_TRANSPORT_DIAGNOSTICS1 affiche sur stderr les statistiques du transport réseau.
ELIDE_TRACE_PROCESSORS1 affiche sur stderr chaque classe de processeur d’annotations Java au moment de son chargement.

Variables d’autres outils

VariableLue parRôle
LANGUAGE, LC_ALL, LC_MESSAGES, LANGCLILangue quand ELIDE_LOCALE n’est pas définie ; la première définie l’emporte. Indiquez une région (fr_FR.UTF-8) ; une langue seule comme fr est ignorée.
JDK_JAVAC_OPTIONSelide javacOptions javac supplémentaires, comme avec le javac du JDK. La sortie utilise alors le format propre de javac.
DOCKER_CONFIGBuilds de conteneursRépertoire du config.json de Docker dont auths, credHelpers et credsStore fournissent les identifiants des registres. Par défaut ~/.docker.
UV_DEFAULT_INDEX, UV_INDEX_URLInstallations PythonIndex PyPI ; s’il est défini, --pkgst ne le modifie pas.
NODE_REDIRECT_WARNINGSJavaScriptAjoute les avertissements du processus à ce fichier au lieu de stderr.

Variables OpenTelemetry

Elide lit les variables OpenTelemetry standard. Elles prévalent sur le bloc opentelemetry, et les options --otel-* prévalent sur elles ; voir Configuration. Les valeurs invalides sont ignorées.

VariableRôle
OTEL_SDK_DISABLEDtrue désactive la télémétrie.
OTEL_SERVICE_NAMEservice.name.
OTEL_RESOURCE_ATTRIBUTESAttributs de ressource supplémentaires, key=value,... (valeurs encodées en pourcentage).
OTEL_EXPORTER_OTLP_ENDPOINTURL de base ; /v1/<signal> est ajouté pour HTTP. Crée une destination otlp s’il n’y en a aucune.
OTEL_EXPORTER_OTLP_PROTOCOLgrpc, http/protobuf (par défaut) ou http/json.
OTEL_EXPORTER_OTLP_HEADERSEn-têtes de requête, key=value,.... Traités comme des secrets.
OTEL_EXPORTER_OTLP_COMPRESSIONgzip (par défaut) ou none.
OTEL_EXPORTER_OTLP_TIMEOUTDélai d’expiration des requêtes en millisecondes. Par défaut 10000.
OTEL_EXPORTER_OTLP_CERTIFICATEFichier PEM de certificats de confiance, qui remplace le magasin de confiance du système.
OTEL_EXPORTER_OTLP_CLIENT_CERTIFICATE, OTEL_EXPORTER_OTLP_CLIENT_KEYChaîne de certificats client et clé privée PEM pour le TLS mutuel. Définissez les deux.
OTEL_EXPORTER_OTLP_{TRACES,METRICS,LOGS}_*ENDPOINT (utilisé tel quel), PROTOCOL, HEADERS, COMPRESSION, TIMEOUT, CERTIFICATE, CLIENT_CERTIFICATE, CLIENT_KEY par signal.
OTEL_TRACES_SAMPLER, OTEL_TRACES_SAMPLER_ARGalways_on, always_off, traceidratio ou parentbased_* (par défaut parentbased_always_on), et le ratio.
OTEL_PROPAGATORStracecontext, baggage ou none, pour l’API OpenTelemetry dans les applications. Par défaut tracecontext,baggage. N’active pas le baggage pour le serveur et les clients HTTP d’Elide.
OTEL_METRIC_EXPORT_INTERVALIntervalle d’export des métriques en millisecondes. Par défaut 60000.
OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCEcumulative (par défaut) ou delta.
OTEL_METRICS_EXEMPLAR_FILTERtrace_based (par défaut : les mesures prises dans un span échantillonné), always_on ou always_off.
OTEL_SEMCONV_EXCEPTION_SIGNAL_OPT_INlogs enregistre les exceptions uniquement comme entrées de journal ; logs/dup (par défaut) ajoute aussi des événements de span exception.
OTEL_{TRACES,METRICS,LOGS}_EXPORTERnone désactive ce signal, pour les applications comme pour Elide. otlp sans destination configurée envoie ce signal à http://localhost:4318 (4317 pour gRPC).

Les variables OTEL_EXPORTER_OTLP_* s’appliquent à toutes les destinations qui utilisent le fournisseur otlp. Elide ajoute un raccourci pour les préréglages de fournisseurs :

VariableRôle
ELIDE_OTEL_PROVIDERAjoute une destination pour un fournisseur : otlp, sentry, datadog, posthog, honeycomb ou grafana.
ELIDE_OTEL_REGIONSite ou région du fournisseur, par exemple us5 (Datadog), eu (PostHog, Honeycomb), prod-us-east-0 (Grafana).
ELIDE_OTEL_SIGNALSSignaux de cette destination, par exemple traces,logs. Par défaut : les signaux par défaut du fournisseur.
ELIDE_OTEL_BAGGAGE_INBOUNDtrue accepte les en-têtes baggage des requêtes servies. Par défaut false.
ELIDE_OTEL_BAGGAGE_OUTBOUNDtrue envoie le baggage courant dans les requêtes HTTP sortantes. Par défaut false.
ELIDE_OTEL_BAGGAGE_ALLOWClés de baggage autorisées dans les deux sens, séparées par des virgules. Par défaut : toutes les clés.
ELIDE_OTEL_PROFILEStrue échantillonne les profils CPU du code invité 100 fois par seconde ; une fréquence comme 49 est aussi acceptée. Désactivé par défaut.

Les identifiants des fournisseurs viennent de leurs variables habituelles : SENTRY_DSN, DD_API_KEY (et DD_SITE), POSTHOG_PROJECT_TOKEN, HONEYCOMB_API_KEY et GRAFANA_CLOUD_OTLP_CREDENTIAL (<instance id>:<token>).

ELIDE_OTEL_PROVIDER=honeycomb HONEYCOMB_API_KEY=... elide serve app.ts

Cette page vous a-t-elle aidé ?