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

Epsagon's integration to Amazon Web Services (AWS) provides:

  • Get performance metrics, insights, and alerts for:
    • ECS and Fargate clusters.
    • Lambda functions.
    • AppSync APIs.
  • Show logs from CloudWatch Logs for any trace or resource.
  • Show CloudWatch Metrics and events from any other AWS service.
  • Integrate into EventBridge to get Epsagon alerts.

Setup

The integration doesn't require any manual setups. It is based on a predefined CloudFormation template that can be deployed using a simple, built-in AWS wizard.

📘

Terraform deployment

Epsagon also provides the ability to deploy the stack through Terraform. For more information read here

To start the deployment:

  1. Go to the AWS integration section in your Epsagon settings page.
  2. Click on the deploy button, a new AWS tab will be opened. If you're not logged in, make sure to log in to the desired account.
  3. The CloudFormation quick create stack screen will open.
  4. Mark "I acknowledge that AWS CloudFormation might create IAM resources with custom names.", and click "create stack".
  5. Wait for stack creation, should take between 10-30 seconds. You can hit the refresh button until you get a green CREATE_COMPLETE.
  6. Go back to the AWS integration section, and hit the refresh button. You should see your newly integrated AWS account in the table.
  7. ECS clusters, Lambda functions, and AppSync APIs should get populated in the next several minutes across your dashboard.

👍

Integrate multiple AWS accounts

With Epsagon, you can integrate as many AWS accounts that you want. Just follow the deployment process on each account that you wish to integrate.

Step by step instructions with screenshots:

Click the Deploy button

The Quick create stack tag on your AWS account. No need to change any parameter

Creating the stack

You can hit the refresh button until the status changes to green

AWS account alias

To help you remember if a trace, a resource or an alert comes from the production, staging, QA, dev or any other environment, you can alias (name) an integrated AWS account.
To do that, go to the AWS integration section in your Epsagon settings page, and just set or edit the name of any account in the table by clicking the edit icon:

Permissions

The stack creates a role with the following policies and permissions:

[
  "arn:aws:iam::aws:policy/CloudWatchLogsReadOnlyAccess",
  "arn:aws:iam::aws:policy/AWSLambdaReadOnlyAccess",
  "arn:aws:iam::aws:policy/AWSStepFunctionsReadOnlyAccess",
  "arn:aws:iam::aws:policy/AWSXrayReadOnlyAccess",
  "arn:aws:iam::aws:policy/CloudWatchEventsFullAccess",
  "arn:aws:iam::aws:policy/service-role/AWSAppSyncPushToCloudWatchLogs",
  "arn:aws:iam::aws:policy/AWSAppSyncAdministrator"
]
[
  "logs:PutSubscriptionFilter",
  "logs:DeleteSubscriptionFilter",
  "lambda:UpdateFunctionConfiguration",
  "batch:Describe*",
  "ecs:Describe*",
  "ecs:List*",
  "ec2:Describe*",
  "ec2:Get*",
  "application-autoscaling:Describe*",
  "autoscaling:Describe*",
  "elasticloadbalancing:Describe*",
  "iam:PassRole"
]

📘

Custom permissions

If needed, we can customize the permissions to fit your needs. Contact us for more information.

Troubleshooting

If you encounter any issue or error during the setup please contact us through the help widget.

Updated 2 months ago


AWS


Suggested Edits are limited on API Reference Pages

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