Get quick answers to the most common questions about Treblle.
How do I map my API credentials in Treblle?
Set your credentials using environment variables:
TREBLLE_PROJECT_ID=your_project_id
TREBLLE_API_KEY=your_api_key
Where to find these values:
- Go to your Treblle 3.0 workspace
- Navigate to API Settings
- Copy your Project ID and API Key
π Need help? Check our Getting Started Guide
My API requests aren't showing up. What should I check?
First, verify youβre using the correct platform:
Common troubleshooting steps:
- Check your credentials - Ensure
TREBLLE_PROJECT_ID
and TREBLLE_API_KEY
match your workspace
- Network settings - Allow HTTPS requests to
*.treblle.com
domains
- Request limits - Verify you havenβt exceeded your planβs monthly limit
- SDK integration - Confirm the Treblle SDK is properly installed and configured
Still not working? Contact support at treblle.com β Resources β Support

Can I test Treblle with localhost?
Yes! Treblle works with localhost if:
- β
SDK is properly initialized
- β
Your machine has internet access
- β
No proxy blocks traffic to Treblle endpoints
Quick test: Make a request to your local API and check your Treblle dashboard within a few seconds.
π Security & Privacy
How does Treblle protect my data?
Treblle prioritizes security with multiple layers of protection:
π Automatic Data Masking
- Passwords, API keys, and sensitive fields are automatically masked
- Data is masked before leaving your server
- You control which additional fields to mask
π‘οΈ Encryption & Compliance
- All data encrypted in transit and at rest
- ISO 27001, GDPR, SOC 2, CCPA, and PCI DSS compliant
- Regular security audits and assessments
π― What you can control:
- Exclude specific endpoints from logging
- Configure custom field masking
- Set up compliance scanning
π Learn more: Trust Center
How do I mask sensitive data in URLs?
Important: Treblle only masks request/response bodies and headers - not URL paths.
If your URLs contain sensitive data, you have two options:
Option 1: Exclude the endpoint
// Example: Skip Treblle for sensitive endpoints
if (req.path.includes('/sensitive-endpoint')) {
return next(); // Skip Treblle middleware
Option 2: Redesign the URL structure
/api/users/secret-key-123/profile
/api/users/profile?token=secret-key-123
# (token will be masked in query parameters)
π Full guide: Data Masking Documentation
Do I need to change DNS settings for Treblle?
No DNS changes required!
Treblle integrates directly into your API backend via our SDK. You keep using your custom domain exactly as before.
How it works:
- Your API runs on your domain (e.g.,
api.yourcompany.com
)
- Treblle SDK captures request/response data
- Data is sent to Treblleβs servers for analysis
- Your API continues working normally
π Documentation & Features
How does Treblle generate API documentation?
Treblle creates docs automatically from your API traffic:
π Real-time Analysis
- Analyzes incoming requests and responses
- Identifies patterns and data structures
- Generates OpenAPI specifications
π Continuous Updates
- Documentation updates as your API evolves
- New endpoints automatically discovered
- Response schemas updated based on actual data
π§ͺ Testing Integration
- Use Aspen to test endpoints
- Documentation appears immediately after API calls
- Interactive documentation with examples
π‘ Pro tip: Keep request/response formats consistent for better documentation quality.
π Learn more: API Documentation Guide
π§ Troubleshooting
I upgraded my SDK but still have issues with keys
Common issue with Treblle 3.0 upgrades:
β
Use environment variables (recommended):
TREBLLE_API_KEY=your_api_key
TREBLLE_PROJECT_ID=your_project_id
β Remove hardcoded credentials:
// Remove this old configuration
projectId: "hardcoded_id"
// SDK will automatically use environment variables
π Debugging steps:
- Check your
.env
file has correct values
- Restart your application after changes
- Verify youβre using the latest SDK version
- Check for typos in environment variable names
Getting SSL connection timeout errors?
SSL timeout errors usually indicate network issues:
π Network Troubleshooting:
- Check if your deployment environment can reach external services
- Verify no firewall rules block outbound HTTPS requests
- Test connection to
treblle.com
from your server
π§ Code Solutions:
// Add retry logic for network issues
const treblle = require('treblle');
// Configure with timeout settings
timeout: 10000, // 10 second timeout
retries: 3 // Retry failed requests
π Monitoring:
- Add detailed logging around SDK initialization
- Monitor SSL handshake timing
- Check server resource usage during requests
π³ Billing & Plans
How do I download my invoices?
Access your invoices through Workspace Settings:
π Step-by-step:
- Go to Workspace Settings β Billing
- Find the Invoice History section
- Click on any invoice to download PDF

π‘ Need help? Contact support with your account details:
What happens when I hit the free plan limit?
Free plan includes 250,000 requests per month.
π When you exceed the limit:
- βΉοΈ Treblle stops processing new requests
- π Your API continues working normally
- π Limit resets at the start of next month
π Solutions:
- Monitor usage: Check your dashboard regularly
- Upgrade plan: Consider higher tiers for more requests
- Optimize: Focus logging on critical endpoints only
π° View pricing: treblle.com/pricing
π Still Need Help?
Last updated: December 2024