Pryon Environment Control

EC2 Instance Management

Sign In

Activity Log

Auto-refreshes every 30 seconds

Documentation

Pryon Environment Control — Feature Reference

Overview

The Pryon Environment Control dashboard provides a web interface for managing EC2 instances across AWS environments. It allows authorized users to start, stop, and schedule shutdown policies for groups of instances organized by environment tags.

Authentication

Sign In

Credentials are stored securely in AWS Systems Manager Parameter Store under the /pryon/dashboard/credentials path. Each parameter name is a username and its value is the password.

  • Enter your username and password on the login screen.
  • Sessions are stored in the browser's session storage and persist until you close the tab or click Logout.
  • All API requests are authenticated — credentials are verified on every call.

Environment Tabs

What are Tabs?

Tabs represent groups of EC2 instances that share an Environment tag (e.g., Production, Staging, Dev). Only instances that also have the Project=Pryon tag are included.

Adding a Tab +

Click the + button in the tab bar to add a new environment tab.

  1. The app discovers available environments by scanning EC2 instance tags in your AWS account.
  2. Select an environment from the dropdown.
  3. Give it a friendly label (e.g., "OpenShift Cluster" or "Test Env").
  4. Each environment can only have one tab — duplicates are prevented.

Tab configuration is stored in DynamoDB so it persists across sessions and users.

Removing a Tab

When viewing a specific tab, click Remove Tab to delete it. This only removes the tab from the dashboard — it does not affect the EC2 instances themselves.

The "All" Tab

The All tab displays every environment simultaneously. The Start All and Stop All buttons on this view act across all configured environments sequentially.

Instance Management

Starting Instances Start All

Click Start All to start every stopped instance in the selected environment. Instances that are already running or in a transitional state are skipped.

Stopping Instances Stop All

Click Stop All to stop every running instance in the selected environment. Instances in other states are skipped.

Individual Instance Control

Each instance row has an action button in the Actions column:

  • Start — Appears for stopped instances. Click to start that specific instance.
  • Stop — Appears for running instances. Click to stop that specific instance.

Instances in transitional states (pending, stopping) do not show action buttons until they reach a stable state.

Instance Details

Each instance row shows:

  • Name — The instance's Name tag (or Instance ID if unnamed).
  • Instance ID — The AWS EC2 instance identifier.
  • Type — The instance type (e.g., t3.medium, g4dn.xlarge).
  • State — Current state: running, stopped, pending, or stopping.
  • Schedule — The instance's shutdown schedule tag.
  • Actions — Start or Stop button for individual instance control.

Shutdown Schedules

Setting a Schedule

Each environment tab includes a schedule control bar. Select a schedule type and click Apply to tag all instances in that environment with the chosen schedule.

  • Daily — Running instances are automatically stopped every day at 5:00 PM EST (10:00 PM UTC).
  • Weekly — Running instances are automatically stopped every Friday at 5:00 PM EST (10:00 PM UTC). Instances are left running Monday through Thursday.
  • None — Removes the shutdown schedule. Instances will not be automatically stopped and will run indefinitely until manually stopped.

Schedules are implemented via the Shutdown EC2 tag. An automated resource cleanup Lambda runs on an EventBridge schedule every day at 5:00 PM EST, reads the Shutdown tag on each instance, and stops those that match the current cadence. There is no automatic start — instances must be started manually via the Start All button.

Activity Log

Monitoring Actions

The activity log at the bottom of the dashboard records all actions taken during the current session, including:

  • Authentication events
  • Start and stop operations (bulk and individual instances)
  • Tab creation and removal
  • Schedule changes
  • Errors and failures

The log is session-only and clears on page reload. Use the Clear button to reset it manually.

Auto-Refresh

Automatic Updates

The dashboard automatically refreshes instance data every 30 seconds. This keeps the displayed states current as instances transition between states (e.g., from pending to running). You can also click Refresh at any time for an immediate update.

Requirements

EC2 Instance Tags

For instances to appear in this dashboard, they must have both of these tags:

  • Project = Pryon
  • Environment = a value matching the tab's environment (e.g., Production)

Only instances in running, stopped, pending, or stopping states are shown. Terminated instances are excluded.