WayseerUser guideWayseer 0.28.3Contents
Wayseer user guide
Wayseer shows what your systems are doing as one world you can move through: hosts, services, databases, their links, their metrics and their events, gathered from data-source modules. It reads, and changes nothing unless you allow an action and confirm it.
Start with Install and first run, then take the first ten minutes on the demo world.
Keys are written as on Linux and Windows. On a Mac, Cmd takes the place of Ctrl, so Ctrl+K is ⌘K; Keys shows both forms of every default.
Getting started
- Install and first run
- Install it, run it, and open the demo world.
- Installing on Linux
- The AppImage, tarball, Flatpak and Nix packages.
- Installing on macOS
- The app, and opening a build Apple has not notarized.
- Installing on Windows
- The installer and the portable zip.
- The first ten minutes
- Find a hot host, read an incident, filter, bookmark and ask, on the demo world.
- Configuration
- The config file, where it lives, and how secrets are kept out of it.
Using Wayseer
- Lenses
- Topology, Timeline, Grid, Stream, Detail, Treemap, Compare and Flow, and moving around them.
- Palette and filter
- Finding entities, running commands, and the filter syntax.
- Time and bookmarks
- The time window, going live, history and bookmarks.
- Windows
- More than one window on the same world, and what each keeps.
- What changed
- What the status bar says changed while you looked elsewhere.
- Language model
- Asking questions with
?, providers and what is sent. - Actions
- What a module may change, how you allow it, and the action log.
Keys and releases
- License and keys
- What is free, what a key unlocks, and how keys are checked.
- Newer releases
- The quiet notice of a newer release, and whether your key covers it.
Modules
- Files
- Entities, metrics and events from CSV and JSON files.
- This machine
- The host Wayseer runs on, its processes, systemd units and journal.
- Prometheus
- Scrape targets and their metrics, with Alertmanager's alerts.
- Recipes
- MySQL, Redis, MongoDB, Kafka and Netdata through their Prometheus exporters, with no module of their own.
- Kubernetes
- A cluster's nodes, workloads and services.
- Proxmox VE
- A cluster's nodes, guests and storage, through an API token; it starts, shuts down and reboots guests where you allow it.
- SQL databases
- A SQLite or Postgres schema, with your own queries as metrics and events.
- Wayseer itself
- Its own health and every module's state.
- External modules
- Running a module as a program of its own.
Reference
- Keys
- Every default key, with its macOS form. Generated.
- Control
- Driving the app from a script or an AI agent on the same machine, including over MCP.
- Commands
- Every command, its keys and parameters. Generated.
Reporting a problem
Report a bug or ask for a feature in the public tracker, wayseer-net/desktop-issues; wayseer --help ends with the same link. Include wayseer --version, your system, and what you did and saw. Leave out license keys, tokens and passwords, and anything else private: the tracker is public. Questions that should stay private go to [email protected].