Need help with aws-perspective?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

426 Stars 34 Forks Apache License 2.0 91 Commits 67 Opened issues


AWS Perspective is a solution to visualize AWS Cloud workloads. Using Perspective you can build, customize, and share detailed architecture diagrams of your workloads based on live data from AWS. Perspective works by maintaining an inventory of the AWS resources across your accounts and regions, mapping relationships between them and displaying them in the Web User Interface (Web UI). When you need to make changes to a resource, Perspective saves time by providing a link to the resource in the AWS Console.

Services available


Need anything else?

Contributors list

# 91,747
10 commits
# 187,831
5 commits
# 403,116
Amazon ...
2 commits

AWS Perspective (v1.1.1)

AWS Perspective is a tool that quickly visualizes AWS Cloud workloads as architecture diagrams. You can use the solution to build, customize, and share detailed workload visualizations based on live data from AWS. This solution works by maintaining an inventory of the AWS resources across your accounts and Regions, mapping relationships between them, and displaying them in a web user interface (web UI).

v1.1.1 brings a new feature that uses AWS Cost & Usage Reports (AWS CUR) to help you identify AWS resources that have incurred a cost. You can build architecture diagrams displaying this cost information and generate Cost Reports which graph the overall cost of your workload over a configurable time period. These reports can be exported in CSV format.

The new release includes many UX improvements among them a Grouped Resources ** view which displays an inventory of your workloads. Resource type coverage has also been improved with Perspective now supporting your Amazon Redshift Clusters.

An update-in-place option has been added to further simplify the update process. Perspective will default to using Graviton instances where possible, resulting in up to a 20% reduction in running costs over the previous version.

To find out more about AWS Perspective visit the AWS Perspective Solution Page.


Build architecture diagrams

AWS Perspective lets you build, customize, and share detailed architecture diagrams. Perspective maintains an inventory of the AWS resources across your accounts and Regions, mapping relationships between them and displaying them in a web user interface (UI).

Generating an architecture diagram.

Query AWS Cost & Usage Reports (CURs)

The cost query builder lets you locate AWS resources and services that may have incurred a cost. The estimated cost data is automatically calculated for the time period specified and displays on your architecture diagrams.

You can generate a cost report for your architecture diagrams that contains an overview of the estimated cost and export them as CSV.

View Cost & Usage Report data.

Explore your AWS Resources

Explore resources provisioned across your accounts and Regions using the resource directory. It contains all the resources Perspective has discovered. You can start building your architecture diagrams with a single click of a resource.

The search feature lets you use basic information e.g. resource name, Tag name, or IP address to locate the resources you are interested in.

Searching by resource type e.g. ::RDS will bring back RDS resources.

Save & export architecture diagrams

You can save your architecture diagram to revisit later or share it with other Perspective users. If you need to use the diagrams outside of Perspective you can export to PNG, JSON, CSV, or DrawIO.

To find out more about AWS Perspective visit our AWS Solutions page.

Launch AWS Perspective

| Region | Launch | Template Link | |----------|:-------------:|:------:| | US East (N. Virginia) (us-east-1) |Launch | Link| | US East (Ohio) (us-east-2) | Launch | Link | | US West (Oregon) (us-west-2) | Launch | Link | | Asia Pacific (Mumbai) (ap-south-1) | Launch | Link| | Asia Pacific (Seoul) (ap-northeast-2) | Launch | Link | | Asia Pacific (Singapore) (ap-southeast-1) | Launch | Link | | Asia Pacific (Sydney) (ap-southeast-2) | Launch | Link| | Asia Pacific (Tokyo) (ap-northeast-1) | Launch |Link | | Canada (Central) (ca-central-1) | Launch | Link | | Europe (Ireland) (eu-west-1) | Launch | Link | | Europe (London) (eu-west-2) | Launch | Link | | Europe (Frankfurt) (eu-central-1)| Launch | Link | | Europe (Paris) (eu-west-3)| Launch | Link | | Europe (Stockholm) (eu-north-1)| Launch | Link | | South America (Sao Paulo) (sa-east-1) | Launch | Link |


AWS Perspective is deployed to your account using an AWS CloudFormation template and should take approximately 30 minutes to deploy. See the deployment guide for instructions, and the cost overview to learn about costs.


A web interface is included with AWS Perspective. To login to the interface, follow the Post-deployment configuration steps of the installation guide.

Refer to the implementation guide to learn how to use AWS Perspective.

Feature requests

To submit an idea for a feature you would like to see implemented, please create an issue and use the 'enhancement' label. Your issue will be available on the project board for others to vote on.


Architecture diagram showing full set of deployment resources

AWS Perspective is deployed to your account using an AWS CloudFormation template consisting of six components. Following is a high level overview of the components. For additional details about each component, refer to the Solution components guide.

The web user interface (UI) interacts with the data component via Amazon API Gateway and AWS AppSync endpoints. The web UI requests resource relationship data from the data component. The data component queries and returns data from an Amazon Neptune database.

The storage management component stores user preferences and saved architecture diagrams. This is implemented using AWS Amplify and an Amazon Simple Storage Service (Amazon S3) bucket.

The discovery component uses AWS Config and AWS API calls to maintain an inventory of resource data from imported accounts and Regions, then stores its findings in the data componenet. This runs every 15 minutes as a container task on AWS Fargate. The discovery component container image is built in the image deployment component using AWS CodePipeline and AWS CodeBuild.

The cost component processes AWS Cost and Usage Reports (AWS CUR) to make cost data available in AWS Perspective. To use this feature, you must create a report in AWS CUR to deliver the reports to the

Amazon S3 bucket. When an AWS CUR is delivered, it triggers an AWS Lambda function to trigger a AWS Glue Crawler that will update a table ready for Amazon Athena to query. You can query these AWS CURs via the Perspectie UI. You can bring in cost data from other accounts discoverable to Perspective by setting up a AWS CUR and setting up replication between the S3 bucket in the discoverable account and the


Directory structure

  |             [ shell script for packaging distribution assets ]
  |            [ shell script for executing unit tests ]
  |-perspective-setup.yaml       [ the main CloudFormation deployment template ]
  |-frontend/                    [ the frontend ui code ]
  |-backend/                     [ the backend code ]
    |-discovery/                 [ the code for the discovery process ]
    |-functions/                 [ the code for the Lambda functions ]
  |-cfn/                         [ the CloudFormation templates that deploy aws-perspective ]

Running the Perspective Web Application locally

For development and debugging, it's possible to run the Perspective UI locally. The Perspective solution must already be deployed to an account.

The Perspective solution generates a

file used by the web browser for configuration. To develop locally, this
file must be present.
  • Copy the
    file from the S3 Bucket containing the Perspective UI. This has the logical name
    in the CloudFormation stack.
  • Place the
    file in
  • From the
    directory, run
    npm install
  • Run
    npm run start
    to run the local development server.

Running unit tests

cd ./deployment

Running a local build

cd ./deployment


When you have made changes to the code, you can build it locally and upload the deployment artefacts to Amazon S3 by running the following bash script.


  1. AWS CLI installed.
  2. The CLI configured with credentials/profile that will allow:
    • S3 Bucket creation
    • S3 Object creation

Create deployment script

  1. Create a shell script in the root project directory.
  2. Copy the contents below and paste in Substitute the value placeholders (marked with angle brackets) with your own values, then save the script.
#!/usr/bin/env bash

set -euo pipefail

The Region you wish to deploy to.


The S3 Bucket name to be created to store your deployment artefacts


A name for your test solution


A version number for this test release e.g vX.Y.Z


Tag that will be given to Docker image.


if aws s3api head-bucket --bucket "${DIST_OUTPUT_BUCKET}" 2>/dev/null; then echo "${DIST_OUTPUT_BUCKET} bucket exists and you own it, so not creating it" else echo "creating bucket in region ${AWS_REGION} with name ${DIST_OUTPUT_BUCKET}" aws s3 mb s3://${DIST_OUTPUT_BUCKET} --region ${AWS_REGION} fi

if aws s3api head-bucket --bucket "${DIST_OUTPUT_BUCKET}-${AWS_REGION}" 2>/dev/null; then echo "${DIST_OUTPUT_BUCKET}-${AWS_REGION} bucket exists and you own it, so not creating it" else echo "creating bucket in region ${AWS_REGION} with name ${DIST_OUTPUT_BUCKET}-${AWS_REGION}" aws s3 mb s3://${DIST_OUTPUT_BUCKET}-${AWS_REGION} --region ${AWS_REGION} fi

cd deployment ./ $DIST_OUTPUT_BUCKET $SOLUTION_NAME $VERSION $IMAGE_TAG aws cloudformation package --template-file "global-s3-assets/perspective-setup.template" --s3-bucket "$DIST_OUTPUT_BUCKET" --s3-prefix "${SOLUTION_NAME}/${VERSION}" --output-template-file packaged.template aws s3 cp packaged.template "s3://${DIST_OUTPUT_BUCKET}/${SOLUTION_NAME}/${VERSION}/aws-perspective.template" aws s3 cp global-s3-assets s3://${DIST_OUTPUT_BUCKET}-${AWS_REGION}/${SOLUTION_NAME}/${VERSION}/ --recursive --acl bucket-owner-full-control aws s3 cp regional-s3-assets s3://${DIST_OUTPUT_BUCKET}-${AWS_REGION}/${SOLUTION_NAME}/${VERSION}/ --recursive --acl bucket-owner-full-control

echo "You can now deploy using this template URL https://${DIST_OUTPUT_BUCKET}.s3.${AWS_REGION}${SOLUTION_NAME}/${VERSION}/aws-perspective.template"

  1. Make the script executable
    chmod +x ./
  2. Run the script

This will:

  • Create S3 buckets to store the deployment artefacts.
  • Run the build
  • Deploy artefacts to your chosen S3 Bucket.

Deploying the CloudFormation template

Once you have the deployment artefacts in S3, you can deploy the aws-perspective.template in the CloudFormation console. Just pass the link to the template in S3 to CloudFormation and it will do the rest.

Parameters required by the template:

  • Stack Name - The name given to the deployment stack e.g. aws-perspective
  • AdminUserEmailAddress - The email address to receive login credentials at.
  • AlreadyHaveConfigSetup - Yes/No depending on whether AWS Config has is configured in the deployment Region.
  • CreateElasticsearchServiceRole - Yes/No depending on whether you already have this service-role created. You can check in the IAM console to see if it is provisioned.
  • OptOutOfSendingAnonymousUsageMetrics - Yes/No depending on whether you are happy to send anonymous usage metrics back to AWS.
  • CreateNeptuneReplica - Yes/No depending on whether you want a read-replica created for Amazon Neptune. Note, that this will increase the cost of running the solution.
  • NeptuneInstanceClass - Select from a range of instance types that will be provisioned for the Amazon Neptune database. Note, the selection could increase the cost associated with running the solution.
  • OpensearchInstanceType - Select the instance type that will be provisioned for the Amazon ElasticSearch Domain.
  • CreateAPIGatewayCloudWatchLogsRole - If set to Yes, the solution creates a role and overwrites the existing APIGatewayCloudWatchLogsLogsRole property. Set to No if you already have an existing role set.
  • AthenaWorkgroup - The Workgroup that will be used to issue the Athena query when the Cost feature is enabled.
  • OpensearchMultiAz - Choose whether to create an Opensearch cluster that spans multiple Availability Zone. Choosing Yes improves resilience; however, increases the cost of this solution.

Note - You will need to deploy in the same account and region as the S3 bucket that the deployment artefacts are uploaded to.

Web API Examples

Getting a Bearer Token

Via Browser

The Web API requires a JWT present in the request Authorization Header. You can find your Bearer Token by:

  1. Logging into AWS Perspective UI in Google Chrome
  2. Right-click anywhere on the screen.
  3. Click Inspect
  4. Click Network
  5. Find the resources request.
  6. Select it and go to Headers
  7. Locate the Authorization Header
  8. Copy the contents.



The Server API URL is specified in the

CloudFormation template output

--header "Authorization: Bearer ${AUTH}"
--header 'Content-Type: application/json'
--data-raw '{"command":"getAllResources","data":{}}'


You will receive all the resources that have been discovered with just a subset of data about each one. You will also receive a metadata object that breaks down the resource types discovered and the resource counts for each. This is done for each account and region that is discoverable to AWS Perspective.


The Server API URL is specified in the

CloudFormation template output

curl -X GET "${SERVER_API_URL}/resources?command=linkedNodesHierarchy&id=${NODE_ID}"
--header "Authorization: Bearer ${AUTH}"


You will receive an array of nodes that have a relationship with the node id used in the request.

DrawIO Export

This takes a JSON representation of the architecture diagram and converts it to mxGraph and opens in a DrawIO tab. The DrawIO API URL is specified in the

CloudFormation template output

curl -X POST "https://${DRAWIO_API_URL}.execute-api.${AWS_REGION}"
--header 'Content-Type: text/plain'
-H "Authorization: Bearer ${AUTH}"
--data-raw '{"elements":{"nodes":[], "edges": []}}'


You will receive a URL that when clicked will open up DrawIO in the browser and show your graph.

Collecting Anonymous Operational Metrics

This solution collects anonymous operational metrics to help AWS improve the quality of features of the solution. For more information, including how to disable this capability, please see the Implementation Guide.


AWS Perspective is able to generate its architecture diagrams thanks to these libraries developed and maintained by the Info Visualization Research Lab over at Bilkent University:

Copyright 2021, Inc. or its affiliates. All Rights Reserved.

Licensed under the Apache License Version 2.0 (the "License"). You may not use this file except in compliance with the License. A copy of the License is located at or in the "license" file accompanying this file. This file is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, express or implied. See the License for the specific language governing permissions and limitations under the License.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.