Known issues

  • Kanzi Monitor disables the local console of the Command Processor when running in Kanzi Studio Preview. You can use the remote console in Kanzi Studio Preview.

  • Kanzi can load plugins from dynamic libraries in an unpredictable order. If other plugins depend on Kanzi Monitor during their initialization, explicitly load Kanzi Monitor from the application during startup. This lets the application make sure that the Kanzi Monitor plugin loads first.

  • When you enable the remote console, Kanzi Monitor attempts to open a remote console and bind to a socket port. This can fail if another application or another Kanzi Monitor instance already uses that port. To resolve this issue, choose a different port number, or avoid running another Kanzi Monitor instance with the remote console enabled at the same time.

  • When you enable the serial console, Kanzi Monitor attempts to open the configured serial port. This can fail if the port does not exist, another application uses it, or it requires elevated privileges. On Windows, virtual COM port drivers (such as com0com) can require test-signed driver mode.

  • On Android, Kanzi Monitor writes trace files to the host application’s internal files directory, which it resolves at startup from the engine-held Android Context (falling back to a reflective lookup). If Kanzi Monitor initializes before any Java entry point has run, no files directory can be resolved; in that case the file trace writers (chrometrace, perfetto) are not activated and the log records an error naming them, rather than failing later with Unable to open file. Stream traces with the perfetto-producer writer, which needs no output directory, or ensure a Java entry point runs before Kanzi Monitor initializes.

  • The perfetto-producer trace writer requires the plugin to be built with -DKZMONITOR_PERFETTO_PRODUCER=ON (pre-built Android binaries already are) AND a platform tracing daemon (Android traced or Linux perfetto). On Windows and platforms without a daemon, the writer is silently a no-op — use the in-process capture mode via PerfettoProducerCaptureSeconds to drive a session yourself, or stay on chrometrace / perfetto for offline output.

  • Android Studio Profiler (Iguana 2023.2 and later) does not expose the Perfetto track_event data source in its “Capture System Activities” task. As a result, a System Trace captured from inside AS Profiler does not show the kanzi.* tracks even when Kanzi Monitor is streaming them through the perfetto-producer writer. Workaround: capture the trace externally with cat kanzi.pbtx | adb shell perfetto --txt -c - -o /data/misc/perfetto-traces/kanzi.pftrace (feed the config on stdin and write into /data/misc/perfetto-traces/ — the on-device perfetto sandbox rejects /data/local/tmp for both with errno 13), then open the pulled file in AS Profiler with File → Open — the kanzi.* track-event categories render normally. Android Performance Analyzer (a separate tool) does expose track_event configuration and works as expected. See Using the Profiling Trace service for an example perfetto config.

See also

Release notes

Migration guides