Gohc

Library for making different type of healthchecks with a common interface.

Different type are:

• Http(s): which allow HTTP1, HTTP2 and HTTP3 healthcheck and can send data, check for multiple statuses and check for received data.
• Tcp: which allow TCP healthcheck by trying to connect in tcp send data if set and check for received data if set.
• GRPC: Perform grpc healthcheck defined in https://github.com/grpc/grpc/blob/master/doc/health-checking.md
• Program: Execute a program by passing config (json format) in stdin and check for exit code.
• ICMP (a.k.a ping): Perform icmp healthcheck by sending icmp echo request and check for icmp echo reply.
• UDP: there is two methods for udp healthcheck:
  • Send data and check for received data.
  • A weaker method which ping the server first and then send data over udp and wait until timeout to ensure to not receive Port Unreachable ICMP error. This method require root privileges to capture this ICMP reply.
• Chains: Allow to chain multiple healthchecks and execute them in parallel or in sequence with or without requiring all checks passing.

Note: Types http, Tcp, GRPC and Program allow tls support. You can, for example, do tcp+tls test.

Usage

Go to examples folder to see how to use it.