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.

General

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.

Account

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.

Tracing

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):

Region

IPs

US East (Ohio)
us-east-2

18.219.33.241
18.188.45.127

US East (N. Virginia)
us-east-1

34.237.121.63
100.24.172.136

US West (N. California)
us-west-1

54.193.75.190
52.9.35.36

US West (Oregon)
us-west-2

52.38.14.216
52.10.86.219

Asia Pacific (Mumbai)
ap-south-1

52.66.171.65
35.154.82.192

Asia Pacific (Seoul)
ap-northeast-2

52.79.137.30
13.124.75.0

Asia Pacific (Singapore)
ap-southeast-1

52.76.135.254
52.77.176.39

Asia Pacific (Sydney)
ap-southeast-2

54.206.2.252
13.238.112.245

Asia Pacific (Tokyo)
ap-northeast-1

52.196.207.88
103.4.8.219

Canada (Central)
ca-central-1

52.60.42.83
52.60.99.4

EU (Frankfurt)
eu-central-1

52.29.155.192
35.158.8.2

EU (Ireland)
eu-west-1

54.76.44.166
63.34.110.154

EU (London)
eu-west-2

35.178.55.86
52.56.252.149

EU (Paris)
eu-west-3

52.47.102.27
52.47.95.131

South America (São Paulo)
sa-east-1

52.67.134.150
54.94.140.143

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:
https://layers.epsagon.com/production?region=<region>&name=<layer>&max_items=1

For example:
https://layers.epsagon.com/production?region=us-east-1&name=epsagon-python-layer&max_items=1

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.

Monitoring

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.

Alerting

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.