Documentation Index
Fetch the complete documentation index at: https://docs.heylua.ai/llms.txt
Use this file to discover all available pages before exploring further.
Overview
Thelua logs command provides an interactive interface for viewing and navigating your agent’s execution logs with powerful filtering capabilities.
Non-Interactive Mode
| Option | Description |
|---|---|
--type <type> | Filter: all, skill, job, webhook, preprocessor, postprocessor, device, device-trigger, user_message, agent_response, agent_error, mcp, rag, runtime |
--name <name> | Entity name (requires —type, not for message types) |
--limit <n> | Number of logs (default: 20) |
--page <n> | Page number for pagination |
--json | Output as JSON for scripting |
New in v3.13.0:
--type rag for knowledge base search logs, --type device-trigger for device trigger execution logs, and --type runtime for platform runtime logs (replaces the deprecated --type mastra).Filter by Type
Filter logs by Skills, Jobs, Webhooks, Preprocessors, or Postprocessors
See All Your Components
View logs for all your components, including dynamically created jobs
Detailed Information
See which component generated each log, including names and IDs
Color-Coded
Easily spot errors, warnings, and different log types
Log Types
- ❌ Error
- ⚠️ Warn
- 🔍 Debug
- ℹ️ Info
- ▶️ Start/✅ Complete
Execution errors and failures
- Tool execution failures
- API errors
- Invalid configurations
- Stack traces for debugging
Interactive Flow
Select Specific Component (if filtering)
All Jobs Visible: All your jobs appear in the list, including ones created dynamically in your code.
Use Cases
Debug Tool Errors
Monitor Performance
Verify Tool Execution
Track Webhook Activity
Monitor Job Execution
Example Session
Filtering by Skill
Log Entry Details
Each log entry shows you:For Skill Logs
- Skill Name - Which skill generated the log
- Skill ID - Unique identifier for the skill
- Tool Name - Which tool was running (if applicable)
- Timestamp - When the log was created
- Log Type - Error, debug, info, warn, start, or complete
- Message - The actual log message
- Duration - How long the operation took (for completed operations)
For Job Logs
- Job Name - Which job generated the log
- Job ID - Unique identifier for the job
- Timestamp - When the log was created
- Log Type - Error, debug, info, warn, start, or complete
- Message - The actual log message
- Duration - How long the job took to run
For Webhook, Preprocessor, and Postprocessor Logs
- Name - Which component generated the log
- ID - Unique identifier
- Timestamp - When the log was created
- Log Type - Error, debug, info, warn, start, or complete
- Message - The actual log message
- Duration - How long the operation took
Tool Information: Tool names are only shown for skill logs, since tools belong to skills.
Navigation Options
- Next Page →
- ← Previous Page
- 🔢 Go to specific page
- 🔄 Refresh
- ❌ Exit
View the next page of logsDisabled if on last page
Best Practices
Start with All Logs
Start with All Logs
Monitor After Deployment
Monitor After Deployment
Debug Specific Issues
Debug Specific Issues
Track Performance
Track Performance
Troubleshooting
No logs available
No logs available
Causes:
- Skills not deployed yet
- Agent hasn’t been used
- Viewing wrong agent
Can't find specific error
Can't find specific error
Try:
- Navigate through pages using the navigation menu
- Filter by the specific component (skill, job, etc.)
- Check the most recent pages first (page 1)
- Look at the timestamp to find when the error occurred
Logs not updating
Logs not updating
Use refresh:Reloads current page with latest data
Integration with Workflow
During Development
After Deployment
Debugging Issues
Related Commands
lua chat
Test agent (generates logs)
lua test
Test tools locally (no remote logs)
lua push
Deploy skills (required for logs)
lua production
View production environment
Next Steps
Test Your Agent
Generate logs to view
Deploy Skills
Push skills to generate logs
Troubleshooting
Common issues and solutions
Production Monitoring
Monitor production environment

