> ## Documentation Index
> Fetch the complete documentation index at: https://docs.untrace.dev/llms.txt
> Use this file to discover all available pages before exploring further.
# Dashboard
> Monitor, route, and analyze your LLM traces in real-time with the Untrace dashboard
## Overview
The Untrace Dashboard provides a powerful web interface for monitoring your LLM traces, configuring routing rules, analyzing performance metrics, and managing your observability integrations. Access it at [https://untrace.dev/app](https://untrace.dev/app).
View LLM traces as they flow through your system
Set up intelligent routing rules for your traces
Analyze costs, performance, and usage patterns
Configure connections to observability platforms
## Getting Started
### Accessing the Dashboard
1. Navigate to [https://untrace.dev/app](https://untrace.dev/app)
2. Sign in with your Untrace account
3. You'll land on the overview page showing your LLM trace activity
### Dashboard Layout
The dashboard is organized into several key sections:
* **Navigation Sidebar**: Quick access to all dashboard features
* **Main Content Area**: Displays your selected view (traces, analytics, settings, etc.)
* **Activity Feed**: Real-time trace activity stream
* **Status Bar**: Connection status and platform health indicators
## Real-time Monitoring
### Live Trace Feed
Monitor LLM traces as they flow through Untrace:
View traces in a chronological list with key information:
* Timestamp
* Model (GPT-4, Claude, etc.)
* Provider (OpenAI, Anthropic, etc.)
* Token usage
* Cost
* Latency
* Routing destinations
* Status (success/error)
Click any trace to see detailed information:
* Full prompt and completion
* Token breakdown (prompt/completion)
* Cost calculation
* Latency metrics
* Routing decisions
* Platform responses
* Error details (if any)
### Filtering and Search
Filter the trace feed to focus on what matters:
```javascript theme={null}
// Example filters
{
model: "gpt-4",
provider: "openai",
status: "success",
costRange: { min: 0.01, max: 0.10 },
timeRange: "last-hour"
}
```
Available filter options:
* **Model**: Filter by specific models (GPT-4, Claude-3, etc.)
* **Provider**: OpenAI, Anthropic, Google, etc.
* **Status**: Success, Failed, Rate Limited
* **Cost Range**: Filter by token cost
* **Latency**: Response time thresholds
* **Destinations**: Filter by routing destinations
* **Time Range**: Last hour, 24 hours, 7 days, custom range
* **Tags**: Custom tags and metadata
## Routing Configuration
### Creating Routing Rules
Configure how traces are routed to different platforms:
Click **New Routing Rule** and configure:
* Rule name and description
* Matching conditions
* Destination platforms
* Priority order
Set up matching conditions:
* Model type (GPT-4, Claude, etc.)
* Cost thresholds
* Error conditions
* Custom metadata
* Environment tags
Choose where to send matching traces:
* Primary destination
* Fallback destinations
* Multi-destination routing
* Sampling rates
Test your routing rule:
* Send test traces
* Verify routing behavior
* Check destination delivery
### Routing Examples
Common routing patterns:
```yaml theme={null}
name: "Route GPT-4 to LangSmith"
conditions:
model: "gpt-4*"
destinations:
- platform: "langsmith"
sample_rate: 1.0
```
```yaml theme={null}
name: "High-cost trace analysis"
conditions:
cost: "> 0.10"
destinations:
- platform: "langfuse"
tags: ["high-cost", "analyze"]
```
```yaml theme={null}
name: "Failed request debugging"
conditions:
status: "error"
destinations:
- platform: "keywords-ai"
- platform: "custom-webhook"
url: "https://api.yourapp.com/errors"
```
```yaml theme={null}
name: "Platform comparison"
conditions:
model: "claude-3-opus"
destinations:
- platform: "langsmith"
sample_rate: 0.5
- platform: "langfuse"
sample_rate: 0.5
```
## Analytics
### Overview Metrics
View key metrics at a glance:
* **Total Traces**: Daily, weekly, monthly counts
* **Token Usage**: Total tokens processed
* **Total Cost**: Aggregate costs across all models
* **Average Latency**: P50, P95, P99 response times
* **Error Rate**: Failed requests and error types
* **Model Distribution**: Usage by model type
### Cost Analysis
Deep dive into your LLM costs:
* Cost breakdown by model
* Token usage per model
* Average cost per request
* Cost trends over time
* Provider cost comparison
* Usage distribution
* Rate limit utilization
* Provider reliability metrics
* Cost per application/service
* Department allocation
* Project-based tracking
* Budget monitoring
### Performance Metrics
Monitor LLM performance:
* **Latency Distribution**: Response time histograms
* **Token/Second**: Throughput metrics
* **Queue Depth**: Pending requests
* **Error Analysis**: Error types and frequencies
* **Rate Limit Tracking**: Provider limit utilization
### Custom Reports
Generate custom analytics reports:
1. Select metrics to include
2. Choose aggregation period
3. Apply filters
4. Export as CSV or PDF
5. Schedule automated reports
## Integrations
### Managing Platform Connections
Configure connections to observability platforms:
Click **New Integration** and select platform:
* LangSmith
* Langfuse
* Keywords.ai
* Helicone
* Custom webhook
Provide platform credentials:
* API keys
* OAuth tokens
* Webhook URLs
* Custom headers
Configure default settings:
* Default tags
* Metadata mapping
* Retry policies
* Timeout settings
Verify the integration:
* Send test trace
* Check delivery status
* Verify data format
### Platform-Specific Settings
Configure platform-specific features:
#### LangSmith
* Project mapping
* Environment tags
* Custom metadata fields
* Feedback integration
#### Langfuse
* Session tracking
* User identification
* Score mappings
* Public link generation
#### Keywords.ai
* Cost tracking settings
* Alert thresholds
* Custom dashboards
* API quota management
#### Custom Webhooks
* Payload transformation
* Authentication headers
* Retry configuration
* Response validation
## Team Management
### Access Control
Manage team access and permissions:
Role
View Traces
Configure Routing
Manage Integrations
Billing
Owner
✅
✅
✅
✅
Admin
✅
✅
✅
❌
Developer
✅
✅
❌
❌
Viewer
✅
❌
❌
❌
### API Keys
Manage API keys for different environments:
```bash theme={null}
# Production key with full access
UNTRACE_API_KEY=utr_prod_xxx
# Development key with limited access
UNTRACE_API_KEY=utr_dev_xxx
# CI/CD key for automated testing
UNTRACE_API_KEY=utr_ci_xxx
```
## Advanced Features
### Trace Sampling
Configure intelligent sampling to reduce costs:
```javascript theme={null}
// Sampling configuration
{
"default_sample_rate": 0.1, // 10% default
"rules": [
{
"condition": "model == 'gpt-4'",
"sample_rate": 0.05 // 5% for expensive models
},
{
"condition": "error == true",
"sample_rate": 1.0 // 100% for errors
},
{
"condition": "cost > 0.50",
"sample_rate": 1.0 // 100% for high-cost requests
}
]
}
```
### PII Detection
Configure privacy protection:
* **Automatic Detection**: Identify potential PII
* **Redaction Rules**: Define what to redact
* **Allowlist**: Specify safe patterns
* **Audit Trail**: Track redaction events
### Alerting
Set up alerts for important events:
* Daily spend thresholds
* Unusual cost spikes
* Budget warnings
* Model-specific limits
* High latency warnings
* Error rate thresholds
* Rate limit approaching
* Service degradation
* Webhook notifications
* Email alerts
* Slack integration
* PagerDuty integration
## Troubleshooting
### Common Issues
* Verify your API key is correct
* Check network connectivity
* Ensure proper SDK initialization
* Verify routing rules are active
* Check platform credentials
* Verify network access
* Review error logs
* Test with minimal payload
* Check routing rule complexity
* Review sampling configuration
* Monitor platform status
* Consider regional deployment
### Debug Mode
Enable debug mode for detailed diagnostics:
1. Go to **Settings** → **Advanced**
2. Toggle **Debug Mode**
3. View detailed trace logs
4. Export diagnostic bundle
## API Access
Access dashboard functionality programmatically:
```bash theme={null}
# Get trace history
curl -X GET https://untrace.dev/api/v1/traces \
-H "Authorization: Bearer YOUR_API_KEY"
# Get analytics data
curl -X GET https://untrace.dev/api/v1/analytics \
-H "Authorization: Bearer YOUR_API_KEY"
# Update routing rules
curl -X PUT https://untrace.dev/api/v1/routing/rules \
-H "Authorization: Bearer YOUR_API_KEY" \
-d @routing-rules.json
```
See the [API Reference](/api-reference/introduction) for complete documentation.
## Next Steps
Integrate Untrace SDK in your applications
Learn advanced routing strategies
Configure LLM provider connections
Explore the complete API documentation