Skip to content

Commit 6dbdd53

Browse files
committed
Readme edits
1 parent b458eff commit 6dbdd53

File tree

4 files changed

+25
-49
lines changed

4 files changed

+25
-49
lines changed

README.md

Lines changed: 18 additions & 41 deletions
Original file line numberDiff line numberDiff line change
@@ -47,22 +47,13 @@ Chronos is a comprehensive developer tool that monitors the health and web traff
4747

4848
## <img src ="./app/assets/fire.png" height=22 > What's New? <img src ="./app/assets/fire.png" height=24>
4949

50-
- New Feature
51-
- Chronos now comes in any OS .exe!
52-
- Overhauled Features
53-
- Authentication Enabling with Bcrypt
54-
- Stand-up times decreased
55-
- Side-by-side Server Comparisons
56-
- Color-hashing generates unique colors for each server connection
57-
- Improved navigation bar and buttons
58-
- Increased overall speed and responsiveness
59-
- Updated Features
60-
- Added React Testing Library
61-
- Removed Spectron and Enzyme
62-
- Added testing suites for unit, integration, and end-to-end testing
63-
- Refactored components for dependency injection
64-
- Bug Fixes
65-
- Authentication now functioning properly
50+
51+
- Metric query tool so you can filter out specific metrics — now you only have to see what you want on the dashboard.
52+
- Additional metrics added, bringing Chronos up from only 12 to 100+ metrics that are currently available
53+
- Option to filter by category and individual metric, and flip between services and categories with ease
54+
- Apache Kafka monitoring capability, all you need to do is run Prometheus JMX exporter on the system your Chronos application is running on. A sample JMX config.yaml file is provided in the Chronos repository for a quick and easy setup, however you are free to configure however you like.
55+
- Bug fixes and UI tweaks — Chronos is now a more seamless experience than ever.
56+
6657
## Features
6758

6859
- Distributed tracing enabled across microservices applications
@@ -120,17 +111,17 @@ export DISPLAY="`sed -n 's/nameserver //p' /etc/resolv.conf`:0"
120111

121112
To use Chronos in your existing application, download and install the following in the **root directory** of _each of your microservice applications_:
122113
```
123-
npm install chronos-tracker
114+
npm install chronos-tracker-7
124115
```
125116

126-
### Configure Chronos Tracker
117+
### Configuring Chronos Tracker
127118

128119
Similarly, in the **root directory** of _each of your microservice applications_, create a `chronos-config.js` file with properties listed below:
129120

130121
```js
131122
// A sample `chronos-config.js` file
132123

133-
const chronos = require('chronos-tracker');
124+
const chronos = require('chronos-tracker-7');
134125

135126
chronos.use({
136127
microservice: 'payments',
@@ -154,45 +145,31 @@ The `dockerized` property is optional and should be specified as `true` if the s
154145
The `database` property is required and takes in the following:
155146
- `connection` should be a string and only supports 'REST' and 'gRPC'
156147
- `type` should be a string and only supports 'MongoDB' and 'PostgreSQL'.
157-
- `URI` should be a connection string to the database where you intend Chronos to write and record data regarding health, HTTP route tracing, and container infomation.
158-
159-
_NOTE: A `.env` is recommended._
148+
- `URI` should be a connection string to the database where you intend Chronos to write and record data regarding health, HTTP route tracing, and container infomation.
149+
We reccommend using dotenv
160150

161-
<!-- - `isDockerized`: Is this microservice running in a Docker container? Enter `yes` or `no`. The current default setting is `no`.
162-
- <img src="./app/assets/important.png" alt="Important" title="Important" align="center" height="20" /></a> When starting up the container, give it the same name that you used for the microservice, because the middleware finds the correct container ID of your container by matching the container name to the microservice name you input as 1st argument.
163-
- <img src="./app/assets/important.png" alt="Important" title="Important" align="center" height="20" /></a> Don't forget to bind mount to Docker socket. -->
164-
165-
The `notifications` property is optional. Jump to the section below, [Notifications](#notifications) to configure <a href="#"><img src="./app/assets/slack-logo-color.png" alt="Slack" title="Slack" align="center" height="20" /></a> or email <a href="#"><img src="./app/assets/email-icon-black.png" alt="Slack" title="Slack" align="center" height="20" /></a> notifications.
166-
<br>
167-
<br>
168-
169-
### Initialize Chronos Tracker
170-
#### Initialize Chronos Tracker for REST
171-
172-
Wherever you create an instance of your server (see example below),
151+
You will also need to add the following two lines of code to your express server:,
173152

174153
```js
175154
// Example for REST
176155
const express = require('express');
177-
const app = express());
156+
const app = express();
178157

179158
```
180159

181-
you will also need to require in `chronos-tracker` and initialize Chronos, as well as the `./chronos-config` file. You will then need to invoke `chronos.propagate()` to initiate the route tracing, in addition to implementing `chronos.track()` for all endpoints.
160+
you will also need to require in `chronos-tracker-7` and initialize Chronos, as well as the `./chronos-config` file in addition to implementing `chronos.track()` for all endpoints.
182161

183162
```js
184-
const chronos = require('chronos-tracker');
163+
const chronos = require('chronos-tracker-7');
185164
require('./chronos-config'); // Bring in config file
186165

187166
// ...
188167

189-
chronos.propagate();
190168
app.use('/', chronos.track());
191169
```
192170

193-
You should be good to go! The last step, **Docker Configuration**, is **only applicable** if you need to configure <a href="#"><img src="./app/assets/docker-logo-color.png" alt="Docker" title="Docker" align="center" height="20" /></a> for your application.
171+
You should be good to go! The steps below for **Docker Configuration** and **Kafka Configuration**, are **only applicable** if you need to configure <a href="#"><img src="./app/assets/docker-logo-color.png" alt="Docker" title="Docker" align="center" height="20" /></a> or Kafka for your application. See the **Notifications** section below for information on how to uses the notifications propery in `chronos-config.js`.
194172

195-
<br>
196173

197174

198175
#### Initialize Chronos Tracker for gRPC
@@ -215,7 +192,7 @@ you will also need to require Chronos-tracker, Chronos-config, and dotenv.config
215192

216193
```js
217194
//track health data
218-
const chronos = require('chronos-tracker');
195+
const chronos = require('chronos-tracker-7');
219196
require('./chronos-config');
220197
require('dotenv').config(); // set up environment variables in .env
221198
const BookModel = require('./BookModel');

chronos_npm_package/README.md

Lines changed: 5 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -3,12 +3,11 @@
33
Chronos is a comprehensive developer tool that monitors the health and web traffic of servers, microservices, and containers. Use Chronos to see real-time data monitoring and receive automated notifications over Slack or email.
44

55
## <div height=22 > What's New? </div>
6-
- New Features
7-
- The ability to monitor an Apache Kafka cluster via the JMX Prometheus Exporter
8-
- Added 19 new system-level metrics for monitoring!
9-
- Overhauled Features
10-
- Users can use the new query tool to select the specific metrics that they would
11-
like to monitor
6+
- Metric query tool so you can filter out specific metrics — now you only have to see what you want on the dashboard.
7+
- Additional metrics added, bringing Chronos up from only 12 to 100+ metrics that are currently available
8+
- Option to filter by category and individual metric, and flip between services and categories with ease
9+
- Apache Kafka monitoring capability, all you need to do is run Prometheus JMX exporter on the system your Chronos application is running on. A sample JMX config.yaml file is provided in the Chronos repository for a quick and easy setup, however you are free to configure however you like.
10+
- Bug fixes and UI tweaks — Chronos is now a more seamless experience than ever.
1211
## Features
1312
- Distributed tracing enabled across microservices applications
1413
- Compatible with <img src="./app/assets/graphql-logo-color.png" alt="GraphQL" title="GraphQL" align="center" height="20" /></a>

examples/gRPC/README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -36,7 +36,7 @@ const myURI = process.env.BOOK_URI;
3636

3737
```
3838
require('dotenv').config();
39-
const chronos = require('chronos-tracker');
39+
const chronos = require('chronos-tracker-7');
4040
4141
chronos.use({
4242
microservice: 'name of microservice e.g books or orders',

examples/microservices/README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -37,7 +37,7 @@ const myURI = process.env.BOOK_URI;
3737

3838
```
3939
require('dotenv').config();
40-
const chronos = require('chronos-tracker');
40+
const chronos = require('chronos-tracker-7');
4141
4242
chronos.use({
4343
microservice: 'name of microservice e.g books or orders',

0 commit comments

Comments
 (0)