About

A GitHub Action to check GitHub Status in your workflow.

---

• Features
• Usage
  • Basic workflow
  • Trigger error if GitHub services are down
• Customizing
  • inputs
• License

Features

• Threshold management for each GitHub service or global (rollup)
• Display status of all services
• Display active incidents and updates

Usage

Basic workflow

The following workflow is purely informative and will only display the current status of GitHub services:

name: build

on: push

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      -
        name: Check GitHub Status
        uses: step-security/ghaction-github-status@v4
      -
        name: Checkout
        uses: actions/checkout@v6

Trigger error if GitHub services are down

In the example below, we will set some status thresholds so that the job can fail if these thresholds are exceeded.

This can be useful if you have an action that publishes to GitHub Pages, but the service is down.

name: build

on: push

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      -
        name: Check GitHub Status
        uses: step-security/ghaction-github-status@v4
        with:
          overall_threshold: minor
          pages_threshold: partial_outage
      -
        name: Checkout
        uses: actions/checkout@v6

Customizing

inputs

Following inputs can be used as step.with keys

Name	Type	Description
overall_threshold¹	String	Defines threshold for overall status (also called rollup) of GitHub to fail the job
git_threshold²	String	Defines threshold for Git Operations to fail the job
api_threshold²	String	Defines threshold for API Requests to fail the job
webhooks_threshold²	String	Defines threshold for Webhooks to fail the job
issues_threshold²	String	Defines threshold for Issues to fail the job
prs_threshold²	String	Defines threshold for Pull Requests to fail the job
actions_threshold²	String	Defines threshold for Actions to fail the job
packages_threshold²	String	Defines threshold for Packages to fail the job
pages_threshold²	String	Defines threshold for Pages to fail the job
codespaces_threshold²	String	Defines threshold for Codespaces to fail the job
copilot_threshold²	String	Defines threshold for Copilot to fail the job

• ¹ Accepted values are minor, major, critical or maintenance.
• ² Accepted values are operational, degraded_performance, partial_outage major_outage, under_maintenance.

License

MIT. See LICENSE for more details.