Distinguish an active Axis MQTT client from a connected session

Check the broker connection state separately from the MQTT client’s activation state when diagnosing missing camera messages.

Source facts

Axis documents an MQTT client with active and inactive lifecycle states. An active client may already be connected or may still be trying to connect to the configured broker. Activation persists after a reboot. The getClientStatus operation returns status and configuration, while getSupportedVersions identifies API versions supported by the device. Configuration and activation are separate operations in the documented interface.

Source: Axis Communications — VAPIX MQTT client API.

Applicability

Use this guide for Axis devices exposing the MQTT client API. Confirm API discovery and supported versions on the actual device before relying on a particular integration.

DSE recommendation

DSE recommends making broker connection state an explicit diagnostic field rather than interpreting an enabled toggle as message-delivery evidence. Record the intended broker, client identifier, transport, trust configuration, and authorized topic scope without saving passwords. Review camera-side state alongside broker-side logs. Keep MQTT connection checks separate from recording health so one successful subsystem does not conceal another failure. Define who responds when a client remains active but cannot establish its broker session, and preserve a supported recovery procedure.

Verification

In an approved pilot, verify configuration, activation, broker connection, and receipt of a representative message as separate checkpoints. Restart the test device and observe reconnection. Include a controlled broker-unavailable case and record how monitoring distinguishes an activated client from a working message path.

Official reference

Axis Communications — VAPIX MQTT client API. Reviewed October 14, 2026.