Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

Provide a grpc.health.v1 health checking service

Open
#930 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
5/5
Estimated time
Over a week
Newbie friendliness
38/100
Issue type
Feature
Clarity
Mostly clear
Activity status
Active
Tech stack
grpc, java, scala

Research direction

Read ServerReflection as the proposed model and server/kubernetes.md for the existing health-check documentation. Then review how server services and Scala/Java APIs are exposed; the issue identifies no implementation files or tests. Done means providing grpc.health.v1.Health with Check, Watch, per-service and overall status controls, plus server setup and Kubernetes probe documentation.

Written by the indexing model from the issue text.

Description

Pekko gRPC has no built-in implementation of the standard gRPC health checking service, grpc.health.v1.Health (https://github.com/grpc/grpc/blob/master/doc/health-checking.md). server/kubernetes.md only describes HTTP health checks.

Kubernetes gRPC liveness/readiness probes, grpc-health-probe, Envoy and other load balancers expect this service. grpc-java provides HealthStatusManager.

Proposal:

  • Provide a grpc.health.v1 service implementation with Scala and Java APIs, like ServerReflection.
  • Support Check and Watch, and a way to set the serving status per service (and for the empty overall service name).
  • Document how to add it to a server, and how to use it with Kubernetes gRPC probes.
Dominant language
Scala
Stars
55
Forks
30
Avg merge
1d 18h
Merged PRs (30d)
19

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from apache/pekko-grpc

All issues in apache/pekko-grpc

Similar issues

More Scala issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.