https://github.com/dani8art/hygeia-js
A toolkit for health checking of web services.
https://github.com/dani8art/hygeia-js
healthcheck healthy lambda microservices serverless
Last synced: 27 days ago
JSON representation
A toolkit for health checking of web services.
- Host: GitHub
- URL: https://github.com/dani8art/hygeia-js
- Owner: dani8art
- License: gpl-3.0
- Created: 2017-12-14T21:19:32.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2023-01-04T10:18:10.000Z (over 3 years ago)
- Last Synced: 2025-09-11T16:37:02.382Z (10 months ago)
- Topics: healthcheck, healthy, lambda, microservices, serverless
- Language: JavaScript
- Homepage: https://hygeia.darteaga.com
- Size: 4.56 MB
- Stars: 1
- Watchers: 3
- Forks: 0
- Open Issues: 47
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Hygeia JS
[](https://github.com/dani8art/hyegia-js/blob/master/LICENSE) [](https://www.npmjs.com/package/hygeia-js) [](https://circleci.com/gh/dani8art/hygeia-js) []() [](https://github.com/facebook/jest) [](https://github.com/facebook/jest)
Hygeia is a modular health checking tool, It is written in Javascript and designed and thought for deploying in many different scenarios such as [AWS Lambda](https://github.com/dani8art/hygeia-lambda-healthcheck), [Express Middleware](), [Hapi Plugin]() or [Moleculer Service]().
* **Modular:** Hygeia was designed to be as configurable as it was possible, its modular design makes it different and it allows you to use several tools for checking the status of services.
* **Deployment agnostic:** It can be used in many different environments, Javascript allows you to use it on a background process in Node.js, as an endpoint of a RESTful API or as an AWS Lambda function.
[Learn how to use Hygeia JS in your projects](https://hygeia.darteaga.com/docs/gs-installation.html).
## Documentation
You can find the Hygeia documentation [on the website](https://hygeia.darteaga.com).
It is divided into several sections:
* [Quick Start](https://hygeia.darteaga.com/docs/gs-checking-status.html)
* [Advanced Guides](https://hygeia.darteaga.com/docs/health-checking-lambda-aws.html)
* [API Reference](https://hygeia.darteaga.com/docs/api-checker.js.html)
* [Tutorial](https://hygeia.darteaga.com/docs/health-checking-lambda-aws.html)
* [Where to Get Support](https://hygeia.darteaga.com/docs/where-to-get-support.html)
* [Contributing Guide]()
You can improve it by sending pull requests to [this repository]().
## Examples
We have several examples [on the website](https://hygeia.darteaga.com/docs/gs-checking-status.html). Here is the first one to get you started:
```jsx
const store = new MemoryStore({
data: [{ name: 'google', health: 'https://www.google.es', method: 'GET' }]
});
const reporters = [new EmailReporter({email: 'example@example.com', policy: 'always'})];
const checker = new Checker({store, reporters});
checker.check()
.then(() => console.log('Status checked for all the services.'))
.then((err => console.log(err)));
```
## Installation
Hygeia is available as a npm package: `hygeia-js` on [npm](https://www.npmjs.com/package/hygeia-js).
### NPM
```shell
npm i hygeia-js --save
```
### YARN
```shell
yarn add hygeia-js
```
## Contributing
The main purpose of this repository is to continue to evolve Hygeia core, making it faster and easier to use. Development of Hygeia happens in the open on GitHub, and we are grateful to the community for contributing bugfixes and improvements. Read below to learn how you can take part in improving Hygeia.
### [Code of Conduct](https://code.fb.com/codeofconduct/)
We have adopted a Code of Conduct from Facebook Open Source that we expect project participants to adhere to. Please read [the full text](https://code.fb.com/codeofconduct/) so that you can understand what actions will and will not be tolerated.
### [Contributing Guide]()
> TODO
`<>`
### Good First Issues
To help you get your feet wet and get you familiar with our contribution process, we have a list of [good first issues](https://github.com/facebook/react/labels/good%20first%20issue) that contain bugs which have a relatively limited scope. This is a great place to get started.
### License
Hygeia is [MIT licensed](./LICENSE).