Skip to content

Commit

Permalink
updated readme.md
Browse files Browse the repository at this point in the history
  • Loading branch information
sthivaios committed May 30, 2024
1 parent 21e3664 commit 611f66e
Showing 1 changed file with 66 additions and 7 deletions.
73 changes: 66 additions & 7 deletions readme.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
### Installation
## Installation

1) Download the installation script
```shell
Expand All @@ -14,19 +14,78 @@
sudo ./install.sh
```

During the installation, you will be prompted to modify the `config.json` file.
## config.json Information

**During the installation, you will be prompted to modify the `config.json` file.**

At the top of the file, you can modify the color (hex code) that will be used for the **down** and **up**
status. You can also enable debugging, and change the interval of the check.

```json
"interval" : "100",
"debug" : "2",
"colors" : {
"up": "#60bb50",
"down": "#ff2121"
}
```

| Key | Function |
|----------|-------------------------------------------------------------------------------------------------------------------------|
| interval | **Check interval** : How often the monitors are checked |
| debug | **Debug output level** : Output level in the console.<br/>Check the table below for more details. |
| colors | **Uptime Colors displayed in the website** : Sets the color<br/>that is used in the website for the Down and Up status. |


Debugging option in **config.json** values :

| Value | Function |
|-------|----------------------------------------------------|
| 0 | **None** - Will not show any debugging information |
| 1 | **Info** - Will show minimum debugging information |
| | **Verbose** - Will show all debugging information |
| Key | Function |
|-----|----------------------------------------------------|
| 0 | **None** - Will not show any debugging information |
| 1 | **Info** - Will show minimum debugging information |
| | **Verbose** - Will show all debugging information |

In the config file, add the hosts you want to monitor, their name and the link that will be used in the website.

## config.json Examples

### ICMP Ping monitor

```json
"1" : {
"address" : "google.com",
"webpage_link" : "https://google.com",
"webpage_name" : "Google",
"monitor_type" : "icmp",
"HERC" : [""]}
```
| Key | Function |
|--------------|----------------------------------------------------------------------------------|
| address | **The hostname or address** that will be pinged |
| webpage_link | **A link for the website**. Can be blank. |
| webpage_name | **The name of the monitor** for the website. |
| monitor_type | **The type of the monitor**. In this case, **ICMP**.<br/>**This is case sensitive.** |
| ~~HERC~~ | (Expected response code) **Not used for ICMP monitors.** |
### HTTP monitor :
```json
"1" : {
"address" : "https://google.com",
"webpage_link" : "https://google.com",
"webpage_name" : "Google",
"monitor_type" : "http",
"HERC" : ["200","301"]}
```
| Key | Function |
|---------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| address | **The website that will be checked**. **Must have** protocol in front. |
| webpage_link | **A link for the website**. Can be blank. |
| webpage_name | **The name of the monitor** for the website. |
| monitor_type | **The type of the monitor**. In this case, **HTTP**.<br/>**This is case sensitive.** |
| HERC | **Expected response code**. In this case, 200 and 301.<br/>Learn more about HTTP response codes : [Mdn Web Docs](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status) |
**After the installation is done, simply go to the IP address of the server.**

0 comments on commit 611f66e

Please sign in to comment.