Skip to content

Latest commit

 

History

History
62 lines (42 loc) · 1.72 KB

README.md

File metadata and controls

62 lines (42 loc) · 1.72 KB
Raw

oncall-buddy-finder

OBF is a tool that help to integrate your monitoring system with a google calendar to manage the oncall shedule within a team.

It will fetch the oncall schedule defined in a google calendar and keep a contact file, based on a template, in sync with the schedule. The contact file is then sourced our notifications system.

The idea is to have this programm running as a service to have always the good contact notified by the monitoring system.

Templating

The template is totally customizable (handled by golang text/templates)

Notifications

It also include some notifications capabilities using a slack webhook to inform who is oncall today.

Requirements

You will need the following:

Install

cd src
go get -v -d
go run oncall-buddy-finder.go

Configuration

Configuration is handled as 3 levels (in the order of precedence):

* JSON config file
* Env vars
* default values

The program will try to guess the best config file for you:

* $CONFIG if ($CONFIG is defined)
* oncall-buddy-finder.$ENV.json (if $ENV is set)
* oncall-buddy-finder.json

Default Values

  • GoogleApiSecretFile: "client_secret.json",
  • CalendarId: "",
  • UserID: "[email protected]",
  • TimezoneName: "UTC",
  • CheckInterval (in minutes): 60,
  • BuddiesList: {},
  • SlackWebhookUrl: "",
  • SlackChannel: "#general",
  • NotificationInterval (in hours): 12,
  • FileTemplate: "/etc/oncall-buddy-finder/oncall.vars.tpl",
  • FileDest: "/var/run/oncall.vars",

Contribute

Please feel free to contribute if you think it might be changed in some ways