Dashbird Documentation

Serverless monitoring and debugging guides, best practices and feature overviews.

Quick Start Tutorial For Dashbird Serverless Monitoring

If you haven’t already, sign up for Dashbird here to access the onboarding screen.

Requirements for setting up Dashbird

To set up Dashbird you need to have the following:
  • Administrator access to your AWS account

Open the link to the onboarding screen from your e-mail.


1. Create a new AWS policy for Dashbird

  • Open your AWS console.
  • Navigate to IAMPoliciesCreate Policy.
  • Choose the JSON tab and paste the snippet below into the editor
{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "logs:FilterLogEvents",
            "Resource": "*"
        },
        {
            "Effect": "Allow",
            "Action": "logs:describeLogStreams",
            "Resource": "*"
        },
        {
            "Effect": "Allow",
            "Action": "lambda:listFunctions",
            "Resource": "*"
        },
        {
            "Effect": "Allow",
            "Action": "lambda:listTags",
            "Resource": "*"
        },
        {
            "Effect": "Allow",
            "Action": "xray:Get*",
            "Resource": "*"
        },
        {
            "Effect": "Allow",
            "Action": "xray:BatchGet*",
            "Resource": "*"
        }
    ]
}
  • Press Review Policy and move on to add a name and description
    • Name: dashbird-policy
    • Description: Allow Dashbird to read CloudWatch logs.
  • Move on and press Create Policy

Great! You’ve created an access policy. Now you need to add an AWS role.


2. Add a new AWS role for Dashbird

  • Navigate to IAMRolesCreate New Role.
  • Select
    • Another AWS account
  • Fill out the following:
    • Account ID: 458024764010 - This is Dashbird’s AWS account.
    • Check the Require external ID checkbox
    • External ID: copy from the onboarding app
    • Require MFA: false
    • Click Next: Permissions
  • Select previously created dashbird-policy from the policies list.
  • Click Next: Review
  • Fill out the following for role name and description
    • Role name: dashbird-delegation-role
    • Role description: Access role for Dashbird to read CloudWatch logs.
    • Click Create role
  • Find the created role in the list and open it.
  • If you have done everything correctly, the screen will look something like this. Correct result
  • Copy the ARN of the role


3. Setup Dashbird with the created role

Back on the onboarding screen:

  • Insert your (company) name
  • Select your target region.
  • Paste the Role ARN you copied above.
  • Click Finish!

Dashbird will check if it has access to your AWS account. If everything is set up correctly, you are redirected to the app.

It should take approximately 3-4 minutes for the data to start coming in.


Learn more about account configuration by checking out the next section, or take a look at the account overview for a complete guide.