Skip to content

Commit 3bed051

Browse files
committed
support extra env vars except the file watcher one
1 parent 27e89c0 commit 3bed051

4 files changed

Lines changed: 512 additions & 10 deletions

File tree

dial9-tokio-telemetry/README.md

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -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

88119
Missing variables use defaults. Blank or invalid values emit a warning and fall back to defaults.
89120

0 commit comments

Comments
 (0)