Insights

Insights is currently in beta. The API surface and dashboard features may change as development continues.

Gram Insights provides observability for AI tool usage across deployments. Track tool calls, analyze chat sessions, and monitor performance metrics—all in one place.

Features

Logs - Search and explore tool call traces with OpenTelemetry-compatible log records
Metrics - View aggregated statistics like token usage, success rates, and popular tools

Accessing Insights

Insights is available in the Gram dashboard. Navigate to a project and select Logs or Metrics from the sidebar.

The Insights API endpoints are also available for programmatic access. All endpoints are part of the Gram OpenAPI specification at app.getgram.ai/openapi.yaml .

Authentication

Dashboard

API

API requests require authentication headers:

Header	Description
`Gram-Key`	API key with `Consumer` or `Producer` scope
`Gram-Project`	Project identifier (slug)


curl -X POST "https://app.getgram.ai/rpc/telemetry.searchLogs" \
  -H "Content-Type: application/json" \
  -H "Gram-Key: <your-api-key>" \
  -H "Gram-Project: <your-project-slug>" \
  -d '{"limit": 50}'

User-level filtering

Insights supports filtering data by user identity. Pass a user_id or external_user_id when making tool calls to enable per-user analytics.

This allows:

Filtering logs and chats by specific users
Viewing metrics aggregated per user
Debugging issues for individual users

See the Logs and Metrics documentation for filter parameter details.

Last updated on January 13, 2026