Skip to content

Commit ba64d34

Browse files
committed
general readme updated
1 parent 93c0a81 commit ba64d34

File tree

1 file changed

+42
-17
lines changed

1 file changed

+42
-17
lines changed

README.md

Lines changed: 42 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -10,25 +10,25 @@
1010
![Release: 5.2](https://img.shields.io/badge/Release-5.1-orange)
1111

1212
#
13-
# Chronos
1413

14+
# Chronos
1515

1616
### Star us on GitHub — it helps!
17+
1718
Visit our splash page at [chronoslany.com](https://chronoslany.com/)
1819

19-
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.
20+
Chronos is a comprehensive developer tool that monitors the health and web traffic of servers, microservices, containers, and now, Amazon Web Services (AWS). Use Chronos to see real-time data monitoring and receive automated notifications over Slack or email.
2021

2122
#
2223

2324
## What's New?
24-
- Metric query tool so you can filter out specific metrics — now you only have to see what you want on the dashboard and reduce database bloat, keeping your database from being overwhelmed with data points that you don't actually need.
25-
- Kubernetes metrics monitoring via Prometheus.
26-
- Additional metrics added, bringing Chronos up from only 12 to 100+ metrics that are currently available
27-
- Option to filter by category and individual metric, and flip between services and categories with ease
28-
- 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.
25+
26+
- Option to choose between cloud hosted services and local services, now giving Chronos the ability to monitor instances and clusters on AWS' EC2 and ECS platforms.
27+
- An updated AWS Graphs Container to dynamically render plots for EC2 or ECS data fetched with electron using event listeners connecting to AWS CloudWatch w/ the aws-sdk package
28+
- A step-by-step instruction on setting up a new, functional EC2 instance and/or ECS cluster, ready to be monitored and tested by the app
2929
- Bug fixes and UI tweaks — Chronos is now a more seamless experience than ever.
3030

31-
## Features
31+
## Features
3232

3333
- Distributed tracing enabled across microservices applications
3434
- Kubernetes monitoring via Prometheus server
@@ -38,22 +38,26 @@ Chronos is a comprehensive developer tool that monitors the health and web traff
3838
- Display and compare multiple microservice metrics in a single graph
3939
- Monitor an <a href="#"><img src="assets/pngwing.com.png" alt="Apache Kafka" title="Apache Kafka" align="center" height="20" /></a> cluster via the JMX Prometheus Exporter
4040
- Monitor a Kubernetes cluster via a Prometheus monitoring server
41+
- Monitor Amazon Web Services (AWS) instances and clusters <img src="assets/aws-logo-color.png" alt="AWS" title="AWS" align="center" height="20" /></a>
4142

4243
#
4344

4445
## Installation
46+
4547
This is for the latest Chronos **version 8 release**.
4648

47-
**NOTE:** The Chronos tracker code is included in the *chronos_npm_package* folder for ease of development, but the published npm package can be downloaded by running `npm install @chronosmicro/tracker`
49+
**NOTE:** The Chronos tracker code is included in the _chronos_npm_package_ folder for ease of development, but the published npm package can be downloaded by running `npm install @chronosmicro/tracker`
4850

4951
<br>
5052

5153
### Node Version
52-
Make sure you're running version 16.17.1 of <img src="assets/node-logo-color.png" alt="Node" title="Node" align="center" height="20" />, to align with the <img src="assets/node-logo-color.png" alt="Node" title="Node" align="center" height="20" /> version used by <img src="assets/electron-logo-color.png" alt="Electron" title="Electron" align="center" height="20" /> version 22.
54+
55+
Make sure you're running version 16.17.1 of <img src="assets/node-logo-color.png" alt="Node" title="Node" align="center" height="20" />, to align with the <img src="assets/node-logo-color.png" alt="Node" title="Node" align="center" height="20" /> version used by <img src="assets/electron-logo-color.png" alt="Electron" title="Electron" align="center" height="20" /> version 22.
5356

5457
<br>
5558

5659
### WSL2 Environment
60+
5761
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
5862

5963
- Install <a href='https://sourceforge.net/projects/vcxsrv/'>VcXsrv</a>
@@ -65,36 +69,43 @@ sudo apt install libgconf-2-4 libatk1.0-0 libatk-bridge2.0-0 libgdk-pixbuf2.0-0
6569
```
6670

6771
- After running your VcXsrv instance, run the following command in the terminal
72+
6873
```
6974
export DISPLAY="`sed -n 's/nameserver //p' /etc/resolv.conf`:0"
7075
```
7176

7277
<br>
7378

7479
### Running the Chronos Desktop App in Development Mode
80+
7581
1. From the root directory, run `npm install`
7682
2. Open a terminal and run `npm run dev:app` to start the Webpack development server
7783
3. Open another terminal and run `npm run dev:electron` to start the Electron UI in development mode
7884

7985
### Packing the Chronos App into an Executable
86+
8087
1. From the root directory, run `npm run build`
8188
2. Run `npm package`
8289
3. Find the `chronos.app` executable inside the newly created `release-builds` folder in the root directory.
8390

8491
#
8592

8693
## Chronos Tracker Microservice Examples
94+
8795
We provide three working example microservice applications branch for you to test out Chronos:
88-
- *examples/microservices*
89-
- *examples/docker*
90-
- *examples/kubernetes*
96+
97+
- _examples/microservices_
98+
- _examples/docker_
99+
- _examples/kubernetes_
91100

92101
#### _Microservices_
93-
In the `microservices` folder, we provide a sample microservice application that successfully utilizes Chronos to apply all the powerful, built-in features of our monitoring tool. You can then visualize the data with the <img src="assets/electron-logo-color.png" alt="Electron" title="Electron" align="center" height="20" /></a> app.
102+
103+
In the `microservices` folder, we provide a sample microservice application that successfully utilizes Chronos to apply all the powerful, built-in features of our monitoring tool. You can then visualize the data with the <img src="assets/electron-logo-color.png" alt="Electron" title="Electron" align="center" height="20" /></a> app.
94104

95105
Refer to the [README](link) in the `microservices` folder for more details.
96106

97107
#### _Docker_
108+
98109
In the <a href="#"><img src="assets/docker-logo-color.png" alt="Docker" title="Docker" align="center" height="20" /></a> folder within the `master` branch, we provide a sample _dockerized_ microservices application to test out Chronos and to apply distributed tracing across different containers for your testing convenience.
99110

100111
The `docker` folder includes individual <a href="#"><img src="assets/docker-logo-color.png" alt="Docker" title="Docker" align="center" height="20" /></a> files in their respective directories. A docker-compose.yml is in the root directory in case you'd like to deploy all services together.
@@ -104,18 +115,29 @@ Refer to the [README](link) in the `docker` folder for more details.
104115
<br>
105116

106117
#### _Kubernetes_
107-
The `kubernetes` folder includes a React frontend and an Express server backend, and the Dockerfiles needed to containerize them for Kubernetes deployment. The *launch* folder includes the YAML files needed to configure the deployments, services, and configurations of the frontend, backend, and Prometheus server.
108118

119+
The `kubernetes` folder includes a React frontend and an Express server backend, and the Dockerfiles needed to containerize them for Kubernetes deployment. The _launch_ folder includes the YAML files needed to configure the deployments, services, and configurations of the frontend, backend, and Prometheus server.
109120

110121
Refer to the [README](link) in the `kubernetes` folder for more details.
111122

112123
<br>
113124

114-
## Chronos Website
125+
#### _AWS_
126+
127+
The `AWS` folder includes a instructions to create a new AWS. The _launch_ folder includes the YAML files needed to configure the deployments, services, and configurations of the frontend, backend, and Prometheus server.
128+
129+
Refer to the [README](link) in the `AWS` folder for more details.
130+
131+
<br>
132+
133+
## Chronos Website
134+
115135
The `chronosWebsite` branch holds the code for the splash page. Edit the website by checking out the branch, modifying the website, and then updating the AWS S3 bucket with the changes.
116136

117137
#
138+
118139
###### Return to [Top](#chronos)
140+
119141
<br>
120142

121143
## Technologies
@@ -129,7 +151,7 @@ The `chronosWebsite` branch holds the code for the splash page. Edit the website
129151
- <a href="#"><img src="assets/node-logo-color.png" alt="Node" title="Node" align="center" height="30" /></a>
130152
- <a href="#"><img src="assets/express-logo-color.png" alt="Express" title="Express" align="center" height="30" /></a>
131153
- <a href="#"><img src="assets/http-logo-color.png" alt="HTTP" title="HTTP" align="center" height="30" /></a>
132-
- <a href="#"><img src="assets/grpc-logo-color.png" alt="gRPC" title="gRPC" align="center" height="30" /></a>
154+
- <a href="#"><img src="assets/grpc-logo-color.png" alt="gRPC" title="gRPC" align="center" height="30" /></a>
133155
- <a href="#"><img src="assets/graphql-logo-color.png" alt="GraphQL" title="GraphQL" align="center" height="30" /></a>
134156
- <a href="#"><img src="assets/docker-logo-color.png" alt="Docker" title="Docker" align="center" height="30" /></a>
135157
- <a href="#"><img src="assets/aws-logo-color.png" alt="AWS" title="AWS" align="center" height="30" /></a>
@@ -147,10 +169,13 @@ The `chronosWebsite` branch holds the code for the splash page. Edit the website
147169
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.
148170

149171
- [Contributing](https://github.com/oslabs-beta/Chronos/blob/master/CONTRIBUTING.md)
172+
150173
#
151174

152175
## License
153176

154177
Chronos is [MIT licensed.](https://github.com/oslabs-beta/Chronos/blob/master/LICENSE.md)
178+
155179
#
180+
156181
###### Return to [Top](#chronos)

0 commit comments

Comments
 (0)