Перейти до вмісту

Змінні оточення середовища виконання

Змінні оточення, що налаштовують сам 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 domain socket за допомогою nio; none (за замовчуванням) завершує їх помилкою.
NODE_TLS_REJECT_UNAUTHORIZED0 вимикає перевірку TLS-сертифікатів для fetch. Виводить попередження один раз.
NODE_USE_SYSTEM_CA1 довіряє системному сховищу сертифікатів для fetch.
NODE_EXTRA_CA_CERTSPEM-файл із додатковими сертифікатами CA для fetch.
ELIDE_MAVEN_TLS_EXTRA_CAPEM-файл із додатковими сертифікатами CA для завантажень 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Збирання контейнерівКаталог Docker-файлу config.json, чиї 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,... (значення в percent-кодуванні).
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 для OpenTelemetry API у застосунках. За замовчуванням 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

Чи була ця сторінка корисною?