Skip to main content

aiohealthcheck: super-simple TCP health-check endpoint

Project description


This tiny module provides a simple TCP endpoint, suitable for a healthcheck in your microservice application. All it provides is a simple TCP endpoint on a port to allow a container orchestration service to connect to, to verify that the application is up.


Pretty much just start up a long-lived task with the provided tcp_health_endpoint() coroutine function:


The internal TCP server will be shut down when the task is cancelled, e.g., during your app’s shutdown sequence.

Kubernetes Example Configuration

- name: liveness-port
  containerPort: 5000
    port: liveness-port
  initialDelaySeconds: 15
  periodSeconds: 20

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

aiohealthcheck-2018.7.1.tar.gz (7.8 kB view hashes)

Uploaded source

Built Distribution

aiohealthcheck-2018.7.1-py2.py3-none-any.whl (15.1 kB view hashes)

Uploaded py2 py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page