You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
- 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
+
66
57
## Features
67
58
68
59
- Distributed tracing enabled across microservices applications
To use Chronos in your existing application, download and install the following in the **root directory** of _each of your microservice applications_:
122
113
```
123
-
npm install chronos-tracker
114
+
npm install chronos-tracker-7
124
115
```
125
116
126
-
### Configure Chronos Tracker
117
+
### Configuring Chronos Tracker
127
118
128
119
Similarly, in the **root directory** of _each of your microservice applications_, create a `chronos-config.js` file with properties listed below:
129
120
130
121
```js
131
122
// A sample `chronos-config.js` file
132
123
133
-
constchronos=require('chronos-tracker');
124
+
constchronos=require('chronos-tracker-7');
134
125
135
126
chronos.use({
136
127
microservice:'payments',
@@ -154,45 +145,31 @@ The `dockerized` property is optional and should be specified as `true` if the s
154
145
The `database` property is required and takes in the following:
155
146
-`connection` should be a string and only supports 'REST' and 'gRPC'
156
147
-`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
160
150
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 <ahref="#"><imgsrc="./app/assets/slack-logo-color.png"alt="Slack"title="Slack"align="center"height="20" /></a> or email <ahref="#"><imgsrc="./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:,
173
152
174
153
```js
175
154
// Example for REST
176
155
constexpress=require('express');
177
-
constapp=express());
156
+
constapp=express();
178
157
179
158
```
180
159
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.
182
161
183
162
```js
184
-
constchronos=require('chronos-tracker');
163
+
constchronos=require('chronos-tracker-7');
185
164
require('./chronos-config'); // Bring in config file
186
165
187
166
// ...
188
167
189
-
chronos.propagate();
190
168
app.use('/', chronos.track());
191
169
```
192
170
193
-
You should be good to go! The last step, **Docker Configuration**, is**only applicable** if you need to configure <ahref="#"><imgsrc="./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 <ahref="#"><imgsrc="./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`.
194
172
195
-
<br>
196
173
197
174
198
175
#### Initialize Chronos Tracker for gRPC
@@ -215,7 +192,7 @@ you will also need to require Chronos-tracker, Chronos-config, and dotenv.config
215
192
216
193
```js
217
194
//track health data
218
-
constchronos=require('chronos-tracker');
195
+
constchronos=require('chronos-tracker-7');
219
196
require('./chronos-config');
220
197
require('dotenv').config(); // set up environment variables in .env
Copy file name to clipboardExpand all lines: chronos_npm_package/README.md
+5-6Lines changed: 5 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -3,12 +3,11 @@
3
3
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.
4
4
5
5
## <divheight=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.
12
11
## Features
13
12
- Distributed tracing enabled across microservices applications
14
13
- Compatible with <imgsrc="./app/assets/graphql-logo-color.png"alt="GraphQL"title="GraphQL"align="center"height="20" /></a>
0 commit comments