Skip to content
SHC Docs

A node for the observability app

The pages of this ladder read the node the app ladder’s pages 00 to 07 left running: home01, tenant prod, and the deployments web, db, pgweb, placed, store and cloud. Start here with that node running.

shc init skipped one module on home01: openobserve needs 3 CPUs and home01 has 2. OpenObserve is where metrics and logs land, so this ladder adds a second machine that can hold it. Prepare a Debian 13 machine named obs01 with 4 CPUs and 8 GB of memory, SHC installed and a root shell, the way home01 was prepared. It must reach home01, and root on it must be able to ssh home01 with a key and no prompt: the join reads its token from home01 that way. It joins location home.

obs01
$ ssh home01 shc node token --fields token -o text | shc node join - --name obs01 --cloud learn --location home
✔ joined cluster as node "obs01" at 167.233.221.15
home01
$ shc node ls
NAME STATE CONDITION AVAIL CLOUD LOCATION ROOM BUILD LEADER VOTER
home01 healthy ready active learn learn/home ok 0.1.0 yes yes
obs01 healthy ready active learn learn/home ok 0.1.0 no no

OpenObserve mints its own admin password unless one is set. Set it to the example password before the install, as a config row on the module’s variables, so the metrics page can sign in with it. The admin user is [email protected]; the daemon fixes it, so there is no row to set for it.

home01
$ shc config set modules.openobserve.vars.password P@ssw0rd
KEY VALUE SCOPE
modules.openobserve.vars.password *** global

shc cluster reconcile installs the modules init deferred. It measures every node of the cluster and installs each deferral on a node that fits it, so typed on home01 it lands OpenObserve on obs01. The modules already running are left alone.

home01
$ shc cluster reconcile
...
home01
$ shc ls -t master
STACK TENANT ENV APP STATUS NODES
keycloak master default keycloak running home01
openobserve master default openobserve running obs01
postgres master default postgres running home01
traefik master default traefik running home01, obs01

The follow modes of shc events and shc logs run inside tmux on home01, so a screen can be read while something else changes it. Install it now.

home01
$ apt-get install -y tmux
...
$ tmux -V
tmux 3.5a

This page leaves obs01 in the cluster, openobserve running in master on it with admin [email protected] and password P@ssw0rd, and tmux on home01.

Next: Status.