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
Where:
DEPLOYMENT-NAME
is the name of your Concourse deploymentTEAM-NAME
is the name you choose for your teamFrom your workspace directory, clone the repository by running:
git clone https://github.com/concourse/oxygen-mask.git
Move into the directory by running:
cd oxygen-mask
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
Where:
TEAM-NAME
is the name of the team you created in step 1USERNAME
is the username for the team you created in step 1PASSWORD
is the password for the team you created in step 1GITHUB-ACCESS-TOKEN
is optionalYou should see a message saying that your monitoring pipelines have been created.