check_nextcloud

This is a monitoring plugin for icinga to check the status of the nextcloud serverinfo API.

Usage

Try the plugin at the command line like this:

/usr/bin/php ./check_nextcloud.php -H cloud.example.com -u apiuser -p apipassword

You can define the icinga2 check command as follows:

object CheckCommand "nextcloud" {
  import "plugin-check-command"

  command = [ PluginDir + "/check_nextcloud.php" ]

  arguments = {
    "-H" = {
      "required" = true
      "description" = "Nextcloud hostname/fqdn (e.g. 'cloud.example.com')"
      "value" = "$nc_host$"
    }
    "-U" = {
      "required" = true
      "description" = "serverinfo API url, you can find it on https://cloud.example.com/settings/admi$
      "value" = "$nc_api_url$"
    }
    "-u" = {
      "required" = true
      "description" = "API user (has to be an admin)"
      "value" = "$nc_api_user$"
    }
    "-p" = {
      "required" = true
      "description" = "API-user's password"
      "value" = "$nc_api_password$"
    }
  }

  vars.nc_api_url = "/ocs/v2.php/apps/serverinfo/api/v1/info"
}

Changelog

• 2019-05-08: initial version (koelle25)

Authors

• Kevin Köllmann