متغيرات بيئة التشغيل

تهيّئ هذه المتغيرات Elide. وتراها البرامج أيضًا في process.env.

المتغير	الغرض
`ELIDE_HOME`	مجلد تثبيت إصدارات Elide. الافتراضي `$XDG_DATA_HOME/elide` أو `~/.local/share/elide`.
`ELIDE_AUTO_INSTALL`	القيمة `1` تنزّل الإصدار المحدد في `.elideversion` دون سؤال.
`ELIDE_LOCALE`	لغة واجهة سطر الأوامر، مثل `--locale`.
`ELIDE_LOG`	مرشّح السجلات، مثل `debug`.
`ELIDE_LOG_STYLE`	تلوين السجلات: `auto` أو `always` أو `never`.
`ELIDE_ERROR_FORMAT`	القيمة `plain` تفرض إخراجًا بسيطًا للأخطاء غير الملتقطة، مثل `--error-format=plain`.
`ELIDE_REPL_HISTORY`	قاعدة بيانات سجل REPL. الافتراضي `~/.local/share/elide/repl/history.db` (في Linux).
`ELIDE_EDITOR`	القيمة `code` أو `idea` تربط مواضع الأخطاء بـ VS Code أو IntelliJ. يُستخدم `EDITOR` إن لم يُضبط.
`ELIDE_CRASH_ROOT`	مجلد تقارير الأعطال.
`ELIDE_AGENT`	القيمة `1` تفرض إخراج الوكلاء؛ و `0` توقف اكتشاف الوكلاء. راجع لوكلاء الذكاء الاصطناعي.
`ELIDE_MCP_TOKEN`	الرمز المميز للأمر `elide mcp --mode http`. عشوائي إن لم يُضبط.
`ELIDE_DEFER_EXIT`	في ⁦Linux:⁩ القيمة `0` تجعل العملية تحرّر ذاكرتها قبل الخروج.
`ELIDE_SYS_TMP`	يضبطه ⁦Elide:⁩ مجلد النظام المؤقت.
`ELIDE_HTTP_USER_AGENT`	قيمة `User-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_V2`	القيم `1` أو `true` أو `yes` أو `on` تختار `--transport=v2` عند عدم تمرير خيار.
`ELIDE_HTTP_FALLBACK`	القيمة `v1` تخدم طلبات مقابس نطاق Unix عبر `nio`؛ و `none` (الافتراضي) تُفشلها.
`NODE_TLS_REJECT_UNAUTHORIZED`	القيمة `0` تعطّل التحقق من شهادات TLS في `fetch`. يُصدر تحذيرًا مرة واحدة.
`NODE_USE_SYSTEM_CA`	القيمة `1` تثق بمخزن شهادات النظام في `fetch`.
`NODE_EXTRA_CA_CERTS`	ملف PEM يحوي شهادات CA إضافية للدالة `fetch`.
`ELIDE_MAVEN_TLS_EXTRA_CA`	ملف PEM يحوي شهادات 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_ENDPOINT`	عنوان URL لوكيل npm مع `--pkgst`. الافتراضي `https://npm.pkg.st`.
`ELIDE_PKGST_PYPI_ENDPOINT`	عنوان URL لوكيل PyPI مع `--pkgst`. الافتراضي `https://pypi.pkg.st`.
`ELIDE_REMOTE_CACHE`	عنوان URL لذاكرة البناء المؤقتة المشتركة. راجع ذاكرة البناء المؤقتة.
`ELIDE_REMOTE_CACHE_TOKEN`	رمز Bearer للذاكرة المؤقتة المشتركة.
`ELIDE_REMOTE_CACHE_USERNAME`	مستخدم مصادقة Basic للذاكرة المؤقتة المشتركة.
`ELIDE_REMOTE_CACHE_PASSWORD`	كلمة مرور مصادقة Basic للذاكرة المؤقتة المشتركة.
`ELIDE_REMOTE_CACHE_POLICY`	`eager` (الافتراضي) أو `smart`.
`ELIDE_REMOTE_CACHE_PULL`	القيمة `false` توقف التنزيل من الذاكرة المؤقتة المشتركة.
`ELIDE_REMOTE_CACHE_PUSH`	القيمة `false` توقف الرفع إلى الذاكرة المؤقتة المشتركة.
`ELIDE_BUILD_TELEMETRY`	القيمة `1` أو ملف أو مجلد تكتب أثر تتبّع للبناء (مهام البناء).
`ELIDE_KOTLINC_ABI_STRIP`	القيمة `1` مع `kotlinc --abi-only` تحذف أجسام الدوال أيضًا.
`ELIDE_WORKER_CLASSPATH_CACHE`	القيمة `0` توقف `javac --classpath-cache`.
`ELIDE_WORKER_CLASSPATH_CACHE_MAX_HANDLES`	الحد الأقصى لملفات JAR في classpath التي يُبقيها `javac --classpath-cache` مفتوحة. الافتراضي ملف لكل MiB من الكومة، بين 512 و65536.

التشخيص

المتغير	الغرض
`ELIDE_ENGINE_LOG`	يطبع سجلات بيئة التشغيل منخفضة المستوى إلى stderr.
`ELIDE_DIAG_STARTUP`	يطبع توقيتات مراحل بدء التشغيل إلى stderr.
`ELIDE_TRANSPORT_DIAGNOSTICS`	القيمة `1` تطبع إحصاءات نقل الشبكة إلى stderr.
`ELIDE_TRACE_PROCESSORS`	القيمة `1` تطبع إلى stderr صنف كل معالج تعليقات توضيحية في Java عند تحميله.

متغيرات من أدوات أخرى

المتغير	يقرؤه	الغرض
`LANGUAGE`، `LC_ALL`، `LC_MESSAGES`، `LANG`	واجهة سطر الأوامر	اللغة عند عدم ضبط `ELIDE_LOCALE`، ويُعتمد أول متغير مضبوط. حدّد منطقة (`fr_FR.UTF-8`)؛ فاللغة وحدها مثل `fr` تُتجاهل.
`JDK_JAVAC_OPTIONS`	`elide 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_WARNINGS`	JavaScript	يُلحق تحذيرات العملية بهذا الملف بدلًا من stderr.

متغيرات OpenTelemetry

يقرأ Elide متغيرات OpenTelemetry القياسية. وهي تتقدّم على كتلة opentelemetry، وتتقدّم عليها خيارات --otel-*؛ راجع التهيئة. وتُتجاهل القيم غير الصالحة.

المتغير	الغرض
`OTEL_SDK_DISABLED`	القيمة `true` توقف القياس عن بُعد.
`OTEL_SERVICE_NAME`	قيمة `service.name`.
`OTEL_RESOURCE_ATTRIBUTES`	سمات مورد إضافية، ⁦`key=value,...`⁩ (بقيم مرمّزة بالنسبة المئوية).
`OTEL_EXPORTER_OTLP_ENDPOINT`	عنوان URL الأساسي؛ ويُلحق به `/v1/<signal>` في HTTP. ينشئ وجهة `otlp` إن لم توجد أي وجهة.
`OTEL_EXPORTER_OTLP_PROTOCOL`	`grpc` أو `http/protobuf` (الافتراضي) أو `http/json`.
`OTEL_EXPORTER_OTLP_HEADERS`	ترويسات الطلب، ⁦`key=value,...`⁩. تُعامل كأسرار.
`OTEL_EXPORTER_OTLP_COMPRESSION`	`gzip` (الافتراضي) أو `none`.
`OTEL_EXPORTER_OTLP_TIMEOUT`	مهلة الطلب بالمللي ثانية. الافتراضي `10000`.
`OTEL_EXPORTER_OTLP_CERTIFICATE`	ملف PEM بشهادات موثوقة يحلّ محل مخزن الثقة في النظام.
`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_ARG`	`always_on` أو `always_off` أو `traceidratio` أو `parentbased_*` (الافتراضي `parentbased_always_on`)، والنسبة.
`OTEL_PROPAGATORS`	`tracecontext` أو `baggage` أو `none`، لواجهة OpenTelemetry API في التطبيقات. الافتراضي `tracecontext,baggage`. لا يفعّل baggage لخادم HTTP وعملائه في Elide.
`OTEL_METRIC_EXPORT_INTERVAL`	الفاصل الزمني لتصدير المقاييس بالمللي ثانية. الافتراضي `60000`.
`OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE`	`cumulative` (الافتراضي) أو `delta`.
`OTEL_METRICS_EXEMPLAR_FILTER`	`trace_based` (الافتراضي: القياسات داخل نطاق تتبع (span) مُعايَن)، أو `always_on`، أو `always_off`.
`OTEL_SEMCONV_EXCEPTION_SIGNAL_OPT_IN`	القيمة `logs` تسجّل الاستثناءات كسجلات فقط؛ و `logs/dup` (الافتراضي) تضيف أيضًا أحداث `exception` إلى نطاقات التتبع.
`OTEL_{TRACES,METRICS,LOGS}_EXPORTER`	القيمة `none` توقف تلك الإشارة للتطبيقات ولـ 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_INBOUND`	القيمة `true` تقبل ترويسات `baggage` في الطلبات المخدومة. الافتراضي `false`.
`ELIDE_OTEL_BAGGAGE_OUTBOUND`	القيمة `true` ترسل الـ baggage الحالي في طلبات HTTP الصادرة. الافتراضي `false`.
`ELIDE_OTEL_BAGGAGE_ALLOW`	مفاتيح baggage مفصولة بفواصل ومسموح بها في الاتجاهين. الافتراضي: كل المفاتيح.
`ELIDE_OTEL_PROFILES`	القيمة `true` تأخذ عينات من ملفات تعريف 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