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 is assigned an agent pool. The agent pool must be in the same region as the namespace.
-
Each namespace has namespace API keys, which applications use when calling services in that namespace.
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 pool sharing — Multiple namespaces can use the same agent pool.
.png?cb=542d04510ecc98bf3ad394e877e785fd)