AI Operations
Track token usage, cost, latency, and reliability across every Celiq AI surface from the ai_calls telemetry log.
ai_calls log.When to use it โ When you want to know what Celiq's AI is costing, which features burn the most tokens, which model is in use, and whether AI calls are succeeding.
Where to find it โ Context Studio โ Governance group โ AI Operations.
Who can use it โ Luminary (admin) only. The tab is hidden from other roles and the data endpoints reject non-Luminary requests.
Every time Orion answers a question, an AI Analyst runs, or any other AI feature fires, Celiq records one row in the ai_calls telemetry log โ its surface, provider, model, token counts, cost, latency, and whether it succeeded. The AI Operations tab reads that log and rolls it up into headline stats, a daily cost trend, per-surface and per-model breakdowns, and a filterable list of recent calls.
Because this view exposes spend and operational health across the whole workspace, it is restricted to Luminary admins.
Overview
AI Operations is a single dashboard scoped to a time window you choose: Last 7 days, Last 30 days, or Last 90 days (30 days by default). Changing the window reloads every panel.
The page is laid out top to bottom:
- Headline stats โ six cards summarizing the whole window.
- Daily cost trend โ one bar per day, colored by whether that day had errors.
- By surface โ each AI feature (surface) with its calls, tokens, latency, cost, and error count.
- By model โ each provider + model pairing with its calls and cost.
- Recent calls โ a paginated, filterable list of individual AI calls.
If no AI calls were recorded in the selected window, the page shows a short note instead: usage, cost, and latency appear once Orion answers a question or an AI feature runs.
When to use it
- Cost monitoring โ Check the Est. cost card and the daily cost trend to see what AI is costing this week, this month, or this quarter.
- Finding the expensive surface โ Use the By surface breakdown to see which feature drives the most spend or the most tokens.
- Confirming which model is live โ Use the By model breakdown to confirm the provider and model your workspace is actually calling.
- Reliability checks โ Watch the Success rate and Failures cards. A daily bar turning amber flags a day with errors; the By surface panel shows which feature failed.
- Debugging a specific failure โ Filter the Recent calls list to Error status to read the error message attached to each failed call.
Concepts
| Term | What it means |
|---|---|
ai_calls | The telemetry log table. One row per AI call your workspace made, written automatically whenever an AI feature runs. |
| Surface | The AI feature that made the call โ for example Orion, an AI Analyst, or another call-AI feature. Every call is tagged with its surface. |
| Provider / model | The AI vendor and the specific model used for the call (for example a Claude model from Anthropic). |
| Input / output tokens | Tokens sent to the model and tokens generated back. Total tokens is the sum. |
| Est. cost | The estimated USD cost of the call, derived from token usage. Summed across the window for totals. |
| Latency | How long the call took, in milliseconds. Headline and per-surface figures are averages. |
| Status | ok for a successful call, error for a failed one. Success rate is the share of ok calls; Failures is the count of error calls. |
| Window | The lookback period (7, 30, or 90 days) that scopes every panel on the page. |
Getting started
Prerequisites- You must be signed in as a Luminary (admin). The tab does not appear for Weaver, Tracer, or Lens roles, and the underlying data endpoints return an error for non-Luminary users.
- At least one AI call must have been recorded in your chosen window for the panels to show data.
- Open Context Studio.
- In the left navigation, find the Governance group.
- Click AI Operations.
Step-by-step
Open AI Operations
In Context Studio, go to the Governance group in the left navigation and click AI Operations.
Choose a time window
Use the dropdown at the top right of the page to pick Last 7 days, Last 30 days, or Last 90 days. The default is 30 days. Every panel reloads for the new window.
Read the headline stats
Scan the six cards: AI calls, Total tokens (with the in/out split shown underneath), Est. cost, Avg latency, Success rate, and Failures. If success rate drops below 90% it turns red, and the Failures card is highlighted when any call failed.
Review the daily cost trend
Each bar is one day's estimated cost. Bars are blue on clean days and amber on days that had at least one error. Hover a bar to see that day's date, cost, call count, and error count.
Break down by surface and model
In By surface, see which AI feature drove the most cost โ rows are sorted by cost, and any surface with failures shows an error count in red. In By model, confirm the provider and model in use and what each costs.
Inspect recent calls
Scroll to Recent calls for the individual call log. Use the All surfaces and All statuses dropdowns to filter, and the Prev / Next buttons to page through results (25 per page). A green dot marks a successful call; a red dot marks an error, with the error message shown inline.
Examples
Tracking down a spike in spend. A Luminary notices the monthly AI bill climbing. They open AI Operations, set the window to Last 30 days, and look at the daily cost trend โ costs jumped mid-month. In By surface they see one feature accounts for most of the cost, with high token volume. They switch to Recent calls, filter by that surface, and confirm the calls are large generations rather than failures. Diagnosing failures. The Success rate card reads 86% (shown in red) and Failures is highlighted with a non-zero count. The daily trend shows two amber bars. The Luminary opens Recent calls, sets the status filter to Error, and reads the error message printed next to each failed call to identify the cause.The panels read directly from the ai_calls telemetry log. Conceptually, the headline summary is the equivalent of:
SELECT
COUNT(*) AS calls,
SUM(input_tokens) AS input_tokens,
SUM(output_tokens) AS output_tokens,
SUM(total_tokens) AS total_tokens,
SUM(cost_usd) AS cost_usd,
ROUND(AVG(latency_ms)) AS avg_latency_ms,
COUNT(*) FILTER (WHERE status = 'ok') AS ok,
COUNT(*) FILTER (WHERE status = 'error') AS errors
FROM ai_calls
WHERE workspace_id = :workspace
AND created_at >= :window_start
AND created_at < :window_end;Success rate is then computed as ok / calls for the window. You never run this query yourself โ it backs the headline cards automatically.
Best practices
- Pick the window that matches your question. Use 7 days to spot a sudden change, 30 days for routine cost review, and 90 days for trend and budgeting.
- Read cost and reliability together. A cheap day with errors is not a healthy day โ check the Failures card and amber bars alongside cost.
- Start broad, then drill in. Use the headline stats and the by-surface breakdown to find what changed, then filter Recent calls to confirm the detail.
- Use the by-model panel after model changes. After updating your AI configuration, confirm here that calls are landing on the model you expect.
Tips
Hover any bar in the daily cost trend to see a tooltip with that day's exact date, cost, call count, and error count โ handy for pinpointing the day a spike or failure started before you dig into Recent calls.
Common mistakes
- Expecting other roles to see this tab. AI Operations is Luminary-only. Weaver, Tracer, and Lens users will not see it in the navigation, and direct requests to the data endpoints are rejected.
- Reading totals without the window in mind. Every number on the page is scoped to the selected window. A jump in cost may simply mean you switched from 7 to 90 days โ check the dropdown before drawing conclusions.
- Treating cost as exact. The cost figure is labeled Est. cost โ it is an estimate derived from token usage, not an invoice. Use Billing for actual charges.
- Ignoring the in/out token split. The Total tokens card shows input and output separately underneath. Output tokens usually cost more, so a high output share can explain cost that token totals alone do not.
Troubleshooting
| Symptom | Likely cause | Fix |
|---|---|---|
| The AI Operations tab is not in the navigation | You are not signed in as a Luminary | AI Operations is Luminary-only. Ask a Luminary to review it, or have your role elevated. |
| "No AI calls recorded in this window yet" | No AI calls landed in the selected window | Widen the window to 90 days, or wait until Orion or another AI feature runs โ calls appear once they are logged. |
| Page stays on "Loading AI operationsโฆ" | The summary request did not return | Reload the page and confirm you still have Luminary access; the panels load independently, so a single failed request can leave one empty. |
| "No calls match these filters." in Recent calls | The surface and/or status filters exclude everything | Reset the surface dropdown to All surfaces and the status dropdown to All statuses. |
| Success rate shown in red | Success rate has fallen below 90% for the window | Open Recent calls, filter status to Error, and read the inline error messages to find the cause. |
| A day's bar is amber | That day had at least one failed call | Hover the bar for the error count, then filter Recent calls to that period and to Error status. |