For newest version please check gitlab page !

build status

Gitlab Naemon/Icinga/Nagios plugin which checks various stuff via Gitlab API(v3) and output of gitlab-ctl services.

Tested with: Naemon 1.0.5, Ruby 2.3.0


check_gitlab v0.1 []

This plugin checks various parameters of Gitlab

  health       Check the Gitlab web endpoint for health
  services     Check if any service of 'gitlab-ctl status' is down
  ci-pipeline  Check duration of a CI pipeline
  ci-runner    Check status of CI runners

Usage: check_gitlab [options]

    -s, --address ADDRESS            Gitlab address
    -t, --token TOKEN                Access token
    -i, --id ID                      Project ID
    -k, --insecure                   No ssl verification
    -m, --mode MODE                  Mode to check
    -w, --warning WARNING            Warning threshold
    -c, --critical CRITICAL          Critical threshold
    -v, --version                    Print version information
    -h, --help                       Show this help message


-s: gitlab url, only https supported,

-k: if you've a self signed cert

-t: access token, required for all api calls

-i: project id, number


Health check

Checks the status of the health check endpoint. See for more information.

naemon@gitlab:plugins$ ./check_gitlab -m health -s  [-k] -t 
OK - Gitlab is in healthy state


If any service of 'gitlab-ctl status' reports down service status will be critical.

Requires a sudo entry to get output of gitlab-ctl command.

naemon ALL = NOPASSWD: /usr/bin/gitlab-ctl status
naemon@gitlab:plugins$ ./check_gitlab -m services
Critical - logrotate, mattermost is down

CI Pipeline

Checks duration of CI pipeline in seconds with perfdata.

naemon@gitlab:plugins$ ./check_gitlab -m ci-pipeline -s  [-k] -t  -i  -w 100 -c 200
Critical - Pipeline #265 took 265s | duration=265s;100;150

CI Runner

Checks status of CI runner.

naemon@gitlab:plugins$ ./check_gitlab -m ci-runner -s  [-k] -t  -i  -w 0 -c 1
Warning - 1 runner active, 1 runner not active