ECScope

Deep visibility into your AWS ECS clusters

ECScope is a modern, cross-platform desktop application for exploring, monitoring, and managing your Amazon ECS infrastructure. It gives you a clear, real-time view of your clusters, services, tasks, load balancers, nodes, and databases — all in one place.

✨ Features

• Cluster Explorer — Browse and connect to multiple clusters with group/color/icon customization
• Service Viewer — Monitor status, CPU & memory usage; one-click scale up/down, force deploy, autoscaling controls
• Task Inspector — View task details, container health, environment variables & secrets; ECS exec shell, live container logs, HTTP traffic capture
• CloudWatch Logs Viewer — Tail and filter awslogs logs per task (Fargate & EC2, running or stopped) or across a whole service
• Stopped Task Insights — Stop code, stopped reason, and per-container exit codes with hints (OOM kill, SIGTERM, segfault…)
• Task Definition Editor — Edit task definitions as JSON with validation and one-click deploy
• Task Definition Diff — Compare any two revisions of a family (or an active deployment against the primary one)
• Scheduled Tasks — EventBridge rules and EventBridge Scheduler schedules targeting the cluster: enable/disable, run now
• Secret Management — View and edit secret values in Secrets Manager, redeploy on change
• ALB / NLB Viewer — Inspect load balancers, target groups, health checks, and request/latency/error metrics
• Node Viewer — EC2 container instances, SSM terminal, SFTP file transfer, ASG scaling controls
• EC2 / RDS Dashboard — VPC-filtered EC2 and RDS instances with CloudWatch metrics
• Deployment Management — View deployment history with rollback capability
• Metrics Charting — CloudWatch metrics with configurable time ranges (service, ALB, NLB, EC2, RDS)
• Auto-Update — Checks for new versions and notifies in sidebar
• i18n — English and English with emoji status prefixes

🚀 Getting Started

Prerequisites

Tool	Install
AWS CLI	msiexec.exe /i https://awscli.amazonaws.com/AWSCLIV2.msi
SSM Plugin	winget install Amazon.SessionManagerPlugin

You need an AWS profile in ~/.aws/config / ~/.aws/credentials. Supported profile types:

• Static access keys (optionally with aws_session_token)
• STS role assumption (role_arn + source_profile)
• Anything else the AWS CLI understands — IAM Identity Center / SSO (sso_session, sso_start_url), credential_process, credential_source, web identity, chained roles — resolved through aws configure export-credentials (AWS CLI v2.9+). When an SSO session is missing or expired, ECScope offers a Sign in with AWS SSO button that runs aws sso login.

Temporary credentials are refreshed automatically before they expire.

IAM permissions

On top of read access to ECS, EC2, ELBv2, RDS, CloudWatch, SSM and Secrets Manager, the newer features use:

Feature	Actions
CloudWatch Logs viewer	logs:GetLogEvents, logs:FilterLogEvents
Task definition diff	ecs:ListTaskDefinitions, ecs:DescribeTaskDefinition
Scheduled tasks (list)	ecs:DescribeClusters, events:ListRuleNamesByTarget, events:DescribeRule, events:ListTargetsByRule, scheduler:ListSchedules, scheduler:GetSchedule
Scheduled tasks (actions)	events:EnableRule, events:DisableRule, scheduler:UpdateSchedule, ecs:RunTask, iam:PassRole (task/execution roles)

Installation

Download the latest release from the Releases page (Windows NSIS/MSI, macOS DMG, Linux DEB/AppImage/RPM).

Configuration

Create an ecscope.config.json file next to the executable (or in the current working directory):

{
    "refreshPeriodSeconds": 10,
    "theme": "dark",
    "language": "en",
    "updateUrl": "https://raw.githubusercontent.com/o0Zz/ECScope/main/latest.json",
    "clusters": [
        {
            "profile": "my-profile1",
            "region": "eu-west-1",
            "clusterName": "my-cluster",
            "color": "0000ff",
            "group": "Production",
            "icon": "🚀"
        }
    ]
}

Global configuration

Field	Description
refreshPeriodSeconds	Polling interval for data refresh (seconds)
theme	dark or light
language	Locale code: en or en-emoji
updateUrl	URL to latest.json for auto-update checks (optional)

Cluster configuration

Field	Description
profile	AWS profile name matching a [profile] entry in ~/.aws/config
region	AWS region of the cluster
clusterName	Name of the ECS cluster as shown in the AWS console
color	Hex color code for sidebar display (optional)
group	Group name for organizing clusters in sidebar (optional)
icon	Emoji or text icon displayed next to cluster name (optional)

🚀 Development

Prerequisites

Tool	Install
Node.js 22+	https://nodejs.org/en/download
Rust (stable)	https://rustup.rs/

Build for development

git clone https://github.com/o0Zz/ECScope.git
cd ECScope
npm ci
npx tauri dev

Build for production

npx tauri build

Fix ESLint

npm run lint:fix

📁 Project Structure

src/
├── api/            # AWS SDK clients and domain API modules
├── components/     # Shared UI components (charts, dialogs, badges)
├── config/         # AWS credentials (with STS role assumption) and app configuration
├── features/       # Feature modules (services, tasks, albnlb, nodes, ec2rds, welcome)
├── i18n/           # Internationalization (en, en-emoji)
├── layout/         # App shell (sidebar, tabs, breadcrumb)
├── lib/            # Utilities, formatters, logger, update checker
└── store/          # Zustand state stores (config, navigation)
src-tauri/          # Tauri/Rust backend (config, SSM, ECS exec, SFTP)