Debugging and Troubleshooting
This guide covers debugging techniques and troubleshooting common issues when integrating LangWatch with TypeScript applications.Console Tracing and Logging
Enable console output and detailed logging for development and troubleshooting.Custom Logger
Create a custom logger for better integration with your existing logging system:Error Handling
Configure error handling behavior for different environments:Common Issues
Spans Not Appearing in Dashboard
- Check API Key: Ensure your
LANGWATCH_API_KEY
is correctly set - Verify Endpoint: Confirm the
LANGWATCH_ENDPOINT
is accessible - Check Network: Ensure your application can reach the LangWatch API
- Processor Type: Use
'simple'
processor for immediate export during debugging
Performance Issues
- Batch Processing: Use
'batch'
processor for production to reduce API calls - Sampling: Implement sampling for high-volume applications
- Data Capture: Limit data capture to essential information
Integration Issues
- Framework Compatibility: Ensure you’re using the correct integration for your framework
- Version Compatibility: Check that your LangWatch SDK version is compatible with your framework
- Configuration: Verify that all required configuration options are set
Environment-Specific Debugging
Development Environment
Production Environment
Getting Help
If you’re still experiencing issues:- Check Logs: Review console output and application logs
- Verify Configuration: Double-check all configuration options
- Test Connectivity: Ensure your application can reach LangWatch services
- Community Support: Visit our Discord community for help
- GitHub Issues: Report bugs and feature requests on GitHub
Related Documentation
For more debugging techniques and advanced troubleshooting:- Integration Guide - Basic setup and common issues
- API Reference - Configuration options and error handling
- Manual Instrumentation - Debugging manual span management
- Framework Integrations - Framework-specific debugging guides
- OpenTelemetry Migration - Troubleshooting migration issues
For complex debugging scenarios, combine console tracing with Manual Instrumentation techniques for detailed span analysis.