Skip to content

Frequently Asked Questions

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:

Terminal window
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:

  1. Check your credentials - Ensure TREBLLE_PROJECT_ID and TREBLLE_API_KEY match your workspace
  2. Network settings - Allow HTTPS requests to *.treblle.com domains
  3. Request limits - Verify you haven’t exceeded your plan’s monthly limit
  4. SDK integration - Confirm the Treblle SDK is properly installed and configured

Still not working? Contact support at treblle.com β†’ Resources β†’ Support

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

Terminal window
# Instead of:
/api/users/secret-key-123/profile
# Use:
/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):

Terminal window
# In your .env file
TREBLLE_API_KEY=your_api_key
TREBLLE_PROJECT_ID=your_project_id

❌ Remove hardcoded credentials:

// Remove this old configuration
treblle({
apiKey: "hardcoded_key",
projectId: "hardcoded_id"
})
// SDK will automatically use environment variables
treblle()

πŸ” Debugging steps:

  1. Check your .env file has correct values
  2. Restart your application after changes
  3. Verify you’re using the latest SDK version
  4. 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
treblle({
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:

  1. Go to Workspace Settings β†’ Billing
  2. Find the Invoice History section
  3. Click on any invoice to download PDF
Invoice History

πŸ’‘ 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?

πŸ“– Documentation

Browse our comprehensive guides and tutorials

docs.treblle.com

πŸ“§ Direct Support

Get help directly from our support team via email

[support@treblle.com]


Last updated: December 2024