@@ -84,6 +84,37 @@ async fn main() {
8484| ` DIAL9_TRACE_DIR ` | ` /tmp/dial9-traces ` | Directory for rotated trace segments. |
8585| ` DIAL9_ROTATION_SECS ` | ` 60 ` | Wall-clock rotation period in seconds. |
8686| ` DIAL9_MAX_DISK_USAGE_MB ` | ` 1024 ` | Total on-disk trace budget in MiB. |
87+ | ` DIAL9_MAX_FILE_SIZE_MB ` | ` max(total / 4, 16) ` | Per-file trace segment size in MiB. |
88+
89+ Runtime knobs:
90+
91+ | Name | Default | Meaning |
92+ | --- | --- | --- |
93+ | ` DIAL9_TASK_TRACKING_ENABLED ` | ` true ` | Track tasks spawned through dial9 handles. |
94+ | ` DIAL9_RUNTIME_NAME ` | unset | Human-readable runtime name in trace metadata. |
95+
96+ S3 upload knobs (` worker-s3 ` feature required):
97+
98+ | Name | Default | Meaning |
99+ | --- | --- | --- |
100+ | ` DIAL9_S3_BUCKET ` | unset | Upload sealed trace segments to this bucket. |
101+ | ` DIAL9_SERVICE_NAME ` | binary name | Service name used in S3 keys and metadata. |
102+ | ` DIAL9_S3_PREFIX ` | unset | Optional S3 object key prefix. |
103+
104+ CPU profiling knobs (` cpu-profiling ` feature required):
105+
106+ | Name | Default | Meaning |
107+ | --- | --- | --- |
108+ | ` DIAL9_CPU_PROFILE_ENABLED ` | ` true ` on Linux, ` false ` elsewhere | Enable CPU stack sampling. |
109+ | ` DIAL9_CPU_SAMPLE_HZ ` | ` 99 ` | CPU sampling frequency in Hz. |
110+ | ` DIAL9_SCHEDULE_PROFILE_ENABLED ` | ` true ` on Linux, ` false ` elsewhere | Enable per-worker scheduler event capture. |
111+
112+ Task dump knobs (capture requires the ` taskdump ` feature):
113+
114+ | Name | Default | Meaning |
115+ | --- | --- | --- |
116+ | ` DIAL9_TASK_DUMP_ENABLED ` | ` false ` | Capture async task dumps at idle yield points. |
117+ | ` DIAL9_TASK_DUMP_IDLE_THRESHOLD_MS ` | ` 10 ` | Mean idle duration for task dump sampling. |
87118
88119Missing variables use defaults. Blank or invalid values emit a warning and fall back to defaults.
89120
0 commit comments