Namespaces

A namespace is a named collection that scopes a set of related counters. It works like a folder: every counter belongs to exactly one namespace and is addressed as namespace/key. Grouping counters into namespaces keeps large numbers of tallies organized — for example a blog namespace for content metrics and an analytics namespace for traffic counters.

Open List Namespaces from the sidebar to manage them.

Creating a namespace

Select Create Namespace (top-right of the list, or the empty-state button on a fresh install). The form has three parts:

Field	Rules
Namespace Name	Required. 2–50 characters, letters, numbers, hyphens, and underscores only. Examples: blog, analytics, user-metrics.
Description	Optional. Free text up to 200 characters.
Labels	Optional tags. Type a label and press Enter or select Add; each appears as a removable chip. Examples: production, backend, critical, monitoring.

Select Create Namespace to save. You'll be returned to the list with your new namespace in place.

📷 Screenshot: The Create Namespace form — name, description, and labels fields.

Browsing, searching & filtering

The Namespaces list opens with a row of summary widgets (Total Namespaces, Total Counters, Recently Updated, and a Counters Distribution chart — see Dashboards & Analytics), followed by the namespace table.

• Search — the "Search namespaces…" box matches on name and updates a "X of Y namespaces" count as you type.
• Filter by Labels — a multi-select that appears once any namespace has labels. Choose All Labels to reset, or select specific labels to narrow the list. See Labels & Trackers.
• Sort — click the Namespace, Created, or Updated column headers to sort ascending or descending.

Each row shows the namespace name, its labels (up to two chips, then a +N chip whose tooltip lists the rest), created and updated timestamps, and a View action.

Namespace detail

Open a namespace to see everything inside it:

• Dates — when it was created and last updated.
• Description — the text you entered, or "No description provided".
• Labels — the assigned labels, with a pencil icon to add or remove them inline.
• Counter Activity (last 7 days) — a time-series chart aggregating all counters in the namespace over the most recent week. The bucket size is chosen automatically for the range (see Configuration for downsampling settings).
• Statistics — three tiles: Total Counters, Total Count (the sum of every counter's value), and Average Count.
• Counter Distribution — an animated bar per counter showing its share of the total.
• Counters — every counter in the namespace as a clickable row, with an Add Counter button, plus view and delete actions per counter.

📷 Screenshot: A namespace detail page showing the activity chart, statistics tiles, and the list of counters.

Deleting a namespace

Select Delete Namespace on the detail page. A confirmation dialog warns:

Are you sure you want to delete the namespace? This action cannot be undone and will delete all counters in this namespace.

Choose Yes, Delete to remove the namespace and every counter it contains, or No, Cancel to keep it.