Migration guides¶
Use these guides to update a project from an earlier version of Kanzi Monitor to Kanzi Monitor 1.6.1. Follow the section for the version you are coming from. All 1.6.x releases target the Kanzi 3.6 generation, so no Kanzi engine migration is involved.
Migrating from Kanzi Monitor 1.6.0 to 1.6.1¶
Engine version support. Kanzi Monitor 1.6.1 supports Kanzi 3.6.3 through 3.6.21, where 1.6.0 was verified against 3.6.21 only. The wider support is automatic and requires no project changes; note that at Kanzi 3.6.3 only statically linked builds are supported (KZMON-426).
Trace timestamps. Profiling trace files now use session-relative timestamps (the first event starts at 0) instead of absolute engine-clock values. The Perfetto trace viewer and the bundled tools treat the
tsfield as relative, so no action is needed. If you have a custom tool that reads Kanzi Monitor trace files and relies ontsbeing an absolute (since-boot or since-epoch) value, update it to treattsas relative to the start of the capture (KZMON-495).Trace configuration key. The frame-duration trace-trigger key was corrected from the misspelled
WritingOnFrameDurationTresholdtoWritingOnFrameDurationThreshold. No action is required — the old spelling remains accepted as a deprecated alias — but update yourkanzimonitor.cfgto the corrected key when convenient (KZMON-494).Image orientation. Screenshot, texture, and render-pass previews are now flipped vertically by default so they match screen orientation (GPU readback is bottom-up). If you relied on the previous raw (bottom-up) output — for example a script that post-processes MCP PNGs — account for the new orientation, or in the Web UI uncheck Flip vertical. The raw
overwatch.*command output is unchanged (KZMON-404).Android debug symbols (source builds). When you build the Android plugin from source, debug builds now minimize debugging information by default (line tables only), producing smaller
.sofiles. No action is needed unless you debug native crashes with full symbols — pass-PminimizeDebug=falseto the Gradle build to restore them. Prebuilt binaries in the delivered packages are unaffected (KZMON-492).quit and appquit on Android. On Android these commands no longer report
executed successfully; they take no action and report that they are not supported, because the platform owns the process lifecycle. Update any automation that parsed the previous response (KZMON-498).