Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.xpander.ai/llms.txt

Use this file to discover all available pages before exploring further.

The Metrics tab surfaces patterns you’d miss looking at individual threads: request spikes, token cost trends, and unexpected API call volume. Start here to spot anomalies, then switch to Threads to investigate the cause.

Available charts

Requests and API calls metrics
ChartWhat it tracksWhat to look for
RequestsAgent/workflow runs per daySudden spikes (possible loop or misconfigured trigger), unexpected drops (broken webhook or expired schedule)
Outbound API calls by AIExternal API calls made by AI nodes per dayRatio to requests. If API calls per request spike, an agent node may be looping or retrying excessively.
Input tokens by dayTokens sent to LLMsSteady growth means context is accumulating. Check if memory or conversation history is bloating prompts.
Output tokens by dayTokens generated by LLMsSpikes may indicate the model is generating verbose responses. Tighten instructions or add output format constraints.
Total tokens by dayCombined input + outputOverall LLM spend trend. Compare before and after model tier changes to confirm savings.
Token usage metrics

Reading the charts

Each chart shows:
  • Total count in the header (e.g., “Requests: 11”)
  • Purple bar chart with dates on the X axis
  • Date range picker (calendar icon) in the top right to filter the period
The date range defaults to the current month. Switch to a wider range to see trends, or narrow to a specific day to investigate a spike.

Investigate a spike

When a chart shows an unexpected jump:
  1. Note the date of the spike in the relevant chart
  2. Switch to Threads and look for threads created on that date
  3. Check whether the spike is concentrated on one trigger type or spread across sources
  4. If the API calls chart also spiked, check whether an agent node called the same tool repeatedly (possible loop or retry issue)
  5. If only input tokens spiked, check whether conversation history or memory is accumulating without bounds

Cost optimization

The token charts are the most actionable for cost control:
  • High input tokens relative to output may mean you’re sending too much context. Consider adding a Summarizer node before expensive Agent nodes to compress the input.
  • If a particular day shows a token spike, cross-reference with the Threads tab to find which execution consumed the most.
  • Compare token usage before and after switching a node to a cheaper model tier (T2 or T3) to confirm the savings. Use the tier guidance to decide which nodes can safely move down without affecting output quality.

What’s next

Threads

Trace the full execution log to find where a run went wrong.

Task Monitoring

Scan executions by status and triage failures across agents.