NodeLink Status

NodeLink monitoring stack with a Discord bot, API, and dashboard. Designed for fast operational visibility with continuous updates and room for refinement.

Overview

Discord bot: posts ANSI cards with live node status.
API: exposes /api/stats for the dashboard.
Dashboard: web UI for metrics and charts.

Requirements

Node.js 18+ (recommended)
npm
A Discord bot token with permission to send messages
Accessible NodeLink nodes (HTTP/WS)

Project Structure

src/: bot, API, monitor
dashboard/: Vite + React UI
config.js: central configuration

Configuration

Edit config.js:

bot.token: Discord bot token
bot.channelId: target channel
bot.updateInterval: update interval (ms)
nodes: list of NodeLink instances
api.port: API port
attribution: dashboard footer text
brand.iconUrl: icon used in embeds

Example:

bot: {
  token: 'YOUR_TOKEN',
  channelId: 'CHANNEL_ID',
  updateInterval: 30000
}

Install

npm install

Run

This starts the bot, API, and the Vite dashboard:

node src/index.js

API

Main endpoint:

GET /api/stats

Response includes:

nodes with telemetry, uptime, memory, etc.
history with recent events
timestamp

Discord Bot

The bot posts:

Cluster summary card
Per-node ANSI cards

If an old Components V2 message exists, it’s removed and replaced with embeds.

Dashboard

Runs via Vite in dashboard/ and consumes:

http://localhost:4000/api/stats

Style entry points:

dashboard/src/index.css
dashboard/src/App.tsx

Refinement Tips

Performance: increase updateInterval or simplify data shown.
Visual: tweak colors and spacing in the dashboard.
Metrics: add new metrics in src/monitor/index.js and pass through the API.

Troubleshooting

Bot not updating: verify bot.token and bot.channelId.
Dashboard empty: confirm API is running on the correct port.
Metrics look wrong: verify /v4/metrics and /v4/stats are reachable.

License

ISC

NodeLinkstatus

Install / Use

README