mirror of https://github.com/pezkuwichain/pezkuwi-telemetry.git synced 2026-04-21 23:47:58 +00:00

Files

T

pezkuwichain 2b1872f24e Rebrand to Pezkuwichain Telemetry

- Rename PolkadotIcon to PezkuwiIcon
- Update pinned chains for Pezkuwichain
- Add pezkuwichain, bizinikiwi, pezkuwichain-js icons
- Update favicon with Pezkuwi branding
- Update package.json author to Dijital Kurdistan Tech Institute
- Update GitHub links to pezkuwichain/pezkuwi-telemetry
- Update backend Cargo.toml authors
- Rewrite README with Pezkuwichain documentation
- Add GitHub workflows (frontend-ci, backend-ci, docker, lock)

2026-01-08 16:40:51 +03:00

2.6 KiB

Raw Permalink Blame History

Pezkuwichain Telemetry

Overview

This repository contains the Telemetry server for Pezkuwichain nodes. It includes:

Backend: Rust-based ingestion server (telemetry_shard and telemetry_core)
Frontend: React/TypeScript dashboard for monitoring network nodes

Pezkuwichain nodes can connect to Telemetry using the --telemetry-url flag.

Messages

Nodes send telemetry messages depending on the verbosity level:

Verbosity 0 (default):

system.connected
system.interval
block.import
notify.finalized

Verbosity 1 (includes validator address):

afg.authority_set

Getting Started

Prerequisites

Rust (via rustup): https://rustup.rs/
Node.js (LTS version)

Backend

cd backend
cargo build --release

# Terminal 1 - Core server
./target/release/telemetry_core

# Terminal 2 - Shard server
./target/release/telemetry_shard

Default ports:

telemetry_core: 127.0.0.1:8000
telemetry_shard: 127.0.0.1:8001

Frontend

cd frontend
npm install
npm run start

Access the UI at http://localhost:3000

Connect a Node

pezkuwi --dev --telemetry-url 'ws://localhost:8001/submit 0'

Note: The "0" is the verbosity level (0-9).

Docker

Build Images

# Backend
cd backend
docker build -t pezkuwichain/telemetry-backend .

# Frontend
cd frontend
docker build -t pezkuwichain/telemetry-frontend .

Docker Compose

docker-compose up

Manual Docker Setup

# Create network
docker network create telemetry

# Backend core
docker run -d --network=telemetry --name backend-core \
  -p 8000:8000 --read-only \
  pezkuwichain/telemetry-backend \
  telemetry_core -l 0.0.0.0:8000

# Backend shard
docker run -d --network=telemetry --name backend-shard \
  -p 8001:8001 --read-only \
  pezkuwichain/telemetry-backend \
  telemetry_shard -l 0.0.0.0:8001 -c http://backend-core:8000/shard_submit

# Frontend
docker run -d --network=telemetry --name frontend \
  -p 3000:8000 \
  -e SUBSTRATE_TELEMETRY_URL=ws://localhost:8000/feed \
  pezkuwichain/telemetry-frontend

Configuration

Environment Variables

Variable	Description	Default
`SUBSTRATE_TELEMETRY_URL`	WebSocket URL for frontend to connect	`ws://localhost:8000/feed`

License

GPL-3.0

Credits

Based on substrate-telemetry by Parity Technologies.

Maintained by Dijital Kurdistan Tech Institute.

2.6 KiB Raw Permalink Blame History