Epsagon Documentation

Welcome to the Epsagon Documentation. You'll find comprehensive guides and documentation to help you start working with our product as quickly as possible. Let's jump right in!

Get Started

Frequently Asked Questions

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


How does Epsagon work?

Epsagon uses tracing to extract events from the production code. After setting Epsagon in your services, 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. It means that you can use any kind of workload since Epsagon does not use executable agents. It's operating only at the code-level, using a lightweight agent SDK, which allows it to run on containerized applications, serverless, or any other scenario.

Do I need to change my application to use Epsagon?

No. Epsagon supports a variety of common frameworks in multiple languages and will do all the instrumentation automatically for you. If you're using AWS Lambda, you can use our auto-tracing technology to have the Epsagon layer automatically included in your Lambda functions, which no code changes required whatsoever.


How to invite a team member?

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

How can I change the owner of the 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 remove the data from an application, 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 the tracing, no permissions are needed, except for whitelisting outbound traffic to the Epsagon collectors.


Where can I find my token / locate the Epsagon token

To find your Epsagon token, go to your settings page, and you'll see your token:

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 trace, 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:

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.

Updated 2 months ago

Frequently Asked Questions

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.