On-calls form pre-filler

Do not count your on-call hours manually again
https://heureka.github.io/on-calls-pre-fill/

About The Project

Once per month developers who has been part of on-call rotation need to count theirs on-call hours manually because reports from opsgenie does not count with country specific holidays. But this tool does. Also it automatically count all on-call hours per team, so each developer does not have to count this by himself.

(back to top)

Usage

This is very easy. Just open https://heureka.github.io/on-calls-pre-fill/

(back to top)

New team integration

If your team wants to use this tool, you need to do 3 steps:

1. export your schedule from Opsgenie (in webcal format)
2. import schedule from previous step to your google calendar and make it public
3. add configuration to window.CONFIG

Example:

      window.CONFIG = {
        TEAMS: {
          ONE_ACCOUNT: {
            TITLE: 'One Account',
            CALENDAR_ID: 'iudsi92n9lj7falv973v2kirn5t7qd6t@import.calendar.google.com',
            COUNTRY: 'CZ',
            WORKING_HOURS_START: 8, // This has to correspond with the working hours set in opsgenie
            WORKING_HOURS_END: 16, // This has to correspond with the working hours set in opsgenie
          },

Built and Deploy

This is single page app (actually just one index.html file) which have all its functionality and configuration bundled in one single file. It leverage power of Google Calendar API to load on-calls rotation calendar exported from Opsgenie.

(back to top)

Local development

You can run this project locally (even if it doesn't make much sense :).

Prequisities

• Schedule in OpsGenie 📆
• Google account 🧔‍♂️
• Enabled Google Calendar API 🔑
• docker-compose tool 🧰

Installation

1. Clone the repo

   git clone https://github.com/heureka/on-calls-pre-fill.git

2. Enable Google Calendar API:
   • follow instructions on https://support.google.com/googleapi/answer/6158862?hl=en
   • in Client ID configuration add http://127.0.0.1 to Authorized JavaScript origins and to Authorized redirect URIs
   • after you create API Key paste it to API_KEY in index.html
   • find Google Calendar API in list and enable it

     NOTE: don't forget to setup API restrictions to use only Google Calendar API

3. Run app by docker-compose up

(back to top)

Roadmap

• Count with holidays
  • Czech
  • Hungarian
  • Slovenian
• Add Support for automatic deployment
• Configuration for different working hours start/end
• Enable google form pre-filing

(back to top)

FAQ

I can't see my on-call hours from previous month, is it bug?

It is how it works. You need to be quick and fill your hours before month ends.

I can't see override in my calendar, what should i do?

Export your schedule from OpsGenie and edit your google calendar again. See that there is different webcalToken in your calendar URL. Profit.

I want new feature, what should I do?

Create new issue

I found bug, what should I do?

Create new issue.

(back to top)