Frequently Asked Questions

How do I map my API credentials in Treblle?

You can set your credentials using environment variables. Assign your:

API ID to TREBLLE_PROJECT_ID

SDK Token to TREBLLE_API_KEY

Verify these values come from your current Treblle 3.0 workspace configuration.

Check How to get started.

My API requests aren’t showing up on the dashboard.

First, confirm that you are accessing platform.treblle.com instead of the legacy URL (app.treblle.com).

Verify that the environment variables TREBLLE_PROJECT_ID and TREBLLE_API_KEY match your current 3.0 workspace configuration.

Check that your outbound network/firewall settings permit HTTPS requests to all *.treblle.com endpoints.

Ensure your API traffic does not exceed your plan's monthly request cap.

If you still don't see API requests, contact Support by going to:
Treblle Website → Resources → Support

How does Treblle handle Security and Privacy ?

Treblle prioritizes Security and Privacy:

Sensitive fields such as passwords and API keys are automatically detected and masked.

All data is encrypted in transit and at rest.

You have full control over what data you log and can exclude specific fields in your SDK configuration.

Treblle offers compliance scanning to help detect vulnerabilities.

Treblle is committed to maintaining high-security standards and is ISO 27001, GDPR, AICPA SOC 2, CCPA READY, and PCI DSS COMPLIANT.

Our rigorous assessment process ensures that our infrastructure, sub-processors, third-party vendors, and employees adhere to strict security policies.

Learn more about How we handle Security.

How can I mask sensitive parts of my endpoints (like dynamic keys in URLs)?

Treblle only masks data in request/response bodies and headers, not the URL path. You have two options if your endpoint URL contains sensitive information (e.g., dynamic keys).

Exclude the endpoint entirely: Use your framework’s middleware or routing controls to bypass Treblle’s logging on that endpoint.

Redesign the URL: Consider restructuring your endpoint so that sensitive values aren’t part of the path if they don’t need to be visible.

Check how to Mask Fields in Treblle.

Example:

How does Treblle generate API docs?

Treblle automatically creates documentation from the API traffic.

When your API receives consistent requests to a new endpoint, Treblle analyzes the payloads and generates documentation based on that data.

If your documentation isn’t showing up, ensure you're tracking endpoints correctly and keeping request/response payloads in a consistent format.

For example, once a new endpoint is created and published, you can use Aspen to make an HTTP call and then see the API Docs on the Treblle Platform.

Check API documentation for more information.

I upgraded my SDK but still see issues with keys or request logging.

Double-check your configuration.

With Treblle 3.0, you can rely on environment variables instead of hardcoding keys in your integration code.

If your .env file already defines TREBLLE_API_KEY and TREBLLE_PROJECT_ID, remove manual configuration from your code.

This reduces the risk of mismatches between environments. Also, ensure you use the latest SDK version supporting Treblle 3.0 changes.

Do I need to change my DNS settings to work with Treblle?

No. Treblle integrates directly into your API backend via our SDK.

You continue using your custom domain as usual. Treblle monitors traffic by processing the data sent by your application, so no DNS changes are necessary.

I’m getting connection errors (e.g., SSL connection timeout) after deployment.

Connection errors like SSL timeouts often point to network-related issues.

Verify that your deployment environment can reach external services and that no firewall rules or proxy settings block outbound requests.

Consider adding retries or more detailed logging around your SDK calls to diagnose intermittent delays when establishing SSL connections with Treblle’s servers.

How do I access my invoices in Treblle 3.0?

You can download invoices through Workspace Settings → Billing.

On the Treblle billing page, find the Invoice History section and click on it to download your invoice.

If you still don't see your invoice, contact Support by going to:

Treblle Website → Resources → Support with your account details.

What happens if I exceed the monthly request limit on the free plan?

If your API reaches the free plan’s 250K monthly request limit, Treblle will stop processing new API calls until the limit resets.

Monitor your usage, and if you expect higher traffic, consider adjusting your plan to avoid missing out on logging essential requests.

Check Pricing Plans.

Can I test Treblle locally?

Yes. Requests from localhost are logged if:

The SDK is initialized correctly.

Your machine has internet access.

No proxy blocks traffic to Treblle’s endpoints.

If you have more questions, feel free to ask in our Discord Community – we’re happy to help!