{"id":14520414,"url":"https://github.com/connectrpc/grpchealth-go","last_synced_at":"2025-12-30T09:23:50.920Z","repository":{"id":38328510,"uuid":"472474418","full_name":"connectrpc/grpchealth-go","owner":"connectrpc","description":"gRPC-compatible health checks for any net/http server.","archived":false,"fork":false,"pushed_at":"2024-08-23T14:00:39.000Z","size":98,"stargazers_count":67,"open_issues_count":1,"forks_count":8,"subscribers_count":12,"default_branch":"main","last_synced_at":"2024-12-09T03:54:41.477Z","etag":null,"topics":["connectrpc","go","grpc","protobuf","rpc"],"latest_commit_sha":null,"homepage":"https://connectrpc.com","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/connectrpc.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-03-21T19:02:15.000Z","updated_at":"2024-12-03T11:49:54.000Z","dependencies_parsed_at":"2024-06-18T21:16:00.492Z","dependency_job_id":"6e5285e0-d660-4977-9cd2-24cfefc6a836","html_url":"https://github.com/connectrpc/grpchealth-go","commit_stats":null,"previous_names":["connectrpc/grpchealth-go"],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/connectrpc%2Fgrpchealth-go","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/connectrpc%2Fgrpchealth-go/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/connectrpc%2Fgrpchealth-go/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/connectrpc%2Fgrpchealth-go/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/connectrpc","download_url":"https://codeload.github.com/connectrpc/grpchealth-go/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":231631672,"owners_count":18403229,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["connectrpc","go","grpc","protobuf","rpc"],"created_at":"2024-09-04T04:01:47.469Z","updated_at":"2025-12-30T09:23:50.892Z","avatar_url":"https://github.com/connectrpc.png","language":"Go","funding_links":[],"categories":["Go"],"sub_categories":[],"readme":"grpchealth\n==========\n\n[![Build](https://github.com/connectrpc/grpchealth-go/actions/workflows/ci.yaml/badge.svg?branch=main)](https://github.com/connectrpc/grpchealth-go/actions/workflows/ci.yaml)\n[![Report Card](https://goreportcard.com/badge/connectrpc.com/grpchealth)](https://goreportcard.com/report/connectrpc.com/grpchealth)\n[![GoDoc](https://pkg.go.dev/badge/connectrpc.com/grpchealth.svg)](https://pkg.go.dev/connectrpc.com/grpchealth)\n\n`connectrpc.com/grpchealth` adds support for gRPC-style health checks to any\n`net/http` server \u0026mdash; including those built with [Connect][connect]. By\npolling this API, load balancers, container orchestrators, and other\ninfrastructure systems can respond to changes in your HTTP server's health.\n\nThe exposed health checking API is wire compatible with Google's gRPC\nimplementations, so it works with [grpcurl], [grpc-health-probe], and\n[Kubernetes gRPC liveness probes][k8s-liveness].\n\nFor more on Connect, see the [announcement blog post][blog], the documentation\non [connectrpc.com][docs] (especially the [Getting Started] guide for Go), the\n[Connect][connect] repo, or the [demo service][examples-go].\n\n## Example\n\n```go\npackage main\n\nimport (\n  \"net/http\"\n\n  \"golang.org/x/net/http2\"\n  \"golang.org/x/net/http2/h2c\"\n  \"connectrpc.com/grpchealth\"\n)\n\nfunc main() {\n  mux := http.NewServeMux()\n  checker := grpchealth.NewStaticChecker(\n    \"acme.user.v1.UserService\",\n    \"acme.group.v1.GroupService\",\n    // protoc-gen-connect-go generates package-level constants\n    // for these fully-qualified protobuf service names, so you'd more likely\n    // reference userv1.UserServiceName and groupv1.GroupServiceName.\n  )\n  mux.Handle(grpchealth.NewHandler(checker))\n  // If you don't need to support HTTP/2 without TLS (h2c), you can drop\n  // x/net/http2 and use http.ListenAndServeTLS instead.\n  http.ListenAndServe(\n    \":8080\",\n    h2c.NewHandler(mux, \u0026http2.Server{}),\n  )\n}\n```\n\n## Status: Stable\n\nThis module is stable. It supports:\n\n* The two most recent major releases of Go (the same version of Go that continue to\n  [eceive security patches][go-support-policy]).\n* [APIv2] of Protocol Buffers in Go (`google.golang.org/protobuf`).\n\nWithin those parameters, `grpchealth` follows semantic versioning.\nWe will _not_ make breaking changes in the 1.x series of releases.\n\n## Legal\n\nOffered under the [Apache 2 license][license].\n\n[APIv2]: https://blog.golang.org/protobuf-apiv2\n[Getting Started]: https://connectrpc.com/go/getting-started\n[blog]: https://buf.build/blog/connect-a-better-grpc\n[connect]: https://github.com/connectrpc/connect-go\n[examples-go]: https://github.com/connectrpc/examples-go\n[docs]: https://connectrpc.com\n[go-support-policy]: https://golang.org/doc/devel/release#policy\n[grpc-health-probe]: https://github.com/grpc-ecosystem/grpc-health-probe/\n[grpcurl]: https://github.com/fullstorydev/grpcurl\n[k8s-liveness]: https://kubernetes.io/docs/tasks/configure-pod-container/configure-liveness-readiness-startup-probes/#define-a-grpc-liveness-probe\n[license]: https://github.com/connectrpc/grpchealth-go/blob/main/LICENSE.txt\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fconnectrpc%2Fgrpchealth-go","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fconnectrpc%2Fgrpchealth-go","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fconnectrpc%2Fgrpchealth-go/lists"}