Перейти к содержимому

Переменные окружения среды выполнения

Переменные окружения, которые настраивают сам Elide, например ELIDE_HOME, ELIDE_LOG, ELIDE_ERROR_FORMAT и ELIDE_EDITOR, а также диагностические переменные и переменные других инструментов, которые учитывает Elide.

На этой странице

Эти переменные настраивают Elide. Программы тоже видят их в process.env.

ПеременнаяНазначение
ELIDE_HOMEКаталог установки версий Elide. По умолчанию $XDG_DATA_HOME/elide или ~/.local/share/elide.
ELIDE_AUTO_INSTALL1 скачивает версию, закреплённую в .elideversion, без запроса.
ELIDE_LOCALEЯзык CLI, как --locale.
ELIDE_LOGФильтр журнала, например debug.
ELIDE_LOG_STYLEЦвет журнала: auto, always или never.
ELIDE_ERROR_FORMATplain включает простой вывод неперехваченных ошибок, как --error-format=plain.
ELIDE_REPL_HISTORYБаза данных истории REPL. По умолчанию ~/.local/share/elide/repl/history.db (Linux).
ELIDE_EDITORcode или idea превращает места ошибок в ссылки, открывающиеся в VS Code или IntelliJ. Если не задана, используется EDITOR.
ELIDE_CRASH_ROOTКаталог для отчётов о сбоях.
ELIDE_AGENT1 включает вывод для агентов; 0 отключает распознавание агентов. См. Для ИИ-агентов.
ELIDE_MCP_TOKENТокен для elide mcp --mode http. Если не задана, токен случайный.
ELIDE_DEFER_EXITLinux: 0 заставляет процесс освобождать память перед выходом.
ELIDE_SYS_TMPЗадаётся Elide: системный каталог временных файлов.
ELIDE_HTTP_USER_AGENTUser-Agent для fetch. По умолчанию Elide/<version>.
ELIDE_HTTP_NATIVE_WORKERSРабочие потоки транспорта v2 для сервера вне контекста приложения (по умолчанию ядра ÷ 4, от 1 до 8). run, serve и dev её игнорируют: число их потоков ввода-вывода зависит от числа контекстов.
ELIDE_NETTY_EVENT_LOOPSПотоки ввода-вывода HTTP-клиента и сервера. По умолчанию min(4, cores).
ELIDE_TRANSPORT_V21, true, yes или on выбирает --transport=v2, если флаг не указан.
ELIDE_HTTP_FALLBACKv1 обслуживает запросы через Unix-сокеты с помощью nio; none (по умолчанию) завершает их ошибкой.
NODE_TLS_REJECT_UNAUTHORIZED0 отключает проверку TLS-сертификатов для fetch. Один раз выводит предупреждение.
NODE_USE_SYSTEM_CA1 включает доверие к системному хранилищу сертификатов для fetch.
NODE_EXTRA_CA_CERTSPEM-файл с дополнительными сертификатами УЦ для fetch.
ELIDE_MAVEN_TLS_EXTRA_CAPEM-файл с дополнительными сертификатами УЦ для загрузок из Maven.
ELIDE_MAVEN_<NAME>_USERNAME, ELIDE_MAVEN_<NAME>_PASSWORDУчётные данные для elide publish --to <NAME>; <NAME> — имя репозитория в верхнем регистре, где прочие символы заменены на _. См. Публикация в Maven.
ELIDE_GPG_PASSPHRASEПарольная фраза, с которой elide publish подписывает через gpg в CI. См. Публикация в Maven.
ELIDE_PKGST_NPM_ENDPOINTURL прокси npm для --pkgst. По умолчанию https://npm.pkg.st.
ELIDE_PKGST_PYPI_ENDPOINTURL прокси PyPI для --pkgst. По умолчанию https://pypi.pkg.st.
ELIDE_REMOTE_CACHEURL общего кеша сборки. См. Кеш сборки.
ELIDE_REMOTE_CACHE_TOKENBearer-токен для общего кеша.
ELIDE_REMOTE_CACHE_USERNAMEПользователь Basic-аутентификации для общего кеша.
ELIDE_REMOTE_CACHE_PASSWORDПароль Basic-аутентификации для общего кеша.
ELIDE_REMOTE_CACHE_POLICYeager (по умолчанию) или smart.
ELIDE_REMOTE_CACHE_PULLfalse отключает загрузку из общего кеша.
ELIDE_REMOTE_CACHE_PUSHfalse отключает выгрузку в общий кеш.
ELIDE_BUILD_TELEMETRY1, файл или каталог включает запись трассировки сборки (Задачи сборки).
ELIDE_KOTLINC_ABI_STRIP1 вместе с kotlinc --abi-only удаляет ещё и тела функций.
ELIDE_WORKER_CLASSPATH_CACHE0 отключает javac --classpath-cache.
ELIDE_WORKER_CLASSPATH_CACHE_MAX_HANDLESМаксимальное число JAR-файлов из classpath, которые javac --classpath-cache держит открытыми. По умолчанию один на МиБ кучи, от 512 до 65536.

Диагностика

ПеременнаяНазначение
ELIDE_ENGINE_LOGВыводит в stderr низкоуровневые записи журнала среды выполнения.
ELIDE_DIAG_STARTUPВыводит в stderr время каждой фазы запуска.
ELIDE_TRANSPORT_DIAGNOSTICS1 выводит в stderr статистику сетевого транспорта.
ELIDE_TRACE_PROCESSORS1 выводит в stderr каждый класс процессора аннотаций Java при его загрузке.

Переменные других инструментов

ПеременнаяКто читаетНазначение
LANGUAGE, LC_ALL, LC_MESSAGES, LANGCLIЯзык, если ELIDE_LOCALE не задана; действует первая заданная. Укажите регион (fr_FR.UTF-8): язык без региона, например fr, игнорируется.
JDK_JAVAC_OPTIONSelide javacДополнительные параметры javac, как у javac из JDK. Вывод тогда идёт в собственном формате javac.
DOCKER_CONFIGСборки контейнеровКаталог файла config.json Docker, чьи auths, credHelpers и credsStore дают учётные данные реестров. По умолчанию ~/.docker.
UV_DEFAULT_INDEX, UV_INDEX_URLУстановка пакетов PythonИндекс PyPI; если он задан, --pkgst его не меняет.
NODE_REDIRECT_WARNINGSJavaScriptДописывает предупреждения процесса в этот файл вместо stderr.

Переменные OpenTelemetry

Elide читает стандартные переменные OpenTelemetry. Они переопределяют блок opentelemetry, а их самих переопределяют флаги --otel-*; см. Конфигурация. Недопустимые значения игнорируются.

ПеременнаяНазначение
OTEL_SDK_DISABLEDtrue отключает телеметрию.
OTEL_SERVICE_NAMEservice.name.
OTEL_RESOURCE_ATTRIBUTESДополнительные атрибуты ресурса, key=value,... (значения в процентной кодировке).
OTEL_EXPORTER_OTLP_ENDPOINTБазовый URL; для HTTP к нему добавляется /v1/<signal>. Создаёт назначение otlp, если ни одного нет.
OTEL_EXPORTER_OTLP_PROTOCOLgrpc, http/protobuf (по умолчанию) или http/json.
OTEL_EXPORTER_OTLP_HEADERSЗаголовки запросов, key=value,.... Считаются секретами.
OTEL_EXPORTER_OTLP_COMPRESSIONgzip (по умолчанию) или none.
OTEL_EXPORTER_OTLP_TIMEOUTТайм-аут запроса в миллисекундах. По умолчанию 10000.
OTEL_EXPORTER_OTLP_CERTIFICATEPEM-файл доверенных сертификатов вместо системного хранилища.
OTEL_EXPORTER_OTLP_CLIENT_CERTIFICATE, OTEL_EXPORTER_OTLP_CLIENT_KEYЦепочка клиентских сертификатов и закрытый ключ в формате PEM для взаимного TLS. Задайте обе.
OTEL_EXPORTER_OTLP_{TRACES,METRICS,LOGS}_*ENDPOINT (используется как есть), PROTOCOL, HEADERS, COMPRESSION, TIMEOUT, CERTIFICATE, CLIENT_CERTIFICATE, CLIENT_KEY для отдельного сигнала.
OTEL_TRACES_SAMPLER, OTEL_TRACES_SAMPLER_ARGalways_on, always_off, traceidratio или parentbased_* (по умолчанию parentbased_always_on) и доля выборки.
OTEL_PROPAGATORStracecontext, baggage или none для API OpenTelemetry в приложениях. По умолчанию tracecontext,baggage. Не включает baggage для HTTP-сервера и клиентов Elide.
OTEL_METRIC_EXPORT_INTERVALИнтервал экспорта метрик в миллисекундах. По умолчанию 60000.
OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCEcumulative (по умолчанию) или delta.
OTEL_METRICS_EXEMPLAR_FILTERtrace_based (по умолчанию: измерения внутри сэмплированного спана), always_on или always_off.
OTEL_SEMCONV_EXCEPTION_SIGNAL_OPT_INlogs записывает исключения только как записи журнала; logs/dup (по умолчанию) также добавляет события спана exception.
OTEL_{TRACES,METRICS,LOGS}_EXPORTERnone отключает этот сигнал и для приложений, и для Elide. otlp без настроенного назначения отправляет сигнал на http://localhost:4318 (4317 для gRPC).

Переменные OTEL_EXPORTER_OTLP_* действуют на все назначения с провайдером otlp. Для пресетов провайдеров Elide добавляет сокращённую форму:

ПеременнаяНазначение
ELIDE_OTEL_PROVIDERДобавляет назначение для провайдера: otlp, sentry, datadog, posthog, honeycomb или grafana.
ELIDE_OTEL_REGIONСайт или регион провайдера, например us5 (Datadog), eu (PostHog, Honeycomb), prod-us-east-0 (Grafana).
ELIDE_OTEL_SIGNALSСигналы для этого назначения, например traces,logs. По умолчанию — сигналы провайдера по умолчанию.
ELIDE_OTEL_BAGGAGE_INBOUNDtrue принимает заголовки baggage обслуживаемых запросов. По умолчанию false.
ELIDE_OTEL_BAGGAGE_OUTBOUNDtrue отправляет текущий baggage в исходящих HTTP-запросах. По умолчанию false.
ELIDE_OTEL_BAGGAGE_ALLOWКлючи baggage через запятую, разрешённые в обоих направлениях. По умолчанию — все ключи.
ELIDE_OTEL_PROFILEStrue снимает профили CPU гостевого кода с частотой 100 в секунду; можно задать частоту, например 49. По умолчанию выключено.

Учётные данные провайдеров берутся из их обычных переменных: SENTRY_DSN, DD_API_KEY (и DD_SITE), POSTHOG_PROJECT_TOKEN, HONEYCOMB_API_KEY и GRAFANA_CLOUD_OTLP_CREDENTIAL (<instance id>:<token>).

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

Была ли эта страница полезной?