Skip to content

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.

License

Notifications You must be signed in to change notification settings

ifit/aws-media-services-application-mapper

 
 

Repository files navigation

Media Services Application Mapper (MSAM)

Installing MSAM? Use the detailed installation instructions.

Already using MSAM? Please take our survey and tell us how it's working for you.

Overview

  • 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
  • MSAM can be used as a top-down resource monitoring tool when integrated with CloudWatch
  • MSAM is installed into an AWS account with several CloudFormation templates

Diagrams

  • The user builds one or more diagrams with discovered resources from their AWS account. Diagram contents can be organized in any way that makes sense for the user's environment.

  • The tool visualizes cloud resources as nodes and logical connections between resources as directed edges

  • Edges (connections) on diagrams generally represent some type of data flow

  • Resources with redundant data paths are drawn with multiple, labeled connections

Simple Workflow

  • Simple and complex workflows of Media Services resources can be discovered and represented
  • Different types of service resources are visualized with unique color and textual indicators
  • MSAM includes graphical tools to quickly build diagrams of related resources

The following image shows a diagram with several workflows including resources for AWS S3 buckets, CloudFront, MediaLive, MediaStore, MediaPackage, and a SPEKE key server.

Complex Workflow

  • MSAM is designed to be extended with new node types, connection discovery, visualization overlays, and tools
  • Custom nodes can be added within the browser application directly, or cached into a database through a cloud-side task

The following image of an MSAM diagram shows on-premise equipment: Elemental Live encoder and several Firewalls with connectivity to cloud resources

Customized Nodes

  • MSAM provides configuration data for each resource on the diagram

The following image shows the JSON configuration of a diagram node when it is selected in the diagram. This is the same configuration you would see from the response to a List or Describe API call directed to the service.

Selected Item JSON

Tiles

  • The tile view aggregates several related cloud resources into a single visual item
  • Tiles are often used to represent a streaming channel for monitoring
  • Tiles can be created interactively, or through the REST API for bulk operations

The following image shows a tile view with several tiles. Each tile indicates the number of alerts and alarms aggregated from the underlying resources associated with the tile. Each tile also provides navigation back to the tile's resources on the diagram.

Customized Nodes

  • The tile view displays the aggregated media service configuration information for all resources included in the tile

The following image shows the aggregated JSON configuration of all the diagram elements assigned to the tile.

Customized Nodes

Resource Monitoring

  • MSAM can be configured to automatically display MediaLive Channel, Multiplex and MediaConnect alerts
  • The tool integrates with CloudWatch alarms to indicate operational problems from a top-down view
  • Any CloudWatch alarm can be associated with any node on the diagram
  • CloudWatch alarm indicators are visualized as color and text on the node
  • CloudWatch high-resolution alarms can be used for frequent ten-second notification intervals

The following image shows MediaConnect flows sending to a MediaLive input, a MediaLive channel with an alert status on one of two pipelines shown in yellow color, and a MediaPackage channel with a custom alarm condition.

CloudWatch Support

MSAM provides three tabs in the lower compartment for Pipeline Alerts, Subscribed Alarms, and a recent CloudWatch event history. The following image shows the Pipeline Alerts tab after selecting the MediaLive channel shown above.

CloudWatch Support

This image shows the Subscribed Alarms tab after selecting the MediaPackage channel shown above.

CloudWatch Support

Use the Recent CloudWatch Events tab to see event detail for most resources that emit events. Below is a MediaPackage endpoint resource that emitted an Input Switch Event.

CloudWatch Support

A tile aggregates all structure, configuration and status from the underlying assigned resources. If any resource's CloudWatch alarm assigned to a tile goes into alarm status, the tiles associated with that resource will also show the same status. See the image below.

CloudWatch Support

REST API

All browser actions are performed through an authenticated and SSL encrypted REST API hosted in the cloud. The API can be used by other tools to perform activities such as preloading tile definitions or adding custom content to the cache.

Further information regarding the API can be found here: Rest API

Navigate

Navigate to README | Workshop | Install | Usage | Uninstall | Rest API

About

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.

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 63.1%
  • Python 26.3%
  • HTML 8.7%
  • Shell 1.9%