Skip to content

reecetech/healthchecks-action

Use this GitHub action with your project
Add this Action to an existing workflow or create a new one
View on Marketplace

Repository files navigation

healthchecks-action

This GitHub Action provides seamless integration with Healthchecks.io, allowing you to monitor the health of your scheduled jobs and workflows. It automatically sends pings to your designated Healthchecks.io URL at both the beginning and end of a job's execution, ensuring you're always aware of its status.

The initial ping is sent as part of a pre-action step, so you should place the Healthchecks Ping action after whatever is important in your workflow.


Inputs

INPUT TYPE REQUIRED DEFAULT DESCRIPTION
ping-url string true Healthchecks ping URL
run-status string false "success" Run status, either "success" or
"failure"

Usage

Add this action to the end of your workflow as shown below:

- name: Healthchecks Ping
  uses: reecetech/healthchecks-action@v0
  with:
    ping-url: <healthcheck ping url>
    run-status: ${{ job.status }}

How It Works

  1. Send Start Ping: At the beginning of the job (pre-action), the action sends a "start" ping to Healthchecks using the provided ping-url.
  2. Generate UUID: A unique identifier (UUID) is generated to track the job execution.
  3. Send Success Ping: If the job succeeds, the main action step sends a "finish" ping to Healthchecks to indicate success.
  4. Send Failure Ping: If the job fails, the post-action step sends a "fail" ping to Healthchecks to indicate failure.

Important Notes

  1. Don't run the Healthchecks action with if: always() otherwise you'll get undesirable behaviour.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors