stratumctl admin observability

Install-scope observability settings

stratumctl admin observability [flags]

Subcommands

• stratumctl admin observability operator-webhook: Show, set or clear the URL Platform Health alarms notify

stratumctl admin observability operator-webhook

Show, set or clear the URL Platform Health alarms notify

stratumctl admin observability operator-webhook [flags]

The operator webhook is where every Platform Health pack alarm is delivered. It is stored once per cluster in OpenBao; every control plane reads it on its next pack pass, so setting a new one rotates it without a restart.

A control plane started with STRATUM_OBSERVABILITY_OPERATOR_WEBHOOK_URL uses that instead (source “env”); the stored copy is still written, and takes effect once the override is removed.

stratumctl admin observability operator-webhook get
printf '%s\n' "$URL" | stratumctl admin observability operator-webhook set --url-stdin
printf '%s\nAuthorization: Bearer %s\n' "$URL" "$TOKEN" | stratumctl admin observability operator-webhook set --url-stdin
stratumctl admin observability operator-webhook clear

Subcommands

• stratumctl admin observability operator-webhook clear: Delete the stored operator webhook
• stratumctl admin observability operator-webhook get: Show whether the operator webhook is set, its source, and the URL redacted
• stratumctl admin observability operator-webhook set: Set or rotate the operator webhook (read the URL from stdin with –url-stdin)

stratumctl admin observability operator-webhook clear

Delete the stored operator webhook

stratumctl admin observability operator-webhook clear [flags]

Deletes the stored operator webhook. Idempotent.

The pack stops re-seeding its operator channel, but the channel already seeded keeps its last URL, so alarms are still delivered there until a new URL is set. A control plane’s STRATUM_OBSERVABILITY_OPERATOR_WEBHOOK_URL override is not affected.

Examples

stratumctl admin observability operator-webhook clear

stratumctl admin observability operator-webhook get

Show whether the operator webhook is set, its source, and the URL redacted

stratumctl admin observability operator-webhook get [flags]

Examples

stratumctl admin observability operator-webhook get
stratumctl admin observability operator-webhook get --output json

stratumctl admin observability operator-webhook set

Set or rotate the operator webhook (read the URL from stdin with –url-stdin)

stratumctl admin observability operator-webhook set [flags]

Stores the operator webhook URL, and the request headers sent with it, in OpenBao for every control plane. Each set replaces both: a set without headers stores none.

Prefer –url-stdin, which reads the URL from the first line of stdin so the secret stays out of shell history and the process list. Every further non-empty line is a request header, “Name: value”, which is where a token belongs rather than in the URL:

printf '%s\n' "$URL" | stratumctl admin observability operator-webhook set --url-stdin
printf '%s\nAuthorization: Bearer %s\n' "$URL" "$TOKEN" | \
  stratumctl admin observability operator-webhook set --url-stdin

–header “Name: value” (repeatable) adds a header from the command line, for values that are not secret (an ntfy X-Title or X-Priority, say). –url works, but the URL lands in your shell history.

Examples

printf '%s\n' "$URL" | stratumctl admin observability operator-webhook set --url-stdin
printf '%s\n' "$URL" | stratumctl admin observability operator-webhook set --url-stdin --header "X-Env: lab"

Flags

Flag	Type	Default	Description
--header	stringArray		a request header “Name: value” (repeatable; not for secrets, use stdin)
--url	string		the URL itself (lands in shell history; prefer –url-stdin)
--url-stdin	bool	false	read the URL from the first line of stdin (recommended)