This package has been deprecated

Author message:

this package has been updated and re-published under a different name

chronos-microservice-debugger2

Chronos Microservice Debugger

Chronos Microservice Debugger consists of an npm package with an optional Electron front end to visualize information collected through use of npm package.

Install

npm install chronos-microservice-debugger2

Usage

There are two main aspects to Chronos-Microservice-Debugger

1. Communication Monitor: Listens in on all microservice-microservice and microservice-client communication and monitors the response statuses and messages to ensure communications are making it to the correct destination successfully.
2. Health Monitor: The health monitor checks the status of your microservice every second and sends this health information to an optional electron frontend where it is visualized for easier use.

To use the npm package, there are three required parameters and an optional fourth parameter. You can enter the items as individual strings or as an array containing the three required parameters and one optional parameter.

The parameters are:

1. microserviceName: What do you want to name the current microservice
2. databaseType: We currently support PostgreSQL and Mongo. Enter "mongo" or "sql"
3. databaseURL: Where would you like to store your information? Enter the URL to your database
4. queryFrequency: How often do you want microHealth to monitor the health of your database? It defaults to every second, but you can choose:

• "s" : The default, monitors every second
• "m" : Monitors every minute
• "h" : Monitors every hour
• "d" : Monitors once per day
• "w" : Monitors once per week

String parameter example:

// How to use chronos-microservice-debugger
app.use('/', chronos-microservice-debgugger.microCom('microserviceName', 'databaseType', 'databaseURL'))

chronos-microservice-debugger.microHealth('microserviceName', 'databaseType', 'databaseURL', 'queryFrequency'))

// Example using string parameters
app.use('/', chronos-microservice-debugger.microCom('books', 'sql', 'thisIsMyURL'))
// Note: microCom does not utilize queryFreq because it logs all communication when an endpoint is hit

chronos-microservice-debugger.microHealth('books', 'sql', 'thisIsMyURL', 'h')

Array parameter example:

let values = [
  'microserviceName',
  'databaseType',
  'databaseURL',
  'queryFrequency'
]
// How to use chronos-micrservice-debugger with an array parameter
app.use('/', chronos-microservice-debgugger.microCom(values)

chronos-microservice-debugger.microHealth(values)

// Example using an array parameter
let values = [
  'books',
  'mongo',
  'thisIsMyNewURL',
  'w'
]

app.use('/', chronos-microservice-debgugger.microCom(values)
// Note: microCom does not utilize queryFreq because it logs all communication when an endpoint is hit

chronos-microservice-debugger.microHealth(values)

Chronos uses a user-owned and provided database to ensure that your private data stays private. We currently support MongoDB and SQL/PostgreSQL databases.

Things in the Works

1. gRPC support
2. 'Time Travel' to see how your microservices have changed over time
3. Docker health information for containerized microservices
4. Implement additional unit testing
5. Published Electron application with cross-browser compatibility
6. Microservice Architecture Visualizer

Links

1. Chronos Website (Coming Soon): http://chronos.ninja
2. Gitub Page: https://github.com/oslabs-beta/Chronos

Contact Us

For questions, requests, or more information, please contact us at [e-mail]