Frequently Asked Questions

Let us know if you have any more questions by chatting with us using the help widget at the Bottom Right.


How does Epsagon work?

Epsagon uses tracing to extract events from production code. After integrating Epsagon into your application, either automatically or manually, it will instrument the code every time it's loaded. While the code is running, events will be sent to Epsagon and analyzed in real-time to generate tracing maps, alerts, and insights.

What type of applications does Epsagon support?

Epsagon was built for modern cloud applications, meaning you can use any kind of workload. It operates only at the code-level, using a lightweight agent SDK. This allows it to run on containerized, serverless, or any other application.

Do I need to change my application to use Epsagon?

No. Epsagon supports integrations with a variety of common frameworks in multiple languages and will do all the instrumentation automatically for you. For example, auto-tracing will automatically pick up your AWS Lambda functions. No code changes required.


How can I invite team members?

Inviting team members is free at Epsagon. Head to your settings page and just invite them by typing their emails, separated by a comma.

How can I change the owner of my account?

To change the owner of your account, please contact us at How to Get Help.

Can I set up SSO (Single Sign-On)?

To set up SSO login for your account, please contact us at How to Get Help.

How can I add an email address for billing?

To set up an email for billing, please contact us at How to Get Help.

Security and Privacy

How does Epsagon handle sensitive user data?

You can fully control the data that is being sent to Epsagon. Read more at the Security and Privacy section.

How do I delete an Application from Epsagon?

To completely delete an application's data, head to the archive tab of the settings page, and archive the desired applications.

How can I deactivate or close my account?

To deactivate or close your account, please contact us at How to Get Help.

What permissions does Epsagon require?

Integrating to the environment requires certain permissions, that some of them can be modified upon request. For tracing, no permissions are needed, except for whitelisting outbound traffic to Epsagon.


Where can I find my Epsagon token?

Your Epsagon token is located in your settings page.

I don't see any traces

Make sure your code is accessible to the internet. If you need to whitelist specific IPs you can use the following list based on your region (port 443):



US East (Ohio)

US East (N. Virginia)

US West (N. California)

US West (Oregon)

Asia Pacific (Mumbai)

Asia Pacific (Seoul)

Asia Pacific (Singapore)

Asia Pacific (Sydney)

Asia Pacific (Tokyo)

Canada (Central)

EU (Frankfurt)

EU (Ireland)

EU (London)

EU (Paris)

South America (São Paulo)

In addition, make sure that your account didn't run out of quota. To check that, head to your billing page.

If you still don't see any traces, contact us at the How to Get Help.

How to disable traces on local / dev?

You can add DISABLE_EPSAGON=TRUE as an environment variable to completely disable in local, tests, or dev environment.

How to sample traces?

Epsagon does not recommend sampling traces, especially in distributed environments. If you still wish to consult with us, contact us at the How to Get Help.

How to use the Epsagon layers in Lambda?

If you choose, you can use our layer in your Python or Node.js function instead of installing it.

  • Python layer ARN: arn:aws:lambda:<region>:066549572091:layer:epsagon-python-layer:<version>
  • Node.js layer ARN: arn:aws:lambda:<region>:066549572091:layer:epsagon-node-layer:<version>

To get the latest layer details you can get to this endpoint:<region>&name=<layer>&max_items=1

For example:

Lambda can't find the file .... Make sure that your handler upholds the format: file-name.method

When using the Epsagon auto-tracing on Node or Python functions, it adds a layer and updates the handler to point to a file in it. Since it can't be opened, the following notice appears:

This is NOT an issue, the function is completely fine - Your function is still running regularly, and you can edit the files.

In Node you'll see the message - Lambda can't find the file /opt/nodejs/node_modules/epsagon.js. Make sure that your handler upholds the format: file-name.method.

In Python you'll see the message - Lambda can't find the file epsagon.wrapper. Make sure that your handler upholds the format: file-name.method.

Do you support PrivateLink?

Yes. You can follow this tutorial.


Invocations, log view, and alerts are currently not available for this function / Function subscribed to a different consumer

In order to parse invocations, Epsagon subscribes to your CloudWatch log group and parse it. Since there is only one destination that can be applied, if you found the following warning next to your function:

It means that your function is already subscribed. To fix that, we can subscribe the logs to Epsagon, or provide you with a solution to stream logs to multiple destinations. Contact us at the How to Get Help.

Getting ROLLBACK_COMPLATE when deploying the CloudFormation stack / Can't deploy the CloudFormation stack

If you are facing any errors deploying the Epsagon CloudFormation stack, first make sure that it is not already deployed in your account. To do that you can look for a stack named Epsagon in your CloudFormation dashboard, or an IAM role named EpsagonRole.
In such cases or any other issue contact us at the How to Get Help.


How do I mute an alert or an issue?

You can either delete it from the Alerts page or mute it in the Issues Manager page.

Did this page help you?