Socket
Socket
Sign inDemoInstall

grpc-health-check

Package Overview
Dependencies
1
Maintainers
2
Versions
29
Alerts
File Explorer

Advanced tools

Install Socket

Detect and block malicious and high-risk dependencies

Install

grpc-health-check


Version published
Maintainers
2
Install size
5.73 MB
Created

Readme

Source

grpc-health-check

Health check client and service for use with gRPC-node.

Background

This package provides an implementation of the gRPC Health Checking Protocol service, as described in gRFC L106.

Installation

Use the package manager npm to install grpc-health-check.

npm install grpc-health-check

Usage

Server

Any gRPC-node server can use grpc-health-check to adhere to the gRPC Health Checking Protocol. The following shows how this package can be added to a pre-existing gRPC server.

// Import package
import { HealthImplementation, ServingStatusMap } from 'grpc-health-check';

// Define service status map. Key is the service name, value is the corresponding status.
// By convention, the empty string '' key represents that status of the entire server.
const statusMap = {
  'ServiceFoo': 'SERVING',
  'ServiceBar': 'NOT_SERVING',
  '': 'NOT_SERVING',
};

// Construct the service implementation
const healthImpl = new HealthImplementation(statusMap);

healthImpl.addToServer(server);

// When ServiceBar comes up
healthImpl.setStatus('serviceBar', 'SERVING');

Congrats! Your server now allows any client to run a health check against it.

Client

Any gRPC-node client can use the service object exported by grpc-health-check to generate clients that can make health check requests.

Command Line Usage

The absolute path to health.proto can be obtained on the command line with node -p 'require("grpc-health-check").protoPath'.

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Please make sure to update tests as appropriate.

License

Apache License 2.0

FAQs

Last updated on 01 May 2024

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap

Packages

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc