Namespaces

Namespace navigation.png


Overview

A namespace is a container within a tenant used to organise and isolate system configuration in Cantara. Namespaces separate environments, such as development, testing, UAT, and production, ensuring configurations remain distinct and manageable.

Key Points

  • Each namespace has a unique name and belongs to a specific tenant.

  • Namespaces store configuration and log information; they do not store customer business data.

  • Each namespace is assigned to a hosting region. The region can influence performance, data residency, and where related services are hosted.

  • Queries, Functions, Reports, and Orchestrations are scoped to the namespace where they are created.

  • Each namespace has an agent signing key that securely links Cantara Cloud to the Cantara Agent.

Planning Your Environment Structure

Namespaces define configuration boundaries within a tenant:

  • Single namespace — One namespace handles all environments where configuration separation is not required.

  • Multi-namespace — Dedicated namespaces for each environment (such as Development, Testing, and Production) to ensure configuration changes remain isolated.

  • Agent sharing — Namespaces can share an agent, or use dedicated agents per namespace.