aws-SkyRoute
/install aws-skyroute
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)
- ALB access logs → parse source IPs → GeoIP lookup → aggregate by region
- CloudFront real-time logs → Kinesis → Lambda → WebSocket push
- Custom metrics API → poll every 5s from your monitoring backend
GeoIP Setup
For production use, obtain MaxMind GeoLite2-City database:
- Register at https://www.maxmind.com/en/geolite2/signup
- Download GeoLite2-City.mmdb
- 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.
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install aws-skyroute - 安装完成后,直接呼叫该 Skill 的名称或使用
/aws-skyroute触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
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... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 40 次。
如何安装 aws-SkyRoute?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install aws-skyroute」即可一键安装,无需额外配置。
aws-SkyRoute 是免费的吗?
是的,aws-SkyRoute 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
aws-SkyRoute 支持哪些平台?
aws-SkyRoute 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 aws-SkyRoute?
由 chengcecho(@chengcecho)开发并维护,当前版本 v1.0.1。