Skip to main content

Openobserve

@sntxrr/openobservev2026.08.29.1· 12d agoMODELS
01README

Operate a self-hosted OpenObserve instance from swamp, and decide safely whether a newer upstream release should be rolled out to it. OpenObserve publishes release candidates into the same tag namespace as stable releases -- on 2026-08-29 the newest tag was v1.0.0-rc1, published eleven days AFTER the newest stable v0.92.2 -- so anything that reads the tag list and sorts it pins an RC. That is worse here than for a stateless app: OpenObserve is a log store, and an RC that migrates the on-disk schema is not undone by re-pinning the previous tag, because the previous binary can no longer read what the new one wrote. The check_update method reads GitHub releases rather than tags, excludes drafts and prereleases (by the GitHub flag OR a semver prerelease suffix, since the flag is hand-set and occasionally wrong), applies real semver precedence so a prerelease sorts before its own release, and reports the newer prereleases it skipped so a pending major stays visible without being auto-applied. It then confirms the candidate tag actually resolves in the registry before offering the update -- a GitHub release and a pushed image are separate events, and proposing a bump whose image does not exist yet fails the deploy at compose pull, after the running container has already been stopped. The health method probes /healthz, treating a refused connection as a health result rather than a model error so a down instance is distinguishable from a broken check.

02Models1
@sntxrr/openobserve/instancev2026.08.29.1openobserve.ts

Global Arguments

ArgumentTypeDescription
urlstringBase URL of the OpenObserve instance, e.g. http://192.0.2.10:5080.
repositorystringGitHub `owner/repo` that publishes the releases. Overridable so a fork
registrystringContainer registry host holding the images.
registryRepositorystringRepository path within the registry. OpenObserve publishes under Zinc
githubToken?stringOptional GitHub token. Unauthenticated the releases API allows 60
fn health(timeoutMs: number)
Probe the instance's /healthz endpoint and record whether it is serving. Unauthenticated: /healthz needs no credentials, which is why it is the probe rather than a page behind the login.
ArgumentTypeDescription
timeoutMsnumberGive up on the probe after this long.
fn check_update(currentVersion: string, allowPrerelease: boolean, pageSize: number, verifyImage: boolean)
Compare a pinned OpenObserve version against upstream GitHub releases, skipping release candidates, and confirm the candidate image is actually pullable before reporting an update as available.
ArgumentTypeDescription
currentVersionstringThe version currently deployed, e.g. v0.92.2. Compared leniently,
allowPrereleasebooleanOffer release candidates too. Leave false for a log store: an RC
pageSizenumberHow many recent releases to consider. The newest stable can be
verifyImagebooleanConfirm the candidate tag resolves in the registry. A release and

Resources

health(infinite)— Liveness of the OpenObserve instance as of the last probe.
update(infinite)— Whether a newer stable OpenObserve release is available and its image is pullable.
03Stats
A
100 / 100
Downloads
1
Archive size
15.3 KB
  • Has README or module doc2/2earned
  • README has a code example1/1earned
  • README is substantive1/1earned
  • Most symbols documented1/1earned
  • No slow types (deprecated)1/1earned
  • Dependencies pass trust audit2/2earned
  • Has description1/1earned
  • Platform support declared (or universal)2/2earned
  • License declared1/1earned
  • Verified public repository2/2earned
04Platforms
05Labels