Oxygen Mask is a Concourse Service Level Indicator (SLI) monitoring suite. It sets up pipelines that emit metrics to Datadog to verify the health of your deployment.
Before you use Oxygen Mask, you must have Datadog.
If your team does not use Datadog, contact the Concourse team for other methods for verifying and monitoring your Concourse deployment.
If you do not have a team set up for monitoring, create one by running the following command:
fly -t DEPLOYMENT-NAME set-team --team-name TEAM-NAME --local-user admin
DEPLOYMENT-NAMEis the name of your Concourse deployment
TEAM-NAMEis the name you choose for your team
From your workspace directory, clone the repository by running:
git clone https://github.com/concourse/oxygen-mask.git
Move into the directory by running:
Fetch a Datadog API key by navigating to your Datadog's Integrations > API page.
(Optional) Generate a GitHub access token. You can use this token so that you are not rate-limited in requests to Git resources. For how to do so, see Creating a personal access token for the command line.
Set up your monitoring pipelines by running the following script:
scripts/setup -n TEAM-NAME -u USERNAME -p PASSWORD -d DATADOG-API-KEY -g GITHUB-ACCESS-TOKEN -t CONCOURSE-TARGET-TO-MONITOR -x CONCOURSE-TARGET-TO-DO-THE-MONITORING
TEAM-NAMEis the name of the team you created in step 1
USERNAMEis the username for the team you created in step 1
PASSWORDis the password for the team you created in step 1
Success You should see a message saying that your monitoring pipelines have been created.