Skip to main contentThis quickstart guide is for end users who want to start using Veratrace day-to-day. You’ll learn how to view work ledger entries, understand TWU models, and navigate the application.
Related: Source: Feature Inventory
Prerequisites
- Access to a Veratrace instance
- Valid AWS Cognito credentials
- Backend API running (your admin will provide the URL)
Source: Source: Feature Inventory
Step 1: Log In
- Navigate to your Veratrace instance URL
- You’ll be redirected to AWS Cognito for authentication
- Enter your credentials
- After successful login, you’ll be redirected back to Veratrace
UI Route: / (redirects to /dashboard)
Source: Source: Feature Inventory
Step 2: View Work Ledger
The work ledger shows all TWU executions and work operations in your instance.
- Click Ledger in the navigation sidebar
- View the list of work ledger entries
- Each entry shows:
- Title and description
- Execution status (completed, in_progress)
- Policy compliance status (compliant, non_compliant, review_required)
- Actor types (AI, HUMAN, or both)
- Cost and time metrics
- Related entity information
UI Route: /ledger
Source: Source: Feature Inventory
Step 3: Filter Work Ledger Entries
Source: Source: Feature Inventory
Step 4: View TWU Models
TWU models define the structure of work operations. View available models:
- Click TWU Models in the navigation sidebar
- Browse the list of published models
- Click a model to view its details (entities, actions, events, outcomes)
UI Route: /twu-models
Source: Source: Feature Inventory
Step 5: View Agents
See which agents (AI or human) are available in your instance:
- Click Agents in the navigation sidebar
- View the list of agents
- See agent type (AI/HUMAN), status (active/inactive), and capabilities
UI Route: /agents
Source: Source: Feature Inventory
Step 6: View Integrations
Check which external systems are connected:
- Click Integrations in the navigation sidebar
- View the list of integrations
- See integration status (active, inactive, connecting, error)
- Check health status for each integration
UI Route: /integrations
Source: Source: Feature Inventory
Daily Workflow
Your typical day-to-day usage:
- Morning: Check
/ledger for overnight work executions
- Review: Filter by policy status to find items needing review
- Monitor: Check
/integrations to ensure data sources are healthy
- Analyze: Use work ledger metrics (cost, time, actors) to understand work patterns
Source: Source: Feature Inventory
Next Steps