{"id":19024424,"url":"https://github.com/aws-solutions/media-services-application-mapper","last_synced_at":"2025-09-04T07:31:38.720Z","repository":{"id":37833724,"uuid":"152290375","full_name":"aws-solutions/media-services-application-mapper","owner":"aws-solutions","description":"Media Services Application Mapper is a browser-based tool that allows operators to visualize the structure and logical connections among AWS Media Services and supporting services in the cloud. The tool can be used as a top-down resource monitoring tool when integrated with CloudWatch.","archived":false,"fork":false,"pushed_at":"2024-07-02T20:25:06.000Z","size":56618,"stargazers_count":82,"open_issues_count":5,"forks_count":26,"subscribers_count":26,"default_branch":"main","last_synced_at":"2024-12-24T03:09:04.054Z","etag":null,"topics":["cloudfront","cloudwatch","media","mediaconnect","medialive","mediapackage","mediastore","monitoring","s3","serverless","speke","streaming","video","visualization"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aws-solutions.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.txt","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-10-09T17:10:15.000Z","updated_at":"2024-10-25T02:15:51.000Z","dependencies_parsed_at":"2024-12-24T03:09:09.966Z","dependency_job_id":"8c9263f2-23d7-4be1-8062-be16a4d68587","html_url":"https://github.com/aws-solutions/media-services-application-mapper","commit_stats":null,"previous_names":[],"tags_count":35,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aws-solutions%2Fmedia-services-application-mapper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aws-solutions%2Fmedia-services-application-mapper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aws-solutions%2Fmedia-services-application-mapper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aws-solutions%2Fmedia-services-application-mapper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aws-solutions","download_url":"https://codeload.github.com/aws-solutions/media-services-application-mapper/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":231940764,"owners_count":18449192,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cloudfront","cloudwatch","media","mediaconnect","medialive","mediapackage","mediastore","monitoring","s3","serverless","speke","streaming","video","visualization"],"created_at":"2024-11-08T20:36:45.278Z","updated_at":"2024-12-31T04:08:47.021Z","avatar_url":"https://github.com/aws-solutions.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"### This solution is no longer being maintained.\n---\n\n**[🚀 Solution Landing Page](https://aws.amazon.com/solutions/implementations/media-services-application-mapper/)** | **[🚧 Feature request](https://github.com/awslabs/aws-media-services-application-mapper/issues/new?assignees=\u0026labels=feature-request%2C+enhancement\u0026template=feature_request.md\u0026title=)** | **[🐛 Bug Report](https://github.com/awslabs/aws-media-services-application-mapper/issues/new?assignees=\u0026labels=bug%2C+triage\u0026template=bug_report.md\u0026title=)**\n\nNote: If you want to use the solution without building from source, navigate to Solution Landing Page\n\n## Table of contents\n\n- [Solution Overview](#solution-overview)\n- [Installation Guide](#installation-guide)\n- [Architecture Diagram](#architecture-diagram)\n- [Customizing the Solution](#customizing-the-solution)\n  - [Prerequisites for Customization](#prerequisites-for-customization)\n  - [Build](#build)\n  - [Unit Test](#unit-test)\n  - [Deploy](#deploy)\n- [File structure](#file-structure)\n- [License](#license)\n- [Collection of operational metrics](#collection-of-operational-metrics)\n  - [Navigate](#navigate)\n\n\u003ca name=\"solution-overview\"\u003e\u003c/a\u003e\n# Solution Overview\n[//]: # (What does the solution do? What customer problem does it solve? Mention specific use cases)\n* AWS Media Services Application Mapper (MSAM) is a browser-based tool that allows operators to visualize the structure and logical connections among AWS Media Services and supporting services in the cloud.\n* MSAM can be used as a top-down resource monitoring tool when integrated with CloudWatch.\n* MSAM offers two different visualization options: Diagrams and Tiles. \n* MSAM can be configured to automatically display AWS Media Services alerts from AWS Elemental MediaLive channels and multiplex and AWS Elemental MediaConnect.\n\n**Go [here](https://docs.aws.amazon.com/solutions/latest/media-services-application-mapper/welcome.html) for more information on MSAM's capabilities and features.**\n\n\u003ca name=\"installation\"\u003e\u003c/a\u003e\n# Installation Guide\nGo [here](https://docs.aws.amazon.com/solutions/latest/media-services-application-mapper/automated-deployment.html) for more information on installing MSAM into your AWS account.\n\n\u003ca name=\"architecture-diagram\"\u003e\u003c/a\u003e\n# Architecture Diagram\n[//]: # (Provide Architecture Diagram. Add few bullets to describe the architecture workflow)\nYou'll find the various architectural views for MSAM [here](https://docs.aws.amazon.com/solutions/latest/media-services-application-mapper/architecture-overview.html).\n\u003ca name=\"aws-solutions-constructs\"\u003e\u003c/a\u003e\u003ca name=\"customizing-the-solution\"\u003e\u003c/a\u003e\n# Customizing the Solution\n\n\u003ca name=\"prerequisites-for-customization\"\u003e\u003c/a\u003e\n## Prerequisites for Customization\n[//]: # (Add any prerequisites for customization steps. e.g. Prerequisite: Node.js\u003e10)\n\n* Install/update to Python 3.x\n* Install the AWS Command Line Interface (CLI)\n* Create a Python [virtual environment](https://docs.python.org/3.8/library/venv.html) using [requirements.txt](deployment/requirements.txt) and activate it\n* Configure the bucket name of your target Amazon S3 distribution bucket\n```\nexport DIST_OUTPUT_BUCKET=my-bucket-name # bucket where customized code will reside\nexport SOLUTION_NAME=my-solution-name\nexport VERSION=my-version # version number for the customized code\n```\n_Note:_ You would have to create an S3 bucket with the prefix '_my-bucket-name-\u003caws_region\u003e_'.  aws_region is where you are testing the customized solution. Also, the assets in bucket should be publicly accessible.\n\n\u003ca name=\"build\"\u003e\u003c/a\u003e\n## Build\n[//]: # (Add commands to build lambda binaries from root of the project)\nTo build the distributable and prepare the CloudFormation templates:\n```\ncd deployment\nchmod +x ./build-s3-dist.sh\n./build-s3-dist.sh $DIST_OUTPUT_BUCKET $SOLUTION_NAME $VERSION\n```\n\nCloudFormation templates will be written to deployment/global-s3-assets.\n\nLambda binaries will be written to deployment/regional-s3-assets.\n\n\n\u003ca name=\"unit-test\"\u003e\u003c/a\u003e\n## Unit Test\n[//]: # (Add commands to run unit tests from root of the project)\nExecute this solution's unit tests manually with the following commands:\n```\ncd deployment\nchmod +x run-unit-tests.sh\n./run-unit-tests.sh\n```\n\nIf no virtual environment is currently activate, this script will create and activate a temporary Python virtual environment capable of running the unit tests.\n\n\n\u003ca name=\"deploy\"\u003e\u003c/a\u003e\n## Deploy\n[//]: # (Add commands to deploy the solution's stacks from the root of the project)\n\nDeploy the distributable to an Amazon S3 bucket in your account. \n\n1. From the deployment directory run the _deploy.sh_ script. \n\nScript usage:\n```\n./deploy.sh [-b BucketBasename] [-s SolutionName] [-v VersionString] [-r RegionsForDeploy] [-p AWSProfile] [-a ACLSettings(public-read|none)] [-t DeployType(dev|release)] \n```\n\nExample usage:\n```\n ./deploy.sh -b mybucket -s aws-media-services-application-mapper -v v1.8.0 -r \"us-west-2 us-east-1 us-east-2\" -p default -a public-read -t dev\n\n\n```\n\nAll CloudFormation templates and lambda binaries will end up in:\n\n``` \ns3://my-bucket-aws-region/solution-name/version/\n```\n\nIf deploying with type _release_, CloudFormation templates will also be written to:\n``` \ns3://my-bucket-aws-region/solution-name/latest/\n```\n\n2.  Get the link of the solution template uploaded to your Amazon S3 bucket.\n\n``` \ns3://my-bucket-aws-region/solution-name/latest/aws-media-services-application-mapper-release.template\n\nOR\n\ns3://my-bucket-aws-region/solution-name/version/aws-media-services-application-mapper-timestamp.template\n```\n\n3. Deploy the solution to your account by launching a new AWS CloudFormation stack using the link of the solution template in Amazon S3.\n\n\u003ca name=\"file-structure\"\u003e\u003c/a\u003e\n# File structure\n\nAWS Media Services Application Mapper consists of:\n\n\u003cpre\u003e\n|- deployment\n|   |- build-s3-dist.sh             [ Script for building distributables and preparing the CloudFormation templates ]\n|   |- deploy.sh                    [ Script for deploying distributables and CloudFormation templates to user's S3 bucket ]\n|   |- global-s3-assets             [ CloudFormation templates get written here during custom build ]\n|   |- regional-s3-assets           [ Packaged code for Lambda get written here during custom build ]\n|   |- run-unit-test.sh             [ Script for running unit tests ]\n|- docs\n|   |- ARCHITECTURE.md              [ 4+1 architectural views of MSAM ]\n|   |- DEV_PROCESS.md               [ Describes the MSAM team's development process and environment ]\n|   |- EXTENDING_MSAM.md            [ Instructions to extend MSAM with your own types ]\n|   |- FEATURES.md                  [ Overview of solution features ]\n|   |- INSTALL.md                   [ Installation guide for MSAM ]\n|   |- MANAGED_INSTANCES.md         [ Using AWS Systems Manager and on-premise hardware ]\n|   |- MEDIALIVE_WORKFLOW_WIZARD.md [ Monitoring worfklow created by MediaLive workflow wizard ]\n|   |- RESOURCE_TAGS.md             [ Tagging resources for tile and diagram creation ]\n|   |- REST_API.md                  [ Overview of the MSAM REST API and use ]\n|   |- UNINSTALL.md                 [ Steps to remove MSAM from your AWS account ]\n|   |- USAGE.md                     [ Getting started and usage tips for the browser tool ]\n|   |- WORKSHOP.md                  [ Steps for a workshop presented at re:Invent 2019 ]\n|   |- behavioral-views.drawio      [ diagrams.net source for behavioral view ]\n|   |- deployment-view.drawio       [ diagrams.net source for deployment view ]\n|   |- images                       [ Images used in documentation ]\n|   |- logical-view.drawio          [ diagrams.net source for logical view ]\n|   |- physical-view.drawio         [ diagrams.net source for physical view ]\n|   |- use-cases.drawio             [ diagrams.net source for use case view ]\n|- source\n    |- events                       [ Source files for CloudWatch Event and Alarm handling ]\n    |- html                         [ Source files for browser application ]\n    |- msam                         [ Source files for the MSAM REST API and scheduled tasks ]\n    |- tools                        [ Scripts used in the development of MSAM ]\n    |- web-cloudformation           [ Source files for the web template and custom resources ]\n\u003c/pre\u003e\n\n\u003ca name=\"license\"\u003e\u003c/a\u003e\n# License\n\nSee license [here](LICENSE.txt).\n\n\n\u003ca name=\"metrics\"\u003e\u003c/a\u003e\n# Collection of operational metrics\n\nThis solution collects anonymized operational metrics to help AWS improve the quality of features of the solution. For more information about this capability, please see the [implementation guide](https://docs.aws.amazon.com/solutions/latest/media-services-application-mapper-on-aws/references.html).\n\n## Navigate\nNavigate to [Architecture](https://docs.aws.amazon.com/solutions/latest/media-services-application-mapper/architecture-overview.html) | [Workshop](docs/WORKSHOP.md) | [Install](https://docs.aws.amazon.com/solutions/latest/media-services-application-mapper/automated-deployment.html) | [Usage](https://docs.aws.amazon.com/solutions/latest/media-services-application-mapper/using-the-browser-application.html) | [Uninstall](https://docs.aws.amazon.com/solutions/latest/media-services-application-mapper/uninstall-the-solution.html) | [Rest API](docs/REST_API.md) | [Contributing](CONTRIBUTING.md)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faws-solutions%2Fmedia-services-application-mapper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faws-solutions%2Fmedia-services-application-mapper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faws-solutions%2Fmedia-services-application-mapper/lists"}