53 lines
2.3 KiB
Markdown
53 lines
2.3 KiB
Markdown
##Installatie handleiding voor server monitoring
|
|
### Agent setup
|
|
De agent setup is zeer simpel. Je kopieert de agent folder naar een server die je wil monitoren.
|
|
Voordat je de script uitvoert moet je nog wel de configuratie file aanpassen.
|
|
|
|
#### Master address
|
|
|
|
In de config.xml van
|
|
de agent kan je het address van de master server aanpassen en ook eventueel de poort. De agent
|
|
maakt gebruik van geruliere HTTP requests dus als dit beveiligd moet met HTTPS moet dat ook in het
|
|
adres ingevult worden.
|
|
|
|
#### Agent name
|
|
|
|
Zonodig kan de agent name verandert worden. Doe dit wel voor de eerste run
|
|
en nooit erna. Anders loopt de logging mis doordat het met servernamen werkt.
|
|
|
|
#### Task
|
|
|
|
Op die server stel je dan een reguliere task of cronjob in die de script automatisch uitvoert.
|
|
Een voorbeeld van een cronjob die elke minuut de script uitvoert als root.
|
|
```
|
|
* * * * * root python /opt/agent/run.py >/dev/null 2>&1
|
|
```
|
|
#### Windows
|
|
De agent kan ook op een Windows Server draaien zonder problemen. Dan moet de python interpeter wel
|
|
geinstalleerd zijn op de server samen met de dependencies.
|
|
|
|
#### 3rd party libraries Agent
|
|
Zorg ervoor dat de volgende libraries beschikbaar zijn op de server waar de agents op draaien.
|
|
- requests(https://pypi.org/project/requests/)
|
|
|
|
### Master
|
|
Om de monitoring master klaar te zetten moet er op de server een python interpeter geinstalleerd
|
|
zijn met de onderstaande libraries. Om de server te laten draaien moet je naast de run.py een
|
|
lege sqlite3 database hebben, een lege DB is meegeleverd via git.
|
|
Daarna kan je de server starten met de volgende commando. Je kunt ook eventuele configuratie opties
|
|
veranderen in config.xml
|
|
|
|
```shell
|
|
python run.py
|
|
```
|
|
|
|
### 3rd party libraries Master
|
|
Zorg ervoor dat de volgende libraries beschikbaar zijn op de server waar de master op draait.
|
|
- Flask(https://pypi.org/project/Flask/)
|
|
- Matplotlib(https://pypi.org/project/matplotlib/)
|
|
|
|
## Deployment
|
|
Meegegeven in de git repo is een salt state file. Die kun je makkelijk toevoegen aan de salt master.
|
|
Om de monitoring-agent toe te voegen aan minions moet je naast de salt state file een mapje met de
|
|
run.py en config.xml van de agent aanmaken. Daarna wordt automatisch de run.py elke minuut uitgevoerd.
|
|
Vergeet niet voor het deployen de config.xml aan te passen naar alle juiste waardes. |