AWS plugin

Visit our website to see the data that you can access if you use this plugin to add the data source to SquaredUp:

AWS

Monitor your AWS environment, including EC2, Lambda Functions, CloudWatch and more.

How to add an AWS data source

You will need

  • The Access key ID and Secret access key of an IAM user with programmatic access.

  • The AWS Account ID and Target Regions for your AWS resources.

User with Programmatic access

You will need to configure a new or existing user with a ReadOnlyAccess AWS managed policy. This policy provides the necessary rights for the integration to function. Alternatively, this policy can also be used as a starting point for a custom policy if, for example, sensitive services need to be removed.

Warning: Warning: While it is possible to use a custom policy, restricting access can severely impact the usability of the plugin such as preventing the use of scoped data streams. The ability to search for objects can also be impacted

A small number of data streams do require additional access rights such as the AmazonTimestreamReadOnlyAccess AWS managed policy (required for the Timestream Query data stream), which are documented in the corresponding data stream sections of this article.

See AWS credentials - Programmatic access and Creating an IAM user in your AWS account

Add the AWS data source to SquaredUp

  1. To add a data source click on the + next to Data Sources on the left-hand menu in SquaredUp. Search for the data source and click on it to open the Configure data source page.

  2. Enter the Access Key ID and Secret Access Key of the IAM user with programmatic access.

  3. Input the Target Regions for your AWS resources, i.e. us-east-2, eu-west-1

  4. Enter the AWS Account ID

  5. Enter an Account name to help you remember which account and credentials you have used above. For example, you might type prod to remind you that you used the production account details.

  6. Install Sample Dashboards:

    Select whether you would like to install sample dashboards with the data source. By default, this is set to on.

  7. Optionally, select whether you would like to restrict access to this data source instance. By default, restricted access is set to off.

  8. Click Test and add to validate the data source configuration.

    You can also add a data source from Settings > Data Sources > Add data source, but sample dashboards are not added when using this method.

The index time will depend on the size of your AWS environment.

Using the AWS data streams

Data streams are also installed with the data source see Tips for using the AWS Data Streams

Write a custom data stream (advanced use) see Writing a custom data stream (advanced users)

Tips for using the AWS Data Streams

This data source comes with several data streams that you can use in the tiles on your dashboards. Here you'll find tips and ideas for using these data streams to display the data you're interested in.

Writing a custom data stream (advanced users)

  1. Go to Settings > Advanced > Data Streams.

  2. Click Add new Data Stream.

  3. Enter a display name for your Data Stream.

    Note: The display name is the name that you use to identify your Data Stream in SquaredUp. It has no technical impact and doesn't need to be referenced in the Data Stream's code.

  4. Choose the Data Source this Data Stream is for.

    After you've chosen the data source a new field Entry Point appears.

  5. Entry point and code:

    To find out which entry point to select and get code examples for the Code field, see the help below.

  6. Click Save to save your Data Stream.