add docs for health checks (#599)

This commit is contained in:
Juan J. Jimenez-Anca
2021-05-01 17:30:54 +02:00
committed by GitHub
parent 7f1af64527
commit 4b26e78109
2 changed files with 19 additions and 1 deletions
+16
View File
@@ -0,0 +1,16 @@
# Health checks
gRPC has a [health checking protocol](https://github.com/grpc/grpc/blob/master/doc/health-checking.md) that defines how health checks for services should be carried out. Tonic supports this protocol with the optional [tonic health crate](https://docs.rs/tonic-health).
This example uses the crate to set up a HealthServer that will run alongside the application service. In order to test it, you may use community tools like [grpc_health_probe](https://github.com/grpc-ecosystem/grpc-health-probe).
For example, running the following bash script:
```bash
while [ true ]; do
./grpc_health_probe -addr=[::1]:50051 -service=helloworld.Greeter
sleep 1
done
```
will show the change in health status of the service over time.