hygeia-js
Version:
A toolkit for health checking of web services.
84 lines (52 loc) • 4.11 kB
Markdown
<h1 align="center">
<a href="https://hygeia.darteaga.com"><img src="https://hygeia.darteaga.com/img/hygeia-logo.png" alt="Hygeia"></a>
<p align="center">Hygeia JS</p>
</h1>
[](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.
[](https://hygeia.darteaga.com/docs/gs-installation.html).
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]().
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)));
```
Hygeia is available as a npm package: `hygeia-js` on [npm](https://www.npmjs.com/package/hygeia-js).
```shell
npm i hygeia-js --save
```
```shell
yarn add hygeia-js
```
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.
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.
> TODO
`<<search for contributing guide>>`
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.
Hygeia is [MIT licensed](./LICENSE).