https://github.com/cloudfoundry-community/monitor-server-boshrelease
Bonus monit scripts to watch your BOSH VMs and raise alerts. Include in any existing BOSH deployment for bonus monitoring!
https://github.com/cloudfoundry-community/monitor-server-boshrelease
Last synced: 9 months ago
JSON representation
Bonus monit scripts to watch your BOSH VMs and raise alerts. Include in any existing BOSH deployment for bonus monitoring!
- Host: GitHub
- URL: https://github.com/cloudfoundry-community/monitor-server-boshrelease
- Owner: cloudfoundry-community
- Created: 2015-03-28T03:25:24.000Z (over 11 years ago)
- Default Branch: master
- Last Pushed: 2015-03-31T15:14:33.000Z (over 11 years ago)
- Last Synced: 2024-04-14T22:47:41.650Z (about 2 years ago)
- Language: Shell
- Homepage:
- Size: 148 KB
- Stars: 5
- Watchers: 14
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
BOSH release for monitor-server
===============================
Bonus monit scripts to watch your BOSH VMs and raise alerts. Include in any existing BOSH deployment for bonus monitoring!
Includes
- ephemeral disk alerts (`/var/vcap/data` volume)
- persistent disk alerts (`/var/vcap/store` volume)
Usage
-----
To each of your BOSH deployments, add the following:
```yaml
releases:
- name: monitor-server
version: latest
...
```
In each job that includes a persistent disk, add the `monitor-server` job template:
```yaml
jobs:
- name: postgres
templates:
- name: postgres
release: postgres
- name: monitor-server
release: monitor-server
```
See section Configuration for configuration options and the defaults.
To use this BOSH release, first upload it to your BOSH:
```
bosh upload release https://bosh.io/d/github.com/cloudfoundry-community/monitor-server-boshrelease
```
Finally, run `bosh deploy` for your modified, existing BOSH deployment manifest.
The jobs with `monitor-server` template included will now generate alerts via BOSH Health Monitor if they fill up.
Setup BOSH to send alerts
-------------------------
The documentation for BOSH shows how to configure your Micro BOSH or BOSH to send notifications to email/SMTP, Pager Duty, Data Dog, etc:
- https://bosh.io/docs/monitoring.html
- https://bosh.io/docs/hm-config.html
- https://bosh.io/docs/vm-monit.html
Configuration
-------------
You can configure all jobs or specific jobs with different alert limits.
You can configure all jobs simultaneously using global properties in your manifest:
```yaml
properties:
monitor_server:
ephemeral_disk:
alert_percent: 80
persistent_disk:
alert_percent: 80
```
Each job that includes the `monitor-server` job template can individually configured with alert limits that override the overrides above. Each deployment manifest job can have its own properties section:
```yaml
jobs:
- name: postgres
templates:
- name: postgres
release: postgres
- name: monitor-server
release: monitor-server
properties:
monitor_server:
ephemeral_disk:
alert_percent: 80
persistent_disk:
alert_percent: 80
```