Skip to main content

Simple health checks takes a modular plugin based approach to provide health checks relevant to your project.

Project description

Simple health checks takes a modular plugin based approach to provide health checks that are right for you.

Example response from health checks endpoint

{"serviceName": "myProject", "requestUrl": "localhost:8000/health/1/", "datetime": "2021-11-19T11:53:26ZUTC", "components": ["Database", "RabbitMQ"], "status": "OK", "version": "1.5.0", "simpleHealthChecksVersion": "1.0.0"}

Setup

Environment variables

The following environment variables should be set up:

  • SETTINGS_FILE_FOR_DYNACONF - Can be used to point to a config file to load the environment variables listed below, check the dynaconf documentation
  • HEALTH_CHECKS_RESOURCES - all resources available for health check,
    • for env vars it should be set in the following format @json ["resource1", "resource2"]
    • for ini files it can be set as =resource1,resource2 without quotations
  • HEALTH_CHECKS_CRITICAL - same format required as HEALTH_CHECKS_RESOURCES resource file names (the same as you use in HEALTH_CHECKS) that are critical for the application and will result in a DOWN status, they should also be present in HEALTH_CHECKS
  • HEALTH_CHECKS_TIMEOUT - seconds until timeout, default 10
  • HEALTH_CHECKS_CACHE_SECONDS - seconds to cache health check results, default 5
  • HEALTH_CHECKS_SERVICE_NAME - name of the service you're adding this to (this should match the filename of the resource if a health check exists for the service)
  • HEALTH_CHECKS_SERVICE_VERSION - the current version of the service hosting this package
  • HEALTH_CHECKS_MAX_WORKERS - Number of workers to run processes in parallel, default 2

If using the django_views plugin:

  • HEALTH_CHECKS_TOKEN - token required to access health of dependencies

If using the rabbitmq plugin:

  • HEALTH_CHECKS_RABBITMQ_BROKER_URL - the broker url used by rabbitmq

Installing for local development

Move to the src/ directory Run pip install .

To install plugins run: pip install plugins/<folder containing setup.py> from the src/ directory

Setting up a new resource

Notes: can_skip - does the resource you are adding support ?skip= parameter - if not we should not send it (can_skip should be False) as external dependencies can be sensitive to unknown query parameters

Plugins

Plugins can be created by following the directory structure shown in the existing plugins. They should mirror the structure of simple_health_checks You can extend config by providing a file that adds dynaconf validators. This file should exist in additional_configs/ directory within your plugin, should contain config in the filename and should define a list called validators containing your dynaconf Validator's

You'll need both a VERSION file and a MANIFEST.in file containing include VERSION.

Add the plugin's setup.py to the build_and_publish_pypi stage in .gitlab-ci.yml and adding the version in to your VERSION file

Add the plugin's pip install command to the .py stage using the path to your plugins setup.py

Ensure that you add any modules that you wish to exist in simple_health_checks to your setup.py under packages= an example is shown below for the django_views plugin

setup(
    name="simple_health_checks_django_views",
    version="0.0.0",
    description="Django views plugin for simple-health-checks,"
    " adds endpoints for ping and health checks",
    packages=[
        "simple_health_checks.views",
        "simple_health_checks.serializers",
    ],
    install_requires=[
        "simple_health_checks",
        "Django",
        "djangorestframework",
    ],
)

Notice this package adds two new modules, views and serializers to simple_health_checks. If you wish to add a new file to an existing module, for example adding a new resource to resources you would add packages=["simple_health_checks.resources"]

You should avoid making any config required and instead use a default value, preferring is_configured on the resource to define whether a resource has been correctly configured. Another reason for this is that we initialise HealthCheck within simple_health_checks.health_checks which will be problematic for testing.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

simple_health_checks-1.0.2.tar.gz (10.0 kB view details)

Uploaded Source

File details

Details for the file simple_health_checks-1.0.2.tar.gz.

File metadata

  • Download URL: simple_health_checks-1.0.2.tar.gz
  • Upload date:
  • Size: 10.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.6.0 importlib_metadata/4.8.2 pkginfo/1.8.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.6.15

File hashes

Hashes for simple_health_checks-1.0.2.tar.gz
Algorithm Hash digest
SHA256 ba8801a5f694915f192da7600b997c6d367f279ad433d185814519879df4819b
MD5 c04860ae7b2fc2c69fd099197129fb12
BLAKE2b-256 78dc3e9e09b6d88d0cebb30f4c3d2d0ba33692c2de86fe75347df332cc532311

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page