Skip to content

Gen3 Observability

GT AI OS Release edited this page Jun 17, 2026 · 5 revisions

Observability

Start Here

  1. Open Management → Observability from the tenant sidebar (all signed-in tenant roles can reach this route).
  2. Select the analytics tab available to your role (see the table below).
  3. Apply filters before exporting or sharing summaries.

Why this matters

Observability gives every tenant role evidence about usage and activity within their allowed scope. Tenant owners and managers use it for capacity and governance decisions; tenant users use it to review their own work without needing elevated administration access.

Details

The tenant Observability route is the active Gen 3 analytics workspace at Management → Observability. All signed-in roles can open it from the sidebar, but tabs, filters, and data scope depend on your tenant role, whether GT API is enabled for your account, and whether the deployment has an enterprise license (for the Billing tab).

Tabs by role

Tab Tenant Owner Tenant Manager Tenant User
Usage Overview Yes Yes Yes
Conversations Yes Yes Yes
Storage Yes Yes Yes
Contextual Memory Yes Yes No
Access Logs Yes No Yes
GT API Yes (when GT API enabled) Yes (when GT API enabled) Yes (when GT API enabled)
Billing Yes (when enterprise licensed) No No
GT Helper Yes Yes Yes

The GT API tab appears only when your account has GT API enabled (gtApiEnabled). The Billing tab appears only for tenant owners when the deployment reports an active enterprise license (enterpriseLicensed). Managers never see Access Logs or Billing regardless of GT API or license status. GT Helper is visible for every signed-in tenant role and does not depend on GT API enablement.

Observability GT Helper tab with Usage and Threads sub-tabs

Observability Contextual Memory tab with pipeline status and usage

Scope is role-aware

Gen 3 computes observability scope from your role and, for some managers, managed-group assignments.

  • Tenant Owner: tenant-wide visibility across all users and resources.
  • Tenant Manager with managed groups: review activity through managed-group filters; may filter by user within that scope.
  • Tenant Manager without managed groups: limited to your own activity and resources.
  • Tenant User: limited to your own activity and resources.

If another user can see a wider scope or more tabs than you can, that is expected behavior rather than missing data.

Main filters

The page can expose:

  • time range
  • user filter (owners; managers with managed-group scope)
  • managed-group filter (managers with managed groups)
  • agent filter
  • search within conversation analytics

The available filters change with your effective scope. The GT Helper and Contextual Memory tabs honor the same time range, managed-group, and user filters as the other analytics tabs.

Contextual Memory

The Contextual Memory tab reports indexing, embedding, and summary pipeline activity for the platform memory layer configured by Control Panel Super Admins. It is available to tenant owners and tenant managers only.

Use this tab to monitor memory job health, embedding and summary throughput, and usage within your observability scope. Super Admins configure the platform layer from Control Panel Contextual Memory; configure per-agent defaults on Building Agents.

GT Helper

The GT Helper tab reports activity from the tenant app ? help shelf only—the wiki-grounded instructions helper opened from the fixed ? bubble on the tenant shell. It does not include Control Panel GT Helper traffic from the Control Panel instructions help shelf.

Helper inference and embedding burn is tagged with requestMode=instructions_helper. Use this tab when you need analytics on GT Helper chat threads, not when you are reviewing favorited chat agents or GT Chat conversations.

The tab has two sub-tabs: Usage and Threads.

Usage

The Usage sub-tab summarizes helper activity for your current scope and time range.

  • Summary cards — threads, users, messages, inference tokens, embedding tokens, and (when billing data is present) settled billing chat and total tokens.
  • Token time series — daily inference vs embedding token burn for helper traffic.
  • Top topics — wiki slugs and page paths cited across helper turns (topic label, slug, page path, and mention count).
  • Top users — helper activity by signed-in tenant user (threads, messages, inference tokens). Shown only when your role can filter observability by user (tenant owners, and tenant managers with managed-group scope). Each row can set the top-bar User filter to that person.
  • Settled billing — when the deployment exposes helper billing analytics, a breakdown of settled helper spend tagged with requestMode=instructions_helper: request counts, chat tokens, embedding tokens, and total tokens.

Threads

The Threads sub-tab lists helper conversation threads for your current filters.

  • Search — filter the thread list by text; press Enter or leave the field to apply.
  • Paginated table — columns for thread title, owner (when your role sees an owner column), message count, last page, updated, and created. Use Previous / Next to page through results.
  • Expand a row — loads the full helper transcript. Each message shows role, timestamp, and body text. Expanded messages can include metadata such as page path, model name, token counts (prompt, completion, embedding), and a Source articles list of wiki slugs cited for that turn.

Scope and user filter

GT Helper uses the same observability scope as the other tabs:

  • Tenant Owner — tenant-wide helper activity; User filter and Top users drill-down apply.
  • Tenant Manager with managed groups — helper activity within the selected managed group; may filter by user within that scope.
  • Tenant Manager without managed groups and Tenant User — only your own helper threads and usage.

Changing the top-bar User dropdown (when available) or clicking a name under Top users refreshes both Usage and Threads for that filter. The time range selector applies to helper analytics as well.

Role-specific use

  • Use the Tenant Manager Guide when you need help deciding whether an investigation is within manager authority.
  • Use the Tenant Owner Guide when the incident requires unrestricted tenant-wide evidence or follow-up governance changes.

Common tasks

Review usage trends

Start with Usage Overview when you need a quick answer about current activity or whether a team, user, or managed group is consuming more resources than expected.

Investigate a conversation pattern

Open the Conversations tab when you want analytical review rather than the full transcript workflow on Conversations. This tab is designed for trend analysis and export, not for continuing a live thread.

Review storage posture

Use the Storage tab to understand how much content is being retained and where retrieval-heavy footprint is accumulating.

Review access events

Use Access Logs for sign-in and activity-event review when your role includes that tab (owners and tenant users). This is especially useful when diagnosing login issues or confirming whether access actually happened during a reported incident window.

Review billing analytics

Use Billing when you are a tenant owner, the deployment has an enterprise license, and billing analytics are exposed. This view is analytic, not a configuration surface; Control Panel operators still own pricing and billing policy in the Control Panel Financial Controls pages.

The Financial attribution section includes a searchable, paginated Top users by inference spend chart with display names and emails. Use Search users and Page size above the chart; click a bar to apply the User filter when available.

Review GT API usage

Use the GT API tab when GT API is enabled for your account and you need integration traffic alongside chat and storage analytics.

Review instructions helper usage

Open GT Helper when you need evidence about ? shelf chat traffic: token burn, cited wiki topics, per-user activity (when your role allows), settled helper billing, or full helper transcripts. This is separate from Conversations (favorited agent chat) and from Control Panel CTP Helper observability.

Review contextual memory pipeline

Open Contextual Memory when you are a tenant owner or manager and need evidence about memory indexing, embedding jobs, summary generation, or memory-related token burn within your scope.

Export behavior

Several observability tabs place Export actions in the top-right of the section header (not in the filter toolbar):

  • ConversationsExport Results for the filtered transcript set
  • Access LogsExport CSV / Export JSON
  • GT API — export controls on the tab header (requests sub-tab uses Export Results)
  • GT Helper — export on the Threads sub-tab header

Apply filters first, then export only the scope you need. Conversation analytics exports can include or omit message content via the export dialog.

Best practices

  • Start broad, then narrow with filters once you see the overall pattern.
  • Use observability for trend analysis and Conversations for thread-by-thread review.
  • Treat managed-group scope as an intentional governance boundary, not a data-quality issue.
  • Escalate to a tenant owner if you need tenant-wide visibility or the Billing tab for an investigation.

Related pages

Clone this wiki locally