vultr/openclaw
1
0
Fork 0
mirror of https://github.com/openclaw/openclaw.git synced 2026-05-06 10:20:42 +00:00
Code Issues Packages Projects Releases Wiki Activity

fix: gate diagnostics timeline by flag

Browse Source
This commit is contained in:
Shakker
2026-04-29 19:37:57 +01:00
parent 097eed8cd8
commit d001c3436b
4 changed files with 36 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files

22
docs/diagnostics/flags.md
View File

@@ -50,6 +50,28 @@ Disable all flags:
OPENCLAW_DIAGNOSTICS=0
```
## Timeline artifacts
The `timeline` flag writes structured startup and runtime timing events for
external QA harnesses:
```bash
OPENCLAW_DIAGNOSTICS=timeline \
OPENCLAW_DIAGNOSTICS_TIMELINE_PATH=/tmp/openclaw-timeline.jsonl \
openclaw gateway run
```
`OPENCLAW_DIAGNOSTICS=1`, `OPENCLAW_DIAGNOSTICS=all`, and
`OPENCLAW_DIAGNOSTICS=*` also enable the timeline because they enable every
diagnostics flag. Prefer `timeline` when you only want the JSONL timing
artifact.
Timeline records use the `openclaw.diagnostics.v1` envelope. Events can include
process ids, phase names, span names, durations, plugin ids, dependency counts,
event-loop delay samples, provider operation names, child-process exit state,
and startup error names/messages. Treat timeline files as local diagnostics
artifacts; review them before sharing outside your machine.
## Where logs go
Flags emit logs into the standard diagnostics log file. By default: