monitor.check-status

def aggregate_status(statuses: Sequence[CheckStatus], down_quorum: int) -> CheckStatus

CheckStatus = Literal["up", "degraded", "down"]

@dataclass(frozen=True)
class Check:
    """One probe outcome at a moment, the unit every monitor.* series is made of."""

    #: Unix seconds when the probe ran
    at: int
    status: CheckStatus

from fune.monitor.check_status import aggregate_status  # monitor.check-status@^1

from typing import Sequence

from .monitor_check_status_types import CheckStatus


def aggregate_status(statuses: Sequence[CheckStatus], down_quorum: int) -> CheckStatus:
    """One status for a target probed from several places. Down needs a
    quorum, so one location with a broken route cannot page anyone; a down
    vote below the quorum still counts as degraded, because something is
    wrong somewhere."""
    if len(statuses) == 0:
        raise ValueError("statuses must not be empty")
    if not isinstance(down_quorum, int) or isinstance(down_quorum, bool) or down_quorum < 1 or down_quorum > len(statuses):
        raise ValueError("downQuorum must be 1 to %d, received %r" % (len(statuses), down_quorum))
    down = 0
    degraded = 0
    for s in statuses:
        if s == "down":
            down += 1
        elif s == "degraded":
            degraded += 1
        elif s != "up":
            raise ValueError("unknown check status: %s" % (s,))
    if down >= down_quorum:
        return "down"
    return "degraded" if down > 0 or degraded > 0 else "up"

Install

fune build

With that line in your source, in a Python project (language python in fune.project), fune build resolves it and nothing else, pins them in fune.lock, downloads only the Python package of each, and builds the code above into your project’s .fune/build, one readable file per capability with a header linking back here. Or pin a range in fune.project and build in one step:

fune add monitor.check-status

The manifest, vectors and README with only the Python implementation. Install it without the registry with fune add ./monitor.check-status-1.0.0-python.fune, or fetch it from a terminal with fune pull monitor.check-status@1.0.0:python.

The whole function, every language, is one file too: monitor.check-status-1.0.0.fune, 9,013 bytes, sha256 be76e5bc993feafeee52850214d86b9e76091db0f91f029ed87fadc0576185ff. It installs into a project of any language.

# fune: before monitor.check-status

# fune: after monitor.check-status

# fune: step monitor.check-status after <n|label>

More from the author

## aggregateStatus

Monitoring services confirm an outage from more than one location before alerting, because a single probe location with a bad route is far more common than a real outage. The rule, in order:

1. At least `downQuorum` statuses are `down`: **down**. 2. Any `down` (below the quorum) or any `degraded`: **degraded**. Something is wrong somewhere, but not enough to call it an outage. 3. Otherwise **up**.

Degraded votes never add up to down, however many there are: a slow site is still serving.

## Errors

- `statuses must not be empty` - `downQuorum must be 1 to N` where N is the number of statuses: a quorum that can never be met would hide every outage. - `unknown check status: X`

Files