From 0f1106c2e0b17bb3f8bb4af6b407914761757059 Mon Sep 17 00:00:00 2001 From: jordanc-relevanceai Date: Fri, 31 Jul 2026 16:54:52 +1000 Subject: [PATCH 1/2] docs: consolidate concurrency usage chart documentation Folds #710 and #725 into one change. Keeps #710's manager-gated toggle (correct) over #725's "always shows a breakdown by project", and keeps #725's queued band, tooltip and System Quotas link. Co-Authored-By: Claude Opus 5 (1M context) --- admin/subscriptions/plans.mdx | 6 +++++- enterprise/analytics.mdx | 28 +++++++++++++++++++++++++++- 2 files changed, 32 insertions(+), 2 deletions(-) diff --git a/admin/subscriptions/plans.mdx b/admin/subscriptions/plans.mdx index 203e56fe..5c641c0b 100644 --- a/admin/subscriptions/plans.mdx +++ b/admin/subscriptions/plans.mdx @@ -105,11 +105,15 @@ Concurrency is a system capacity metric — it measures how many tasks are runni For detailed information about concurrent task limits for each subscription tier, see the [System Quotas](/admin/system-limits#concurrent-tasks) page. -A time-series area chart displays your Organization's concurrency usage over time, helping you identify peak usage periods and determine when to upgrade for increased capacity. You can view this same chart in two places: +A stacked bar chart displays your Organization's concurrency usage over time, helping you identify peak usage periods and determine when to upgrade for increased capacity. Each bar is split into two bands: **Running** (purple) for tasks actively executing at that moment, and **Queued** (red) for tasks waiting on capacity because the concurrent task limit was reached. + +You can view this same chart in two places: - On the **Plan & Billing** page: click 'Settings' in the sidebar, then open Plan & Billing. - On the **Analytics** page, where the same chart shows organization-wide concurrency data, so you can correlate agent activity with overall concurrency patterns. +Organization managers also get an "Org total" / "By project" toggle in the chart header, which breaks concurrency down per project with a per-project tooltip. See [Analytics](/enterprise/analytics#per-project-breakdown) for details. + ## Credit allocation and reset For paid plans, Vendor Credits and Actions will be topped up at your next renewal date. diff --git a/enterprise/analytics.mdx b/enterprise/analytics.mdx index c89cd533..3316b895 100644 --- a/enterprise/analytics.mdx +++ b/enterprise/analytics.mdx @@ -129,7 +129,33 @@ Each metric shows percentage change from the previous period. For example, "+45. ## Concurrency usage -The Analytics page includes a concurrency usage chart. The chart shows organization-wide concurrency data — not data specific to a single agent — so you can correlate agent activity with overall concurrency patterns and see which agents are most active during peak periods. +The Analytics page includes a concurrency usage chart — a stacked bar chart showing how many tasks were running and queued across your organization over time. The chart shows organization-wide concurrency data, not data specific to a single agent, so you can correlate agent activity with overall concurrency patterns and spot peak usage periods. + +Each bar represents a point in time and is split into two bands: + +- **Running (purple):** tasks that were actively executing at that moment. +- **Queued (red):** tasks waiting for capacity because your organization had reached its concurrent task limit. The queued band stacks on top of the running band, so the full bar height represents the combined load. + +Queued tasks only appear once your organization hits its concurrent task limit. If you regularly see a red queued band, your current plan's concurrency limit is likely a bottleneck — see [System Quotas](/admin/system-limits#concurrent-tasks) for per-tier limits. + +### Per-project breakdown + +Organization managers can switch between two views using the toggle in the chart header: + + + + Displays aggregate organization-wide concurrency as a single set of bands. Use this to see overall demand patterns and correlate concurrency with agent activity. + + + Breaks the bars down by project, with each project in a distinct colour and its own running and queued bands. + + + +In the **By project** view, hovering over any bar opens a tooltip with **Running** and **Queued** columns, one row per project, and a **Total** row at the bottom — so you can identify which projects contribute most to concurrency load at any given time, alongside the organization's concurrency limit. + + + The "Org total" / "By project" toggle is only available to organization managers. Other members see the organization total. + For information about concurrency limits by subscription tier and how to monitor usage from the Plan & Billing page, see [Plans and credits](/admin/subscriptions/plans#monitoring-concurrency-usage). From 5d16a6b931189cde573c7d71afabd9ab463979d3 Mon Sep 17 00:00:00 2001 From: jordanc-relevanceai Date: Wed, 5 Aug 2026 14:46:43 +1000 Subject: [PATCH 2/2] docs: per-project concurrency breakdown is not org-manager only The endpoint redacts other projects for non-org-admin callers precisely so project admins can request it too (useConcurrencyTimeSeries.ts). Also fixes 'colour' to American spelling per repo standards. Co-Authored-By: Claude Opus 5 (1M context) --- admin/subscriptions/plans.mdx | 2 +- enterprise/analytics.mdx | 6 +++--- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/admin/subscriptions/plans.mdx b/admin/subscriptions/plans.mdx index 5c641c0b..23e58202 100644 --- a/admin/subscriptions/plans.mdx +++ b/admin/subscriptions/plans.mdx @@ -112,7 +112,7 @@ You can view this same chart in two places: - On the **Plan & Billing** page: click 'Settings' in the sidebar, then open Plan & Billing. - On the **Analytics** page, where the same chart shows organization-wide concurrency data, so you can correlate agent activity with overall concurrency patterns. -Organization managers also get an "Org total" / "By project" toggle in the chart header, which breaks concurrency down per project with a per-project tooltip. See [Analytics](/enterprise/analytics#per-project-breakdown) for details. +An "Org total" / "By project" toggle in the chart header breaks concurrency down per project, with a per-project tooltip. Organization managers see every project by name; project admins see the same breakdown with other projects anonymized. See [Analytics](/enterprise/analytics#per-project-breakdown) for details. ## Credit allocation and reset diff --git a/enterprise/analytics.mdx b/enterprise/analytics.mdx index 3316b895..2f0f6bbe 100644 --- a/enterprise/analytics.mdx +++ b/enterprise/analytics.mdx @@ -140,21 +140,21 @@ Queued tasks only appear once your organization hits its concurrent task limit. ### Per-project breakdown -Organization managers can switch between two views using the toggle in the chart header: +Use the toggle in the chart header to switch between two views: Displays aggregate organization-wide concurrency as a single set of bands. Use this to see overall demand patterns and correlate concurrency with agent activity. - Breaks the bars down by project, with each project in a distinct colour and its own running and queued bands. + Breaks the bars down by project, with each project in a distinct color and its own running and queued bands. In the **By project** view, hovering over any bar opens a tooltip with **Running** and **Queued** columns, one row per project, and a **Total** row at the bottom — so you can identify which projects contribute most to concurrency load at any given time, alongside the organization's concurrency limit. - The "Org total" / "By project" toggle is only available to organization managers. Other members see the organization total. + Organization managers see every project by name. Project admins get the same breakdown, but projects other than their own are anonymized.