Skip to content

Machines

Every machine running the Valet agent, from one block of config. This shows each machine with whether it answers, CPU, memory, disk, temperature and what’s wrong, each one’s own card, and their containers, services and disks grouped by machine. A machine that’s down never holds up the rest. The assistant can say which machine is low on disk and read logs on any of them. The agent can only look.

config.yaml
integrations:
machines:
type: machines
hosts:
nas:
url: http://10.0.0.5:7576
token: x
name: NAS
quiet:
- zfs-scrub
pi:
url: http://10.0.0.6:7576
token: x
name: Pi
mini:
url: http://10.0.0.7:7576
token: x
name: Mini PC
layout:
- title: Infrastructure
widgets:
- machines.fleet
OptionTypeDefaultWhat it does
hostsmap of objectrequired
titlestringMachines
timeoutnumber4seconds a machine gets to answer before it’s shown as not reachable Range 1 to 30.

8 widgets. Each key starts with your instance name, here machines.

machines.fleet · status card · refreshes every 15 seconds while the page is open.

Machines, Machines, small size
Small
Machines, Machines, wide size
Wide
Machines, Machines, medium size
Medium
Machines, Machines, large size
Large
Machines, Machines, in chat
In chat

Tall draws the same as medium, so it isn't shown. Only the empty space changes.

Machines Machines: One machine not answering
One machine not answering
Machines Machines: A disk filling up
A disk filling up
Machines Machines: Can't reach it
Can't reach it

machines.overview · table card · refreshes every 15 seconds while the page is open.

Machines, Machines, small size
Small
Machines, Machines, wide size
Wide
Machines, Machines, medium size
Medium
Machines, Machines, large size
Large
Machines, Machines, in chat
In chat

Tall draws the same as medium, so it isn't shown. Only the empty space changes.

Machines Machines: Can't reach it
Can't reach it

machines.containers · status card · refreshes every 30 seconds while the page is open.

Machines, Containers, small size
Small
Machines, Containers, wide size
Wide
Machines, Containers, medium size
Medium
Machines, Containers, large size
Large
Machines, Containers, in chat
In chat

Tall draws the same as medium, so it isn't shown. Only the empty space changes.

Machines Containers: A container down
A container down
Machines Containers: Can't reach it
Can't reach it

machines.units · status card · refreshes every 30 seconds while the page is open.

Machines, Services, small size
Small
Machines, Services, wide size
Wide
Machines, Services, medium size
Medium
Machines, Services, large size
Large
Machines, Services, in chat
In chat

Tall draws the same as medium, so it isn't shown. Only the empty space changes.

Machines Services: Can't reach it
Can't reach it

machines.disks · list card · refreshes every minute while the page is open.

Machines, Disks, small size
Small
Machines, Disks, wide size
Wide
Machines, Disks, medium size
Medium
Machines, Disks, large size
Large
Machines, Disks, in chat
In chat

Tall draws the same as medium, so it isn't shown. Only the empty space changes.

Machines Disks: A disk filling up
A disk filling up
Machines Disks: Can't reach it
Can't reach it

machines.nas · stats card · refreshes every 15 seconds while the page is open.

Machines, NAS, small size
Small
Machines, NAS, wide size
Wide
Machines, NAS, medium size
Medium
Machines, NAS, large size
Large
Machines, NAS, in chat
In chat

Tall draws the same as medium, so it isn't shown. Only the empty space changes.

Machines NAS: Can't reach it
Can't reach it

machines.pi · stats card · refreshes every 15 seconds while the page is open.

Machines, Pi, small size
Small
Machines, Pi, wide size
Wide
Machines, Pi, medium size
Medium
Machines, Pi, large size
Large
Machines, Pi, in chat
In chat

Tall draws the same as medium, so it isn't shown. Only the empty space changes.

Machines Pi: Can't reach it
Can't reach it

machines.mini · stats card · refreshes every 15 seconds while the page is open.

Machines, Mini PC, small size
Small
Machines, Mini PC, wide size
Wide
Machines, Mini PC, medium size
Medium
Machines, Mini PC, large size
Large
Machines, Mini PC, in chat
In chat

Tall draws the same as medium, so it isn't shown. Only the empty space changes.

Machines Mini PC: Can't reach it
Can't reach it

What the assistant can use, once its access level allows it. Read tools run freely. Everything else asks first.

ToolAccessWhat it does
machines_statusreadEvery machine at once: whether it answers, CPU, memory, how full each disk is, temperature, load, uptime, and what’s wrong on it (a full disk, a service or container that’s down).
machine_statusreadOne machine in full: its system and kernel, processor, CPU, memory and swap, load, uptime, every disk and every temperature sensor it reports.
machines_runningreadThe containers and systemd services on one machine, or on all of them when no machine is named: running or not, how each exited, restarts.
machines_findreadFind a container or systemd service by name on any machine: which machine it’s on and how it is.
machine_logsreadThe recent logs of a container or systemd service on a machine, with how it last ended (exit code, restarts, whether it was killed for memory).

What to type in the palette to run it with no model. {name} is the instance’s name in your config; a number goes where a slot like {minutes} is. Commands follow the same access as the chat.

TypeDoes
machines, machines status, show machines, fleet, {name} statusShow the machines