HYPHAby S33D
Documentation › Alert and act

Outage explanation and one-click repair

HYPHA tells you what is happening, the probable cause and its evidence, the fix. When the fix is a known action, it proposes it: a human approves, the agent runs it.

An alert explained, a repair proposed · 27 s
What the video shows
  1. The Problems view: four current alerts, sorted by priority.
  2. The Explain button of the "systemd unit failed" alert: shop-worker.service on web-01.
  3. The explanation panel: the service killed by memory exhaustion, the log lines that prove it, the fix. The wait for the analysis is cut.
  4. The proposed action, "Restart shop-worker.service on web-01", to approve in one click.

Explain

The Explain button sits on an alert (Problems view, overview, monitors), on a host page, on a log line's details, on a trace and on an application error.

HYPHA then gathers, within the workspace and for the object concerned:

The model answers in four parts: What is happening, Probable cause (with its evidence: a log line, a measured value), Fix (commands for the host's system), Preventing it. It must not make anything up; if the evidence is not enough, it says so and states what to check. The panel also shows the model used, the duration and the context read.

Where the model runs

Limit: 60 explanations per hour per workspace; the monthly number depends on the plan (see pricing).

Repair in one click

HYPHA reads the Fix part again. If it finds an action it knows (systemctl restart|start|stop <unit>, Restart-Service <service>, service <name> restart), it proposes it as a button, for example "Restart shop-worker.service on web-01", on two conditions: the host's agent accepts that action, and the unit or service exists on the host.

  1. A click opens a confirmation: action, host, reason.
  2. If you are an administrator, the action is created and approved in the same step. Otherwise, it waits for an administrator's approval in Settings › Actions.
  3. The agent receives it through its control channel, checks that it is allowed, runs it, then returns the exit code and the output.
  4. Follow-up is live: pending, sent, running, succeeded or failed. The agent sends the unit's state right away.

An unapproved action expires after one hour; an approved action that the agent has not picked up expires after 10 minutes. Everything goes to the audit log.

What the agent accepts

Actions are off by default. On each host, you decide:

actions:
  enabled: true
  allow: [restart_service, start_service]        # allowed actions
  services: ["nginx*", "shop-*"]                 # targeted units or services
  deny_services: ["sshd*", "ssh*", "hypha-agent*", "systemd-*"]
  scripts:
    clear-cache: /etc/hypha/scripts/clear-cache.sh
  timeout: 120s

An action can also be proposed by hand, through the proposal form (action, unit or script, reason) or the API. History and pending actions are in Settings › Actions.

Updated: 19 November 2026