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
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.
17
+
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.
18
18
19
19
## Table of Contents
20
20
-[Features](#features)
@@ -26,6 +26,7 @@ Chronos is a comprehensive developer tool that monitors the health and web traff
This is for the latest Chronos version **5.1 release and later**.
85
+
This is for the latest Chronos version **5.2 release and later**.
75
86
76
87
- Stable release: 6.1.0
77
88
- LTS release: 6.1.0
@@ -86,6 +97,22 @@ in the root directory.
86
97
If you're installing Chronos into a microservices application, and you have different folders for each microservice, make sure you also run
87
98
```npm rebuild```
88
99
in each microservices folder **after you roll back to version 14.16.1.**
100
+
101
+
**If you wish to launch the Electron Application in an WSL2 envirronment(Ubuntu) you may need the following commands for an Electron window to appear**
The `microservice` property takes in a string. This should be the name of your server or microservice. For **Docker** containers, the name of the microservice should be the same as the name of the corresponding Docker container.
121
148
122
-
The `interval` property is optional and takes in an integer. This controls the Chronos monitoring frequency. If this is omitted, Chronos will defualt to recording server health every 2000 ms or 2 seconds.
149
+
The `interval` property is optional and takes in an integer. This controls the Chronos monitoring frequency. If this is omitted, Chronos will default to recording server health every 60000 ms or 60 seconds.
123
150
124
151
The `dockerized` property is optional and should be specified as `true` if the server is running inside of a Docker container. Otherwise, this should be `false`. If omitted, Chronos will assume this server is not running in a container.
125
152
126
153
The `database` property is required and takes in the following:
127
-
-`connection` which should be a string and only supports 'REST' and 'gRPC'
128
-
-`type` which should be a string and only supports 'MongoDB' and 'PostgreSQL'.
129
-
-`URI` which should be a connection string the database you intend Chronos to write and record data regarding health, HTTP route tracing, and container infomation to. A `.env` is recommended.
154
+
-`connection` should be a string and only supports 'REST' and 'gRPC'
155
+
-`type` should be a string and only supports 'MongoDB' and 'PostgreSQL'.
156
+
-`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.
157
+
158
+
_NOTE: A `.env` is recommended._
130
159
131
160
<!-- - `isDockerized`: Is this microservice running in a Docker container? Enter `yes` or `no`. The current default setting is `no`.
132
161
- <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.
@@ -179,7 +208,7 @@ Wherever you create an instance of your server (see example below),
179
208
console.log("Server running at http://127.0.0.1:30044");
180
209
});
181
210
```
182
-
you will also need to require Chronos-tracker, Chronos-config, and dotenv.config(if this is used). For health data simply use Chronos.track()
211
+
you will also need to require Chronos-tracker, Chronos-config, and dotenv.config(if this is used). For health data, simply use Chronos.track()
183
212
184
213
185
214
@@ -211,7 +240,7 @@ const bookClient = new OrderToBookService('localhost:30044', grpc.credentials.cr
Again, this step is **only applicable** if you are currently using <ahref="#"><imgsrc="./app/assets/docker-logo-color.png"alt="Docker"title="Docker"align="center"height="20" /></a> containers for your microservices.
271
300
272
-
<ahref="#"><imgsrc="./app/assets/important.png"alt="Important"title="Important"align="center"height="20" /></a> Give your containers the same names you pass as arguments for microservice names.
301
+
<ahref="#"><imgsrc="./app/assets/important.png"alt="Important"title="Important"align="center"height="20" /></a> Give your containers the same names you pass in as arguments for microservice names.
273
302
274
-
<ahref="#"><imgsrc="./app/assets/important.png"alt="Important"title="Important"align="center"height="20" /></a> In order to have container stats saved to your database, along with other health info, bind volumes to this path when starting up the containers:
303
+
<ahref="#"><imgsrc="./app/assets/important.png"alt="Important"title="Important"align="center"height="20" /></a> In order to have container statistics saved to your database along with other health info, bind volumes to this path when starting up the containers:
275
304
```
276
305
/var/run/docker.sock
277
306
```
@@ -290,10 +319,13 @@ volumes:
290
319
291
320
### Start Chronos
292
321
293
-
Once you have configured and intialized Chronos Tracker, it will be automatically recording monitoring data when your servers are running. Finally, start the Chronos desktop app to view that data! After cloning our [GitHub repo](https://github.com/open-source-labs/Chronos), run `npm install` and `npm run both` to start Chronos. Alternatively, you can download an [executable for Mac](https://chronoslany.com/Chronos.dmg). Add your application in the Chronos app dashboard with the same URI you used in your Chronos Tracker configuration. Click on it and start monitoring!
322
+
Once you have configured and intialized Chronos Tracker, it will automatically record monitoring data when your servers are running. Finally, start the Chronos desktop app to view that data! After cloning our [GitHub repo](https://github.com/open-source-labs/Chronos), run `npm install` and `npm run both` to start Chronos.
323
+
324
+
### Getting the Chronos Executable
325
+
At the current moment, to get a copy of the executable that works on all OS, the steps are 1) clone the master branch, 2) run `npm i`, 3) run `npm run prepareDist`, 4) run `npm run package-any`, 5) navigate in your Chronos folder `./release-builds/resources` and click on `chronos.exe`. 6) optionally right click to create a shortcut.
294
326
295
327
#
296
-
###### Return to [Top](#Chronos)
328
+
###### Return to [Top](#chronos)
297
329
<br>
298
330
299
331
## Notifications
@@ -351,7 +383,7 @@ notifications: [
351
383
// ...
352
384
```
353
385
#
354
-
###### Return to [Top](#Chronos)
386
+
###### Return to [Top](#chronos)
355
387
<br>
356
388
357
389
## Branches
@@ -388,10 +420,11 @@ Refer to the [README](link) in the `docker` folder for more details.
388
420
### gRPC Branch
389
421
The **'gRPC'** branch is the current codebase for the <ahref="#"><imgsrc="./app/assets/npm-logo-color.png"alt="NPM"title="NPM"align="center"height="20" /></a> package, which is what you will install in your own application in order to use Chronos. Download the <ahref="#"><imgsrc="./app/assets/npm-logo-color.png"alt="NPM"title="NPM"align="center"height="20" /></a> package [here](https://www.npmjs.com/package/chronos-tracker).
390
422
391
-
<br>
423
+
## chronosWebsite
424
+
This is the branch that holds the code base for the splash page. Edit the website by first running `git clone -b chronosWebsite https://github.com/open-source-labs/Chronos.git .` and then updating the aws S3 bucket with the changes.
392
425
393
426
#
394
-
###### Return to [Top](#Chronos)
427
+
###### Return to [Top](#chronos)
395
428
<br>
396
429
397
430
## Technologies
@@ -418,22 +451,22 @@ The **'gRPC'** branch is the current codebase for the <a href="#"><img src="./ap
Development of Chronos is open source on GitHub through the tech accelerator umbrella OS Labs, and we are grateful to the community for contributing bugfixes and improvements. Read below to learn how you can take part in improving Chronos.
460
+
Development of Chronos is open source on GitHub through the tech accelerator umbrella OS Labs, and we are grateful to the community for contributing bug fixes and improvements. Read below to learn how you can take part in improving Chronos.
Chronos is <ahref="#"><imgsrc="./app/assets/mit-logo-color.png"alt="MIT"title="MIT"align="center"height="20" /></a> [licensed.](https://github.com/oslabs-beta/Chronos/blob/master/LICENSE.md)
0 commit comments