Observability

Trame provides comprehensive observability through real-time monitoring, detailed execution tracking, and intelligent analytics. Use these insights to debug failures, optimize performance, and maintain healthy automation.

Real-Time Execution Monitoring

Live Workflow Tracking

Monitor workflows as they execute with real-time updates:

Live Duration Counter: Watch execution time update in real-time for running workflows
Step-by-Step Progress: See each workflow step as it completes
Tool Execution Timeline: Track which integrations are being used and when
Status Indicators: Color-coded visual status for immediate health assessment

Execution Status Types

Comprehensive status tracking with detailed indicators:

Running: Active execution with real-time progress updates (blue indicators with animation)
Completed: Successful execution with outcome summary (blue indicators)
Completed with Objective Failure: Partial success requiring attention (amber indicators)
Failed: Technical failure needing investigation (red indicators)
Skipped: Validation prevented execution (gray indicators)
Waiting for Approval: Human review required before execution (pending indicators)

Run History and Analytics

The Runs view provides comprehensive execution tracking:

Execution List: Paginated list of all workflow runs with filtering capabilities
Run Details: Planned vs actual execution with detailed step logs
Duration Tracking: Complete timing information from trigger to completion
Tool Usage: Record of which integrations were used during execution
Input/Output Data: Complete capture of trigger data and execution results
Failure Analysis: AI-generated analysis for failed executions with improvement suggestions

Dashboard Analytics

Operational Metrics

The main dashboard provides key performance indicators with trend analysis:

Performance Statistics

Total Executions: Workflow runs in the last 30 days with percentage change
Success Rate: Completion ratio with trend indicators vs previous period
Average Processing Time: Mean execution time with performance trends
Active Workflows: Number of Live workflows out of total created

Trend Analysis

Each metric includes intelligent trend analysis:

30-Day Comparison: Performance vs previous 30-day period
Visual Indicators: Up/down trend arrows with color coding
Percentage Changes: Quantified improvement or decline metrics
Contextual Descriptions: Plain-language explanations of trends

Improvement Opportunities Dashboard

AI-powered optimization recommendations:

Workflows Needing Attention: List of workflows with pending improvement suggestions
Impact Assessment: Expected benefits of applying suggested improvements
Quick Actions: One-click application of recommended fixes
Success Tracking: Monitor effectiveness of applied improvements

Approval Workflow Observability

Approval Request Tracking

Complete visibility into human-in-the-loop processes:

Pending Approvals: Real-time list of workflows awaiting human review
Approval History: Complete record of approval decisions with timestamps
Response Times: Track how quickly approvals are processed
Rejection Analysis: Understand common rejection patterns for optimization

Approval Request Details

Each approval includes comprehensive context:

Planned Actions: Detailed list of steps the workflow intends to execute
Required Tools: Which integrations will be used during execution
Input Context: Trigger data or manual run parameters
Risk Assessment: Potential impact and safety considerations
Timeout Handling: Automatic expiration if approval isn’t provided

Comprehensive Audit Logging

Audit Event Types

Complete tracking of system and user activities:

Workflow Events: Creation, modification, deletion, execution, and status changes
Connector Events: Connection, disconnection, and error states
Trigger Events: Creation, modification, and deletion of automation triggers
User Events: Login, logout, organization join/leave activities
System Events: Technical errors and integration failures

Audit Log Details

Each audit entry includes comprehensive information:

Event Metadata: Timestamp, event type, affected entity, and organization context
User Context: Who performed the action (null for system events)
Request Details: IP address, user agent, session ID for user-initiated actions
Change Tracking: Before/after values for modifications
Additional Context: Event-specific metadata for detailed investigation

Audit Access and Export

Flexible audit log management:

Role-Based Access: Owner/Admin roles can view and export audit logs
Filtering Options: Filter by entity type, event type, user, or date range
Export Capabilities: Download audit logs for compliance reviews
Search Functionality: Find specific events or patterns in audit history
Real-Time Updates: Live audit feed for monitoring ongoing activities

Integration Health Monitoring

Connector Observability

Monitor integration health and performance:

Connection Status: Real-time health indicators for all connected systems
Performance Metrics: API response times and success rates
Error Tracking: Automatic detection and classification of integration issues
Usage Analytics: Most and least used integrations with optimization recommendations

System Status Dashboard

Organization-wide health overview:

Overall Health Percentage: Ratio of healthy vs total connectors
Recent Errors: Latest integration or system issues requiring attention
Performance Trends: Historical performance data and improvement tracking
Capacity Planning: Usage patterns and scaling recommendations

Advanced Troubleshooting and Optimization

Systematic Debugging Process

Follow this methodology for investigating issues:

Check Dashboard Metrics: Review success rate trends and failure patterns
Examine Recent Runs: Look at execution history for patterns or anomalies
Validate Connector Health: Ensure all required integrations are connected and healthy
Review Execution Details: Compare planned vs actual execution in run details
Analyze AI Suggestions: Review improvement recommendations for failed workflows
Check Audit Logs: Look for relevant system or user events that might explain issues

Common Issues and Solutions

Workflow Execution Failures

Missing Capabilities: Verify required connectors are connected on the Connectors page
Permission Issues: Check that OAuth permissions include required scopes
Data Problems: Review input data quality and format requirements
Timing Issues: Consider rate limits or system availability windows

Trigger Problems

Triggers Not Firing: Confirm workflow isn’t paused/draft and connector is healthy
Delayed Execution: Check for approval requirements or system load issues
Missing Events: Verify trigger configuration and webhook endpoints

Performance Issues

Slow Execution: Review tool usage patterns and API response times
High Failure Rates: Analyze failure types and apply AI-suggested improvements
Resource Constraints: Monitor dashboard metrics for capacity planning

Optimization Strategies

Use observability data to improve automation performance:

Pattern Recognition: Identify successful workflow configurations and replicate them
Performance Tuning: Optimize based on execution time and success rate trends
Preventive Maintenance: Address issues before they become critical based on trends
Capacity Management: Plan for growth based on usage patterns and performance data