Overview

The Activity tab in your dashboard shows analytics for your agent - total chats, messages, tokens, and daily activity graphs.

This is dashboard-only - no code required. Just view stats in the UI.

What You See

Overview Stats

When you open the Activity tab, you see:

• Total Chats - Unique sessions with this agent
• Total Messages - All messages sent/received
• Total Tokens - Combined input + output + reasoning tokens
• Total Apps - Docker containers using this agent

Daily Activity Graphs

Visual charts showing:

• Chats per day
• Messages per day
• Usage trends over time

Choose timeframe:

• Last 7 days (default)
• Last 30 days
• Last 90 days
• Custom (up to 365 days)

How to Access

1. Go to dashboard.oblien.com
2. Select your agent
3. Click Activity tab
4. View your analytics

No code needed - all data is tracked automatically.

What's Tracked

Every time someone uses your agent, we automatically track:

Per Session:

• Session ID and timestamp
• User ID (namespace) or guest ID
• All messages exchanged
• Token usage (input + output + reasoning)
• Session duration

Aggregated:

• Total chats (unique sessions)
• Total messages across all sessions
• Total tokens consumed
• Daily activity breakdown
• Apps using this agent

No tracking code required - it's all handled by the platform when you use Core SDK to create sessions.

Session History

View Chat History

You can view individual chat sessions:

1. Go to Activity tab
2. Find the session in the list
3. Click to view full conversation

This shows:

• All messages in the session
• User input and agent responses
• Timestamps for each message
• Token usage per message

Use for debugging - see what users asked and how your agent responded.

API Access (Optional)

If you want to fetch analytics programmatically (advanced):

// Dashboard internal API (requires authentication)
GET /ai/agents/:id/overview?days=7

// Response
{
  "success": true,
  "analytics": {
    "total_chats": 1847,
    "total_messages": 12453,
    "total_tokens": 3847291,
    "total_apps": 5,
    "usage_data": [
      {
        "date": "2024-11-15",
        "chats": 145,
        "messages": 980
      }
      // ... more daily data
    ]
  }
}

Note: This is an internal dashboard API, not part of the public SDK. Most users just use the dashboard UI.

Use Cases

Monitor Performance

Check if your agent is being used:

• Are users engaging?
• How many messages per session?
• Is usage growing over time?

Track Costs

Monitor token consumption:

• Total tokens used
• Daily token trends
• Plan for scaling and costs

Debug Issues

View session history to:

• See what users actually asked
• Review how agent responded
• Identify problem conversations
• Improve prompts and tools

Important Notes

This is NOT

The Activity tab is dashboard analytics only. It is NOT:

• ❌ useStatusSubscription - That's for real-time UI loading states in Chat SDK (see docs)
• ❌ Real-time streaming - That's for frontend status monitoring
• ❌ Custom tracking - All tracking is automatic

Read-Only

You cannot:

• Edit or delete chat history
• Export data (coming soon)
• Set up alerts (coming soon)
• Stream events in real-time

It's purely for viewing analytics after the fact.

Privacy

• User IDs are shown (namespace you provided)
• Guest IDs are hashed
• IP addresses are masked
• All data complies with privacy standards

Related Topics

For real-time UI status updates:
Chat SDK - Status Events - Use useStatusSubscription for showing loading states in your UI

For creating tracked sessions:
Core SDK - Sessions - Create sessions that generate activity data

For agent configuration:
Creating Agents - Set up your agent

Summary

Activity = Dashboard Analytics Tab

• View usage stats (chats, messages, tokens)
• See daily activity graphs
• Access chat history for debugging
• All tracked automatically

Just open your dashboard and click the Activity tab.