Translate Axis event namespaces before building an RTSP filter

Translate Axis event-declaration prefixes into the documented RTSP event-topic filter prefixes. Preserve the selected topic and message-content filter separately when checking event receipt.

Integrated video surveillance and controlled entry at a modern commercial facility.
DSE visual intelligencePhysical securityGuide · 3 min read
Executive summary

What you need to know

Translate Axis event-declaration prefixes into the documented RTSP event-topic filter prefixes. Preserve the selected topic and message-content filter separately when checking event receipt.

Potentially affected

Axis products exposing the documented Event data streaming interface; confirm actual device, hardware and software applicability before applying the proposed checks.

DSE recommendation

DSE recommends storing the device declaration, translated topic expression and optional content expression as separate reviewed fields.

Bottom line: Keep the declared event identity and its RTSP subscription expression together. Resolve the namespace translation before treating a missing notification as proof that the physical event never occurred.

Source fact: documented behavior

Axis’s Event data streaming says event declarations use tns1 and tnsaxis, while event-topic filters use onvif and axis respectively.

The documented stream carries XML event notifications over RTSP/RTP, and the workflow begins by querying supported event declarations.

The source distinguishes the eventtopic topic filter from the eventcontent filter for message source, key and data elements.

What the source does not establish

Do not infer an identical subscription syntax for WebSocket or another transport. Confirm the actual device’s supported events and stream prerequisites. A translated expression is a configuration input, not proof of notification delivery, event continuity or a complete recording workflow.

Applicability questions

  • Which actual event declaration and topic should the consumer receive?
  • Which declaration prefixes need translation for the RTSP request?
  • What message fields should a separate content filter select?
  • Which harmless observed input can verify the intended notification?

DSE recommendation: controlled next steps

The following steps are DSE recommendations based on the cited source.

DSE recommends storing the device declaration, translated topic expression and optional content expression as separate reviewed fields.

  1. Retrieve the supported event declaration from an authorized pilot device and preserve the relevant topic and field names. Copy identifiers from that response rather than deriving them from a friendly event label. Write the RTSP topic expression beside the declaration and explicitly check each namespace prefix against the documented translation.
  2. Review any content filter independently from topic selection. Identify whether each named item belongs to the message source, key or data. Use a proposed harmless input with a known expected field value, and obtain a second reviewer’s reading of the complete expression before starting the subscription. Keep credentials out of stored request examples.
  3. Establish the approved stream through the supported client workflow and exercise only the permitted event input. Compare the received XML topic and relevant fields with the reviewed declaration and filters. If the notification is missing, retain the request and response evidence and investigate support, syntax and the input observation separately instead of broadening every filter at once.

Verification and evidence

Retain the declaration, translated topic filter, optional content filter and sanitized stream result with the observed input time. Have another reviewer match the received event to its intended source and value. Keep a working video picture separate from confirmation of the event stream.

For a proposed desk exercise, deliberately leave declaration-style prefixes in a subscription expression and ask the reviewer to correct the mapping before any live request. Also review a content expression that selects the wrong field. These are labeled test fixtures, not observed faults. No RTSP subscription or notification-delivery test has been performed for this article.

Official references

Source review completed October 29, 2026. Recheck the official documentation and the deployed device’s capabilities before changing production settings.

Primary reference

Review the official source

Axis Communications — Event data streaming · Verified October 29, 2026

Open official reference ↗
Plan the next step

Need help applying this guidance safely?

DSE can help confirm applicability, protect service continuity, and validate the result across physical security and IT systems.

Talk with DSE