Automatically monitor Github Actions Workflows using Cronitor.io and a simple Github Action.

• Automatically sync workflows to Cronitor when they run, no manual configuration.

• Send telemetry to Cronitor when jobs start, complete and fail.

• Monitor every workflow in your repo, or easily limit to specific workflows.

1. Add a CRONITOR_API_KEY secret in your repo, copying your Cronitor API key from https://cronitor.io/app/settings/api

2. Add a new cronitor.yml workflow to your repo, copying this example yaml. Push the new workflow to your main branch.

3. Done! The Cronitor Monitoring Relay will be invoked automatically for every workflow that runs in your repo.

name: Cronitor Monitoring Relay

on:
  workflow_run:
    workflows: ['*']
    types: [requested,completed]

jobs:
  send-telemetry:
    runs-on: ubuntu-latest
    name: Send Telemetry
    steps:
      - name: Send execution details to the Cronitor for Github Actions agent
        uses: cronitorio/monitor-github-actions@v7
        with:
          event: ${{ toJSON(github.event) }}
          github_token: ${{ secrets.GITHUB_TOKEN }}
          cronitor_key: ${{ secrets.CRONITOR_API_KEY }}
          cronitor_group: actions
          cronitor_notify: devops-alerts

Note: Log relay is coming soon.

By default, when you add the YAML for the Cronitor Monitoring Relay as an Action, it will be invoked automatically for every workflow that runs in this repo. If you want to limit which workflows are monitored by Cronitor, you can specify those directly in the on clause of your Cronitor workflow yaml:

on:
  workflow_run:
    workflows: [job1,job2]
    types: [requested,completed]

Alert recipients can be managed directly from this configuration file using the optional cronitor_notify input. Provide a notification list using its key, or specify a single recipient, e.g. email:[email protected].

After adding the Cronitor Relay yaml, your workflows will appear on your Cronitor dashboard the first time they run. From the dashboard, you will be able to customize alert preferences, including:

• Be alerted only if a workflow persistently fails
• Be alerted if a workflow does not run or complete at least once in a given time span.
• Be alerted on workflow execution time and avoid surprise charges from Github.