title: GitLab: Health endpoints
agents: gitlab
catalog: app/gitlab
license: MIT
distribution: check_mk
description:
 Checks the GitLab monitoring endpoints {/-/readiness}, {/-/liveness} and
 {/-/metrics}. The service is {CRIT} if the HTTP status differs from the
 expected value (default 200) or the endpoint is unreachable, and {WARN} if a
 reported component (e.g. from readiness) is not "ok". All states are
 configurable via the rule "GitLab health endpoints".

 These endpoints only exist on a self-hosted GitLab instance (CE/EE), not on
 gitlab.com. They are opt-in in the special agent rule. The endpoints
 authenticate via a separate health-check token (passed as
 ?token=), configurable in the special agent rule, or via GitLab's monitoring
 IP allowlist - not via the API access token.

item:
 The endpoint name: {readiness}, {liveness} or {metrics}.

discovery:
 One service per queried endpoint.
