← Back to Skills Marketplace
chengcecho

aws-SkyRoute

by chengcecho · GitHub ↗ · v1.0.1 · MIT-0
cross-platform ⚠ pending
40
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install aws-skyroute
Description
3D globe visualization of global traffic flowing to AWS regions. Shows real-time user connections with latency-colored arcs, CloudFront edge node panels, P95...
README (SKILL.md)

SkyRoute — 3D Global Traffic Monitor

A self-contained HTML/WebGL dashboard that renders a 3D globe showing real-time traffic connections from users worldwide to your AWS backend region.

Features

  • 3D Globe with country polygons (no external textures — pure geometry)
  • Animated arcs from user locations to target region, color-coded by latency (green \x3C 100ms, yellow \x3C 300ms, red > 300ms)
  • CloudFront edge panel showing top PoPs by request volume
  • Metrics panel: active connections, RPS, P95/P99 latency, error rate
  • Alert mode: header flashes red when error rate spikes, with alert badge
  • Sparkline trends for latency/RPS history
  • Country name mapping (CC → Chinese name)

Files

  • assets/globe.html — Complete standalone dashboard (Three.js + custom shaders via CDN)

Usage

Static demo

Open assets/globe.html directly in a browser. It includes a mock data generator that simulates global traffic.

With real data

To connect real data, modify the generateConnections() function in the HTML to fetch from your data source. Expected data format per connection:

{
  "lat": 51.5,
  "lng": -0.12,
  "latency": 85,
  "country": "GB",
  "requests": 1200
}

Data sources (integration ideas)

  1. ALB access logs → parse source IPs → GeoIP lookup → aggregate by region
  2. CloudFront real-time logs → Kinesis → Lambda → WebSocket push
  3. Custom metrics API → poll every 5s from your monitoring backend

GeoIP Setup

For production use, obtain MaxMind GeoLite2-City database:

  1. Register at https://www.maxmind.com/en/geolite2/signup
  2. Download GeoLite2-City.mmdb
  3. Use with a backend service to resolve IP → lat/lng

Customization

Config Location Description
Target region TARGET_REGION const AWS region coordinates (default: us-west-2)
Color thresholds getArcColor() Latency → color mapping
Alert threshold ERROR_THRESHOLD Error rate % to trigger alert mode
Panel layout CSS .panel classes Reposition info panels
Country names CC_NAMES object ISO code → display name mapping

Deployment

Serve as a static file behind any web server or embed in an internal dashboard (Grafana iframe, TV display, etc.). No backend required for the visualization itself — all rendering is client-side WebGL.

Capability Tags
crypto
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install aws-skyroute
  3. After installation, invoke the skill by name or use /aws-skyroute
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
Version 1.0.1 — No file or documentation changes detected. - No changes made in this version; all features, usage, and documentation remain the same.
v1.0.0
SkyRoute 1.0.0 — Initial Release - Adds 3D globe visualization of global traffic flowing to AWS regions. - Visualizes real-time user connections with latency-colored arcs (green/yellow/red). - Includes CloudFront edge node panels showing top PoPs by request volume. - Displays real-time metrics: active connections, RPS, P95/P99 latency, error rate. - Alert mode highlights traffic spikes with flashing header and badge. - Shows sparkline trends for latency and RPS. - Supports static demo with mock data and easy integration with real data sources.
Metadata
Slug aws-skyroute
Version 1.0.1
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 2
Frequently Asked Questions

What is aws-SkyRoute?

3D globe visualization of global traffic flowing to AWS regions. Shows real-time user connections with latency-colored arcs, CloudFront edge node panels, P95... It is an AI Agent Skill for Claude Code / OpenClaw, with 40 downloads so far.

How do I install aws-SkyRoute?

Run "/install aws-skyroute" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is aws-SkyRoute free?

Yes, aws-SkyRoute is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does aws-SkyRoute support?

aws-SkyRoute is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created aws-SkyRoute?

It is built and maintained by chengcecho (@chengcecho); the current version is v1.0.1.

💬 Comments