HYPHAby S33D
Documentation › Observe

Logs

Every log of the fleet in one place, searched in one line, parsed and masked on arrival, with control over their volume.

Where logs come from

See log configuration.

Logs: search, filter, group · 29 s
What the video shows
  1. The Logs page and its histogram by status.
  2. The query status:error OR status:critical filters the lines; facets update.
  3. A line in detail: attributes, tags, context.
  4. The Patterns tab groups similar messages and counts them.
SyntaxEffect
timeout connectionlines containing both words (implicit AND, case-insensitive)
"exact phrase"the phrase as is
service:nginx, host:web-01, status:error, source:journaldfield equality; service:shop* for a prefix
@http.status_code:502attribute value
-service:sshdexclusion
status:error OR status:criticaleither one

Statuses: emergency, alert, critical, error, warning, notice, info, debug.

The page shows the histogram by status and the facets: status, service, host, source, and, when present, HTTP code and method. Clicking a value adds it to the query.

Parsing on arrival

HYPHA parses common formats into attributes, without overwriting an existing attribute:

An info line with an HTTP code of 500 or more becomes an error, 400 or more a warning. A more severe status already set is never lowered.

Exclusion filters and sampling

Access logs and health probes often make up most of the volume. Settings › Logs shows volume by service and by host, and sets filters applied on arrival, before writing:

From the Logs page, Exclude these lines pre-fills a filter with the current query. Dropped lines do not count in your usage.

Masking sensitive data

Applied on arrival, before writing, to the message and text attributes. Masked data becomes [masqué:<rule>].

RuleWhat it masksState in a new workspace
secretsBearer tokens, password=…, AWS, GitHub and Slack keys, HYPHA keys, JWTs, PEM private keyson
credit_cardcard numbers (Luhn check)offered
ibanIBANsoffered
emailemail addressesoffered
phone_frFrench phone numbersoffered
ipv4_publicpublic IPv4 addressesoffered
fr_nirFrench social security numbersoffered

An administrator turns rules on and tests a sample text in Settings › Logs.

Log-based metrics

A log query can feed a metric: a count of lines, or the distribution of an attribute (.avg, .p50, .p95, .p99, .max), by group. These metrics are plotted and alerted on like any other and remain after the logs' retention ends.

Application errors

An error line carrying a stack trace (Python, Java, Go, Node) or error.kind and error.stack attributes feeds the Errors page, with errors from traces and browsers. See Traces.

Retention

Retention depends on the plan: see pricing. When self-hosting, you set it.

Updated: 19 November 2026