Skip to content

Latest commit

 

History

History
95 lines (67 loc) · 4.33 KB

WORKSHOP.md

File metadata and controls

95 lines (67 loc) · 4.33 KB
Raw

Media Services Application Mapper (MSAM)

This workshop guides the user through basic understanding of MSAM including installation, configuration, tuning, and resource monitoring.

Workshop Agenda (re:Invent 2019)

  • Overview of Media Services Application Mapper
  • Install MSAM into your AWS account using CloudFormation
  • MSAM browser application
    • First run!
    • Review navigation, searching, menus
    • Diagram management and layout
    • Tile management
  • CloudWatch Integration
    • Understand monitoring, alarms, pipeline alerts
    • Create a MediaLive pipeline alert

Part 1: Tool Overview

  • Learn the two main uses for MSAM (visualization, monitoring)
  • Learn how MSAM represents Media resources in the cloud, and how sets of resources are presented
  • Learn how resources are monitored with MSAM using CloudWatch

Review FEATURES

Part 2: Install MSAM

  • MSAM uses CloudFormation for installation and updates
  • Install all four MSAM templates into the same region
  • Be aware of the Input Parameters and Output subsections for each template

After installing the DynamoDB stack (Template 1), you can install the remaining stacks (Templates 2, 3, and 4) concurrently. There is no need to wait for each to finish before starting the next.

  • Use the same region where your Media Services workflow is running
  • Retrieve the API key for browser access

Navigate to the Install document and follow the instructions to install all four MSAM CloudFormation templates into your AWS account.

Part 3: Browser Application

Essential Diagram and Tile Usage

  1. Navigate to the Usage document
  2. Read and follow the First Run instructions
  3. Practice navigation, layout, and search
  4. Create one or more tiles

Part 4: CloudWatch Alarms and Event Integration

MSAM integrates with CloudWatch alarms and MediaLive pipeline alerts, and can visually indicate alarm or alert conditions on diagram nodes.

  1. Navigate to the Usage document
  2. Review and configure CloudWatch alert and alarm subscriptions
  3. Learn about MediaLive pipeline alerts

Create a pipeline alert

Pause one of your pipelines to trigger a pipeline alert on your MediaLive channel.

  1. Navigate to the MediaLive console.
  2. Click on your channel.
  3. From the Schedule tab, click on Create button.
  4. Provide an action name like Pause.
  5. Leave the Start Type as Fixed.
  6. Provide a UTC time that’s at least 15 seconds from current UTC time. You can look up current UTC time by going to sites like: https://time.is/UTC
  7. From Action Type dropdown, select Pause.
  8. Click on Add Pipelines button.
  9. From Pipelines Id dropdown, select PIPELINE_0.
  10. Click on Create button.
  11. Find the MediaLive Channel in MSAM.
  12. Wait for the pipeline alert to show on the MediaLive node. The alert should show up once the pause event gets triggered at the scheduled time.
  13. Select the channel and click the monitor tab to view the alert.

Clear the pipeline alert

  1. Navigate to the MediaLive console.
  2. Click on your channel.
  3. From the Schedule tab, click on Create button.
  4. Provide an action name like Unpause.
  5. Leave the Start Type as Fixed.
  6. Provide a UTC time that’s at least 15 seconds from current UTC time. You can look up current UTC time by going to sites like: https://time.is/UTC
  7. From Action Type dropdown, select Pause.
  8. Click on Create button.
  9. Find the MediaLive Channel in MSAM.
  10. Wait for the pipeline alert to clear on the MediaLive node. The alert should clear up once the pause event gets triggered at the scheduled time.

Removal and Clean Up

When you are finished using MSAM and will no longer need it, proceed to the Uninstall document and follow the instructions.

Navigate

Navigate to README | Architecture | Install | Usage | Uninstall | Rest API | Contributing