Saltar al contenido

Variables de entorno del runtime

Variables de entorno que configuran el propio Elide, como ELIDE_HOME, ELIDE_LOG, ELIDE_ERROR_FORMAT y ELIDE_EDITOR, además de variables de diagnóstico y variables de otras herramientas que Elide respeta.

En esta página

Estas variables configuran Elide. Los programas también las ven en process.env.

VariablePropósito
ELIDE_HOMEDirectorio de instalación de las versiones de Elide. Por defecto $XDG_DATA_HOME/elide o ~/.local/share/elide.
ELIDE_AUTO_INSTALL1 descarga sin preguntar la versión fijada en .elideversion.
ELIDE_LOCALEIdioma de la CLI, como --locale.
ELIDE_LOGFiltro de registros, por ejemplo debug.
ELIDE_LOG_STYLEColor de los registros: auto, always o never.
ELIDE_ERROR_FORMATplain fuerza la salida simple de errores no capturados, como --error-format=plain.
ELIDE_REPL_HISTORYBase de datos del historial del REPL. Por defecto ~/.local/share/elide/repl/history.db (Linux).
ELIDE_EDITORcode o idea enlaza las ubicaciones de los errores con VS Code o IntelliJ. Si no está definida, usa EDITOR.
ELIDE_CRASH_ROOTDirectorio de los informes de fallos.
ELIDE_AGENT1 fuerza la salida para agentes; 0 desactiva la detección de agentes. Consulte Para agentes de IA.
ELIDE_MCP_TOKENToken de elide mcp --mode http. Aleatorio si no está definida.
ELIDE_DEFER_EXITLinux: 0 hace que el proceso libere su memoria antes de salir.
ELIDE_SYS_TMPLa define Elide: el directorio temporal del sistema.
ELIDE_HTTP_USER_AGENTUser-Agent de fetch. Por defecto Elide/<version>.
ELIDE_HTTP_NATIVE_WORKERSWorkers del transporte v2 para un servidor fuera de un contexto de aplicación (por defecto núcleos ÷ 4, de 1 a 8). run, serve y dev la ignoran; sus hilos de E/S siguen el número de contextos.
ELIDE_NETTY_EVENT_LOOPSHilos de E/S del cliente y del servidor HTTP. Por defecto min(4, cores).
ELIDE_TRANSPORT_V21, true, yes u on selecciona --transport=v2 cuando no se pasa la opción.
ELIDE_HTTP_FALLBACKv1 atiende las peticiones por sockets de dominio Unix mediante nio; none (por defecto) las rechaza.
NODE_TLS_REJECT_UNAUTHORIZED0 desactiva la comprobación de certificados TLS en fetch. Avisa una vez.
NODE_USE_SYSTEM_CA1 confía en el almacén de certificados del sistema para fetch.
NODE_EXTRA_CA_CERTSArchivo PEM con certificados de CA adicionales para fetch.
ELIDE_MAVEN_TLS_EXTRA_CAArchivo PEM con certificados de CA adicionales para las descargas de Maven.
ELIDE_MAVEN_<NAME>_USERNAME, ELIDE_MAVEN_<NAME>_PASSWORDCredenciales de elide publish --to <NAME>; <NAME> es el nombre del repositorio en mayúsculas, con los demás caracteres cambiados por _. Consulte Publicación en Maven.
ELIDE_GPG_PASSPHRASEFrase de contraseña con la que elide publish firma mediante gpg en CI. Consulte Publicación en Maven.
ELIDE_PKGST_NPM_ENDPOINTURL del proxy de npm para --pkgst. Por defecto https://npm.pkg.st.
ELIDE_PKGST_PYPI_ENDPOINTURL del proxy de PyPI para --pkgst. Por defecto https://pypi.pkg.st.
ELIDE_REMOTE_CACHEURL de la caché de compilación compartida. Consulte Caché de compilación.
ELIDE_REMOTE_CACHE_TOKENToken bearer de la caché compartida.
ELIDE_REMOTE_CACHE_USERNAMEUsuario de autenticación básica de la caché compartida.
ELIDE_REMOTE_CACHE_PASSWORDContraseña de autenticación básica de la caché compartida.
ELIDE_REMOTE_CACHE_POLICYeager (por defecto) o smart.
ELIDE_REMOTE_CACHE_PULLfalse detiene las descargas desde la caché compartida.
ELIDE_REMOTE_CACHE_PUSHfalse detiene las subidas a la caché compartida.
ELIDE_BUILD_TELEMETRY1, un archivo o un directorio escribe una traza de la compilación (Tareas de compilación).
ELIDE_KOTLINC_ABI_STRIP1 con kotlinc --abi-only también elimina los cuerpos de las funciones.
ELIDE_WORKER_CLASSPATH_CACHE0 desactiva javac --classpath-cache.
ELIDE_WORKER_CLASSPATH_CACHE_MAX_HANDLESMáximo de JAR del classpath que javac --classpath-cache mantiene abiertos. Por defecto uno por MiB de heap, entre 512 y 65536.

Diagnóstico

VariablePropósito
ELIDE_ENGINE_LOGImprime en stderr los registros de bajo nivel del entorno de ejecución.
ELIDE_DIAG_STARTUPImprime en stderr los tiempos de cada fase del arranque.
ELIDE_TRANSPORT_DIAGNOSTICS1 imprime en stderr estadísticas del transporte de red.
ELIDE_TRACE_PROCESSORS1 imprime en stderr cada clase de procesador de anotaciones de Java a medida que se carga.

Variables de otras herramientas

VariableLa leePropósito
LANGUAGE, LC_ALL, LC_MESSAGES, LANGCLIIdioma cuando ELIDE_LOCALE no está definida; gana la primera que esté definida. Indique una región (fr_FR.UTF-8); un idioma solo, como fr, se ignora.
JDK_JAVAC_OPTIONSelide javacOpciones adicionales de javac, como con el javac del JDK. La salida usa entonces el formato propio de javac.
DOCKER_CONFIGCompilaciones de contenedoresDirectorio del config.json de Docker cuyos auths, credHelpers y credsStore aportan las credenciales del registro. Por defecto ~/.docker.
UV_DEFAULT_INDEX, UV_INDEX_URLInstalaciones de PythonÍndice de PyPI; si está definida, --pkgst no la modifica.
NODE_REDIRECT_WARNINGSJavaScriptAñade las advertencias del proceso a este archivo en lugar de a stderr.

Variables de OpenTelemetry

Elide lee las variables estándar de OpenTelemetry. Prevalecen sobre el bloque opentelemetry y las opciones --otel-* prevalecen sobre ellas; consulte Configuración. Los valores no válidos se ignoran.

VariablePropósito
OTEL_SDK_DISABLEDtrue desactiva la telemetría.
OTEL_SERVICE_NAMEservice.name.
OTEL_RESOURCE_ATTRIBUTESAtributos de recurso adicionales, key=value,... (valores con codificación porcentual).
OTEL_EXPORTER_OTLP_ENDPOINTURL base; en HTTP se añade /v1/<signal>. Crea un destino otlp si no existe ninguno.
OTEL_EXPORTER_OTLP_PROTOCOLgrpc, http/protobuf (por defecto) o http/json.
OTEL_EXPORTER_OTLP_HEADERSCabeceras de las peticiones, key=value,.... Se tratan como secretos.
OTEL_EXPORTER_OTLP_COMPRESSIONgzip (por defecto) o none.
OTEL_EXPORTER_OTLP_TIMEOUTTiempo de espera de las peticiones en milisegundos. Por defecto 10000.
OTEL_EXPORTER_OTLP_CERTIFICATEArchivo PEM de certificados de confianza, que sustituye al almacén de confianza del sistema.
OTEL_EXPORTER_OTLP_CLIENT_CERTIFICATE, OTEL_EXPORTER_OTLP_CLIENT_KEYCadena de certificados de cliente y clave privada PEM para TLS mutuo. Defina ambas.
OTEL_EXPORTER_OTLP_{TRACES,METRICS,LOGS}_*ENDPOINT por señal (se usa tal cual), PROTOCOL, HEADERS, COMPRESSION, TIMEOUT, CERTIFICATE, CLIENT_CERTIFICATE, CLIENT_KEY.
OTEL_TRACES_SAMPLER, OTEL_TRACES_SAMPLER_ARGalways_on, always_off, traceidratio o parentbased_* (por defecto parentbased_always_on), y la proporción.
OTEL_PROPAGATORStracecontext, baggage o none, para la API de OpenTelemetry en las aplicaciones. Por defecto tracecontext,baggage. No activa el baggage en el servidor y los clientes HTTP de Elide.
OTEL_METRIC_EXPORT_INTERVALIntervalo de exportación de métricas en milisegundos. Por defecto 60000.
OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCEcumulative (por defecto) o delta.
OTEL_METRICS_EXEMPLAR_FILTERtrace_based (por defecto: mediciones dentro de un span muestreado), always_on o always_off.
OTEL_SEMCONV_EXCEPTION_SIGNAL_OPT_INlogs registra las excepciones solo como entradas de registro; logs/dup (por defecto) también añade eventos de span exception.
OTEL_{TRACES,METRICS,LOGS}_EXPORTERnone desactiva esa señal, tanto para las aplicaciones como para Elide. otlp sin destino configurado envía esa señal a http://localhost:4318 (4317 para gRPC).

OTEL_EXPORTER_OTLP_* se aplican a todos los destinos que usan el proveedor otlp. Elide añade una forma abreviada para los preajustes de proveedor:

VariablePropósito
ELIDE_OTEL_PROVIDERAñade un destino para un proveedor: otlp, sentry, datadog, posthog, honeycomb o grafana.
ELIDE_OTEL_REGIONSitio o región del proveedor, por ejemplo us5 (Datadog), eu (PostHog, Honeycomb), prod-us-east-0 (Grafana).
ELIDE_OTEL_SIGNALSSeñales de ese destino, por ejemplo traces,logs. Por defecto, las señales predeterminadas del proveedor.
ELIDE_OTEL_BAGGAGE_INBOUNDtrue admite las cabeceras baggage de las peticiones atendidas. Por defecto false.
ELIDE_OTEL_BAGGAGE_OUTBOUNDtrue envía el baggage actual en las peticiones HTTP salientes. Por defecto false.
ELIDE_OTEL_BAGGAGE_ALLOWClaves de baggage separadas por comas que se permiten en ambas direcciones. Por defecto, todas.
ELIDE_OTEL_PROFILEStrue toma muestras de perfiles de CPU del código invitado 100 veces por segundo; también admite una frecuencia como 49. Desactivada por defecto.

Las credenciales de los proveedores vienen de sus variables habituales: SENTRY_DSN, DD_API_KEY (y DD_SITE), POSTHOG_PROJECT_TOKEN, HONEYCOMB_API_KEY y GRAFANA_CLOUD_OTLP_CREDENTIAL (<instance id>:<token>).

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

¿Te resultó útil esta página?