Wayseer

Marketplace.

Every module Wayseer runs: the ones built into the app, and modules from others, built by Wayseer from their public source and signed. A module from others runs as a program of its own beside the app, and does only what its signed manifest declares.

To run a module from others:

  1. A license key that covers modules from others, for a release it covers: see pricing. Without one, a module's program never starts.
  2. Get it with >modules.get id= and its id. Wayseer downloads the package for your platform, checks its signature and that it hasn't been withdrawn, shows what it declares, and installs it on Y (getting a module). Each module's page also has its packages, for >modules.install.
  3. Name it in your config, as a source of kind: external with its id as module (configuration). A config that names a module that isn't installed still loads, and Wayseer offers to get it when it opens (missing modules).
  4. Updates: when a newer version is out, >updates.show lists what its manifest adds and drops, and >modules.update installs it only when you press Y (updates).

Wayseer builds each version twice from its tagged source, checks the two match byte for byte, and runs it through the conformance suite before signing it. That says where a module came from, not that Wayseer vouches for what it does: its publisher's own license applies (license, section 5). To write one of your own, see wayseer.dev.

Built into Wayseer 0.30.0

In every download, with nothing to install: name one in your config by its kind. Each is Wayseer's own, and the user guide covers it in full.

Docker and Podman kind: docker free

The docker module reads a Docker engine, or Podman through its Docker-compatible API: the engine's host, its containers, images, networks and volumes, and compose projects with their services. Running containers have CPU, memory, network and disk series, and the engine's events (a container starting, exiting, running out of memory, changing health or restarting) show as they happen. It only reads, and needs no license key.

Files kind: file free

The file module reads CSV and JSON files and turns their records into entities, links, metrics and events, as a mapping in the config says. Use it for an inventory kept in a spreadsheet, an export from another tool, or a recording. It reads the files again when they change. The demo world is made this way.

Kubernetes kind: kubernetes

The kubernetes module shows a cluster as nodes, namespaces, pods, services, deployments and replica sets, linked the way the cluster links them. It reads, and changes nothing unless you allow one of its actions and confirm it.

Prometheus kind: prometheus free

The prometheus module shows what a Prometheus server scrapes: each scrape target, grouped by job, on the hosts named by their instance labels. Every metric the server describes can be charted. With an Alertmanager, firing alerts show on the entities they are about. It reads through the HTTP API, and changes nothing unless you allow it to silence alerts.

Proxmox VE kind: proxmox free

The proxmox module reads a Proxmox VE cluster through its API, with an API token: the cluster, its nodes, the virtual machines and containers on them, and its storage. It only reads, unless you allow its actions, and needs no license key.

SQL databases kind: sql

The sql module shows a SQLite or Postgres database as its schemas and tables, with foreign keys as links between tables. It can also run queries you write, on an interval, and show their results as metrics or as events. It only reads. Every statement runs in a read-only transaction, so it cannot change the database.

This machine kind: localhost free

The localhost module shows the machine Wayseer runs on: the host, its CPUs, memory, disks, filesystems, network interfaces and processes, with metrics for each. Where the machine runs systemd, it adds the system units with their dependencies, and journal entries as events; on Windows, it adds the services. On Linux it reads /proc, /sys, systemd over D-Bus, and journalctl; on macOS, the system's own counters (below); on Windows, its own calls (below). It needs no privileges and changes nothing. It runs on Linux and macOS, and on Windows from 0.28.0.

Wayseer itself kind: internal free

The internal module shows Wayseer's own health: how fast it draws, how much memory it holds, its event bus, the state of every other module, and its log. It is in the default config, and it always has something to show, so a new config is never empty.

From others

Built by Wayseer from their publishers' public source, and signed. Each page says what the module may do, how to configure it, and where to download it.

Aircraft module: wayseer-labs/aircraft

Live aircraft from ADS-B, read from adsb.lol or a local readsb or dump1090 receiver.

BGP (RIS Live) module: wayseer-labs/bgp

Live BGP routing for watched prefixes and ASes, from RIPE RIS Live.

Internet outages module: wayseer-labs/outages

Internet outages from IODA (Georgia Tech) for countries, regions and networks.

Inventory module: wayseer-labs/inventory

Entities read from a JSON inventory at a URL.