Unified Namespace (UNS)
Browse and monitor tag paths as a single source of operational truth.
The Unified Namespace (UNS) in DataHub is the live tree of all tag paths across your plants. It provides a single, semantic view of operational data — dashboards, rules, and programs all reference the same tag paths.
How tag paths work
Every tag has a path derived from the ISA-95 hierarchy:
plantCode/machineCode/deviceCode/tagCodeWhen telemetry arrives, the event carries all hierarchy codes so consumers can route and display data without database lookups.
UNS Explorer
Open UNS Explorer (/uns) in the console to:
- Browse the full tag tree by plant
- See live values with quality indicators
- View history for individual tags
- Filter by plant or search by path
Quality values include: GOOD, BAD, UNCERTAIN, TIMEOUT, DISCONNECTED, CONFIG_ERROR.
Only active tags appear in live UNS views and receive Redis updates. Deactivated tags remain in the hierarchy for administrators but are skipped by the telemetry pipeline.
Designing topic structures
Follow these conventions when modeling tags:
| Pattern | Example | Use for |
|---|---|---|
| Dot-separated metrics | motor.current, motor.speed | Related signals on one asset |
| State vs measurement | status.running, output.count | Discrete vs analog values |
| Consistent prefixes | line01.*, line02.* | Multi-line plants |
Path-based permissions
Users can be scoped with a UNS path filter that limits which tag paths they can see. Combined with plant scope, this supports multi-site deployments where operators only access their area.