openstack service checks #2

  • By xavpaice
  • Latest version (#2)
  • xenial, trusty, bionic
  • Stable

Description

OpenStack Services NRPE Checks


Overview

This charm provides OpenStack services checks for Nagios

Build

The fully built charm needs the following source branch
* https://git.launchpad.net/~canonical-bootstack/bootstack-ops/+git/charm-openstack-services-checks

To build the charm, do:

Prepare the environment

mkdir -p layers charms/xenial
export JUJU_REPOSITORY=$PWD/charms

Clone the repositories

pushd layers
git clone https://git.launchpad.net/~canonical-bootstack/bootstack-ops/+git/charm-openstack-services-checks
popd

Build the charm, and symlink for juju-1 compatibility

charm build layers/charm-openstack-services-checks
ln -s ../builds/charm-openstack-services-checks charms/xenial

Usage

juju deploy local:xenial/openstack-services-checks

This charm supports relating to keystone via the keystone-credentials
interface. If you do not wish to use this, you can supply your own credential
set for Openstack by adding 'os-credentials' setting (see setting description
hints)

juju set openstack-services-checks os-credentials=" ... "
juju add-relation openstack-services-checks nagios

With Keystone

juju add-relation openstack-services-checks:identity-credentials keystone:identity-credentials

If your OpenStack API endpoints have a common URL for the Admin, Public and
Internal addresses, you should consider disabling some endpoints which would be
duplicated otherwise, e.g.

juju config openstack-service-checks check_internal_urls=False check_admin_urls=False

Configuration

nova_crit
(int) Critical level for nova aggregate unit count check - setting this to -1 will effectively disable host aggregate checks.
1
check_admin_urls
(boolean) If true, create NRPE checks matching all 'admin' URLs in the Keystone catalog.
True
trusted_ssl_ca
(string) base64 encoded SSL ca cert to use for OpenStack API client connections.
check_internal_urls
(boolean) If true, create NRPE checks matching all 'internal' URLs in the Keystone catalog.
True
nagios_servicegroups
(string) A comma-separated list of nagios servicegroups. If left empty, the nagios_context will be used as the servicegroup
nova_warn
(int) Warning level for nova aggregate unit count check - setting this to -1 will effectively disable host aggregate checks.
2
nagios_context
(string) Used by the nrpe subordinate charms. A string that will be prepended to instance name to set the host name in nagios. So for instance the hostname would be something like: juju-myservice-0 If you're running multiple environments with the same services in them this allows you to differentiate between them.
juju
tls_warn_days
(int) Number of days left for the TLS certificate to expire before warning.
30
package_status
(string) The status of service-affecting packages will be set to this value in the dpkg database. Valid values are "install" and "hold".
install
extra_packages
(string) Space separated list of extra deb packages to install.
os-credentials
(string) Comma separated OpenStack credentials to be used by nagios. It is strongly recommended this be a user with a dedicated role, and not a full admin. Takes the format of username=foo, password=bar, credentials_project=baz, region_name=Region1, auth_url=http://127.0.0.1:35357
check-dns
(string) A space-separated list of DNS names to check. If any of the names are not resolvable, alert as CRITICAL.
check_public_urls
(boolean) If true, create NRPE checks matching all 'public' URLs in the Keystone catalog.
True
tls_crit_days
(int) Number of days left for the TLS certificate to expire before alerting Critical.
14
install_keys
(string) List of signing keys for install_sources package sources, per charmhelpers standard format (a yaml list of strings encoded as a string). The keys should be the full ASCII armoured GPG public keys. While GPG key ids are also supported and looked up on a keyserver, operators should be aware that this mechanism is insecure. null can be used if a standard package signing key is used that will already be installed on the machine, and for PPA sources where the package signing key is securely retrieved from Launchpad.
install_sources
(string) List of extra apt sources, per charm-helpers standard format (a yaml list of strings encoded as a string). Each source may be either a line that can be added directly to sources.list(5), or in the form ppa:<user>/<ppa-name> for adding Personal Package Archives, or a distribution component to enable.
skip-disabled
(boolean) An option to specify whether you want Warning alerts in nagios for disabled nova-compute hosts.