Collecting data from Amazon Web Services

Prerequisites

• You must have an AWS account and the required credentials to log in it.
• You must have sufficient privileges to modify the AWS Identity and Access Management (IAM) service details

Supported AWS regions

The following AWS regions are supported.

To create credentials to access AWS

TrueSight Intelligence integrates directly with AWS to collect and display metrics from Amazon CloudWatch. You must have credentials that enable the required privileges from the cloud services.

The principle of least privilege dictates that a user, process, or program must be able to access only the information and resources that are necessary. The following  procedures describe how to configure your AWS account to generate the minimum access credentials required to integrate your AWS account with TrueSight Intelligence.

The AWS IAM service enables you to manage users and permissions in AWS. If you are unfamiliar with this service, see http://aws.amazon.com/documentation/iam/ for additional details. The following instructions assume that you have a basic understanding of IAM.

To create a user

Create a TrueSight user with the required keys.

1. Sign in to the AWS Management Console and open the IAM console at https://console.aws.amazon.com/iam.

2. From the menu pane on the left of the IAM dashboard, select Users.
3. Click Create New Users.
4. In the User name box, type truesight.
5. Select the Generate an access key for each user checkbox.
6. Click Create.

7. Click Download Credentials to save the credentials (Access Key ID and Secret Access Key) to a file.

   The Access Key ID and Secret Access Key are required to configure the integration with TrueSight Intelligence.

8. Click Close.

To create a group

Create a new group and assign the required permissions policy.

1. From the menu pane on the left of the IAM dashboard, select Groups.
2. Click Create New Group.
   
3. In the Group Name box, type Truesight and click Next Step.
4. From the list, select the policy name CloudWatchReadOnlyAccess checkbox and click Next Step.
5. Click Create Group to return to the Groups editor.

To assign the user to the group

Associate the truesight user with the Truesight group, so that the truesight user has the required permissions.

1. From the menu pane on the left of the IAM dashboard, select Groups.
2. Select the checkbox next to the Truesight group name.
3. From the Group Actions list, select Add Users to Group.
4. Select the check box next to truesight.
5. Click Add Users.

To configure the integration

1. Click  > Data Collection > AWS and click Add to integrate and collect data from your Amazon Web Services cloud instance.
2. Use the AWS Configuration section to provide the details required to configure data collection from AWS.
   
   1. Type a display Name for the AWS instance.
   2. Type a Description for your reference.
   3. Set the Polling Frequency (mins) used for polling the AWS instance.
   4. Type the Access Key for your AWS user.
   5. Type the Secret Key for the AWS user.
      For more information about getting the values for the Access Key and Secret Key, see To create credentials to access AWS, earlier in this topic.
   6. Type the TrueSight Intelligence App Name to which the AWS data will be associated.

3. Click Validate and Continue to validate the details and open the AWS Services section to select the AWS services.

   Amazon API Gateway	Amazon ElastiCache	Amazon Redshift
   Auto Scaling	Elastic Load Balancing	Amazon Simple Storage Service
   AWS Billing	Amazon EMR	Amazon Simple Notification Service
   Amazon CloudFront	Amazon Kinesis Streams	Amazon Simple Queue Service
   Amazon DynamoDB	Amazon Lambda	AWS Storage Gateway
   Amazon Elastic Block Store	Amazon Machine Learning	Amazon Simple Workflow Service
   Amazon EC2	AWS OpsWorks	Amazon WorkSpaces
   Amazon EC2Spot	Amazon Relational Database Service	Amazon Route53

4. Click Continue to open the AWS Metrics section.

   The [confluence_table-filter] macro is a standalone macro and it cannot be used inline. Click on this message for details.
   This macro generates standalone content. As a consequence you need to make sure to use a syntax that separates your macro from the content before and after it so that it's on a line by itself. For example in XWiki Syntax 2.0+ this means having 2 newline characters (a.k.a line breaks) separating your macro from the content before and after it.
   

5. Select one or more metrics, or select all metrics to collect data. Use the search box to filter and display metrics that contain specific keywords.
6. Click Save to save the integration.