TTOAD

remigirard.dev · monitoring handbook

Monitor without
guessing.

Start with the symptom, gather read-only evidence, and use the interface that answers the next question. Grafana shows the overview and logs, Prometheus provides exact metrics, Alertmanager records action, and Traefik explains the live request path.

This guide is public. Administrative tools still require your mTLS operator certificate.

The 60-second health check

Know what “healthy” means before debugging.

A green dashboard alone is not proof. These four signals cover the declared service, its public path, current alerts, and the freshness of the evidence.

WorkloadDesired = running

Every declared service has its requested replicas and its update is completed.

Public pathHTTPS probe = 1

The external probe reaches the real hostname with a valid certificate and expected response.

ActionNo unexplained alerts

Alertmanager has no firing alert without a known owner, cause, or response.

EvidenceMetrics are recent

Prometheus targets are up and timestamps follow the current server time.

Open the right interface

Each tool answers a different question.

When something looks wrong

Follow one short evidence path.

01Confirm the public symptom

Use the real HTTPS address and note time, status, and affected route.

02Diagnose the declared app

Compare desired replicas, running tasks, update state, and endpoint checks.

03Read recent logs

Open Grafana Explore, select Loki, and find the first service error around the observed timestamp.

04Correlate metrics and alerts

Check whether the failure is application, capacity, host, or network related.

05Inspect routing last

Use Traefik when the task is healthy but the hostname or certificate path is not.

Same evidence from the repository

The dashboards do not replace declared operations.

Read-only first

Run diagnosis before changing anything. TOAD reports the application contract, Swarm convergence, failed tasks, and public checks without exposing credentials.

Use the full verifier for platform-wide DNS, TLS, mTLS, monitoring, quorum, image, and replica evidence.

cd openstackV3
pnpm run app -- diagnose NAME --json
pnpm run app -- logs NAME
pnpm run verify -- STACK --json
pnpm run maintenance -- status --json

Administrative boundary

Public explanation, private control plane.

Browser access

Import the operator PKCS #12 identity into your browser or operating-system certificate store. Select it when opening an administrative hostname. Issue separate identities for separate people or devices.

Expected rejection

A browser without the client certificate should be rejected before Grafana, Prometheus, Alertmanager, or Traefik can respond. There is no shared dashboard password.

Open the public routing proof →