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 Python 2 Python 3

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