Integration Guides

AWS Recommendations

23min

Purpose

The purpose of this document is to provide a configuration guide for enabling key AWS Services and integrating those services with SHI One.

The implementation of the services covered in this guide will allow SHI to provide recommendations based upon foundational best practices and compute analysis across your AWS Organization.

The integration of these services into SHI One provides a simplified and unified view of this information to help guide you to optimize AWS infrastructure, improve security and performance, reduce costs, and monitor service quotas.



Getting Started

Prerequisites

The following section describes the prerequisites that must be met to utilize the SHI One AWS Recommendations Integration.

Note: If you already purchase AWS from SHI, you can help ensure these prerequisites are met by submitting a Service Request to “Enable AWS Organizations”



Trusted Advisor

AWS Trusted Advisor provides recommendations to ensure AWS best practices are being followed. Trusted Advisor evaluates an AWS account by using checks. These checks identify ways to optimize AWS infrastructure, improve security and performance, reduce costs, and monitor service quotas.

Pricing

Business Support Plan Pricing Example

For example, $85,000 in monthly AWS charges:

  • $10,000 x 10% = $1,000
    • (10% of first $0 - $10K of charges)
  • + $70,000 x 7% = $4,900
    • (7% of charges from $10K - $80K)
  • +$5,000x5%=$250
    • (5% of charges from $80K - $250K)
  • + 0 x 3% = $0
    • (3% of charges over $250K)
  • Total = $6,150

Enterprise Support Plan Pricing Example

For example, $1.2M in monthly AWS charges:

  • $150,000 x 10% = $15,000
    • (10% of first $0 - $150K of charges)
  • + $350,000 x 7% = $24,500
    • (7% of charges from $150K - $500K)
  • + $500,000 x 5% = $25,000
    • (5% of charges from $500K - $1M)
  • + $200,000 x 3% = $6,000
    • (3% of charges over $1M)
  • Total = $70,500

Resources



Cost Explorer

AWS Cost Explorer helps visualize, understand, and manage AWS costs and usage over time.

Prerequisites

Note: If SHI owns the Payer account, we can complete this for the customer

Cost Explorer Developer Notes

  • API can access 12 months of historical data, 3 months of forecast data at a daily level of granularity, and 12 months of forecast data at a monthly level of granularity
  • Billing information is updated at least once and up to 3 times daily; query for the time period you’re interested in
  • Query for filtered data as you are charged per paginated request ($.01 per paginated request)
    • Due to this consideration, it is recommended that requests are cached to prevent unnecessary calls
    • Max number of filters per GetCostAndUsage operation: 100

Right Sizing Recommendations

Note: If SHI owns the Payer account, we can complete this for the customer

Resources



SHI One Integration

Overview

Once SHI One AWS Recommendations is enabled, aggregated findings from AWS Trusted Advisor will be visible from within SHI One. Our AWS Recommendations integration will help you identify areas of concern and aid in the prioritization of remediation and optimization efforts.

The following section describes the necessary configuration to integrate AWS Trusted Advisor into SHI One and also details the permissions necessary to ensure proper functionality of the AWS Recommendations Integration.

To utilize the AWS Recommendations Integration to its fullest capabilities, an IAM role containing the permissions outlined in this section should be pushed to each AWS account in scope. It is required that the role names and external IDs are the same in each account in scope.

Enable SHI One Integration

Creating the Necessary IAM Role

The necessary IAM role can be created via CloudFormation with the following template.

  1. Create Stack
    • 

      Document image
      
  2. Click Next
  3. Enter an External ID composed of:
    • Any string of random numbers
    • Alphanumeric without whitespaces
    • Minimum of 2 characters
    • Maximum of 1,224 characters
  4. Specify Stack details
    • 

      Document image
      
  5. Click Next
  6. Click Next
  7. Check the checkbox "I acknowledge that AWS CloudFormation might create IAM resources"
  8. Click Create Stack
  9. Record the RoleARN and External ID for use in the subsequent steps

Creating the Necessary IAM Role – Child Accounts

For more detailed step-by-step instructions on creating a CloudFormation Stackset, visit: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-getting-started-create.html

  1. Create a CloudFormation Stackset
  2. Choose a template
    • 

      Document image
      
  3. Click Next
  4. Enter the External ID from the previous steps
    • 

      Document image
      
  5. Click Next
  6. Click Next
  7. Specify Region US East (N. Virginia)
  8. Click Next
  9. Check the checkbox “I acknowledge that AWS CloudFormation might create IAM resources"
  10. Click Submit

Configure the SHI One Integration

  1. Log into SHI One (https://one.shi.com)
  2. On the lefthand sidebar, navigate to Settings -> Integrations
  3. Click the three dots in the upper right corner of the AWS Recommendations box
    • If you don’t see AWS Recommendations, first confirm that you have an AWS contract visible under Services -> Contracts as you may not yet be fully onboarded to SHI One
    • Alternatively, submit a support request via Support Center -> Submit Request
  4. Click Add New
  5. Populate the form with the RoleARN and External ID from the previous steps
  6. Click Test
  7. Click Save
  8. Repeat steps 3-7 until all have been added
  9. Verify that the slider on the right of the AWS Recommendations box is orange/activated
  10. Click the AWS Recommendations box and verify that each slider is orange/activated

Note that it takes AWS up to 24 hours to start sending data to SHI One.

Pricing

SHI collects data daily from the AWS Trusted Advisor and AWS Cost Explorer APIs. There is no cost for querying the AWS Trusted Advisor API. Each request to the AWS Cost Explorer API is $0.01.

If you have 10 accounts and SHI makes 1 request to AWS Cost Explorer against each account per day, that would incur a cost of $.10 per day.

Troubleshooting

If the integration doesn't show up on the integrations page or you are unable to enable it:

  1. Submit a Support Request as this could potentially be a site-wide issue

If you have enabled the integration and your data doesn't show up:

  1. Verify that it has been at least 24 hours as collection occurs daily
  2. Verify that you have deployed a role with the correct permissions as documented
  3. Re-enter your information from your Payer Account (ARN and External ID) on the integrations
    • The External ID must be the same across all accounts in your organization
  4. Validate that the requisite configuration as documented has been met

If you are missing Trusted Advisor data in certain accounts:

  1. Make sure each account targeted for Trusted Advisor has at least Business Support
  2. Verify that you have deployed a role with the correct permissions in each account targeted for data collection as documented

If you are reporting Cost Explorer data for only one account:

  1. Re-enter your information from your Payer Account (ARN and External ID) on the integrations page, which can be found where you launched the CloudFormation template for the role
    • All Cost Explorer Information is queried directly from the Payer Account

Note: If you encounter an issue not addressed within this section, please submit a Support Request via Support Center -> Submit Request