tutorial

Monitoring Bitrise with Vigilmon: Build API Health, Webhook Endpoints, SSL Alerts & Status Page

How to monitor Bitrise with Vigilmon — build API availability, webhook endpoint checks, SSL certificate monitoring, and status page tracking for mobile CI/CD pipelines.

Bitrise is the mobile-first CI/CD platform trusted by iOS and Android teams worldwide — orchestrating builds, tests, code signing, and App Store deployments on every commit. When Bitrise goes down or its API degrades, mobile build pipelines stall, TestFlight submissions queue silently, and your team loses visibility into what shipped to QA. Vigilmon gives you external visibility into Bitrise before your mobile engineers notice: the build API availability, webhook endpoint health, SSL certificate expiry, and the Bitrise status page itself.

What You'll Build

  • A monitor on the Bitrise API to catch build submission failures
  • A monitor on the Bitrise status page to detect platform-wide incidents
  • An HTTP keyword monitor to track your organization's Bitrise dashboard
  • SSL certificate monitoring for custom Bitrise domains
  • An alerting setup tuned to mobile CI/CD failure modes

Prerequisites

  • An active Bitrise account with at least one iOS or Android app configured
  • A Bitrise API access token (available in Account Settings → Security → API access tokens)
  • A free account at vigilmon.online

Step 1: Verify the Bitrise API Is Responding

The Bitrise REST API is the backbone of all CI/CD integrations. Before setting up monitors, confirm it is reachable:

# Check Bitrise API with your access token
curl -H "Authorization: TOKEN your_api_token" \
  https://api.bitrise.io/v0.1/me

# Should return HTTP 200 with your account info

The Bitrise API returns HTTP 200 with a JSON payload when healthy. A 401 indicates the token is invalid. Any 5xx or connection timeout indicates API-level degradation.

API regions: Bitrise operates globally from their cloud infrastructure. Their API is at api.bitrise.io — there are no regional endpoints to configure. All API calls go through this single address.


Step 2: Create a Vigilmon HTTP Monitor for the Bitrise API

  1. Log in to VigilmonAdd Monitor → HTTP.
  2. URL: https://api.bitrise.io/v0.1/me.
  3. Check interval: 2 minutes.
  4. Response timeout: 15 seconds.
  5. Expected status: 401 (an unauthenticated request to the Bitrise API returns 401, confirming the API is up and requiring auth).
  6. Label: Bitrise API.
  7. Click Save.

Set expected status to 401 — Vigilmon's monitor hits the endpoint without your API token, so a 401 is the expected healthy response. If the API returns 5xx or times out, Vigilmon fires an alert.

This monitor catches:

  • Bitrise API outages or maintenance windows
  • Platform-wide degradation affecting build submissions
  • Rate limiting or infrastructure issues that cause API errors
  • Networking issues between Vigilmon's probes and Bitrise's infrastructure

Alert sensitivity: Set alerts to trigger after 2 consecutive failures to avoid false positives from transient network hiccups.


Step 3: Monitor the Bitrise Status Page

Bitrise publishes a public status page at https://status.bitrise.io. Monitoring it gives you an independent signal about platform-wide incidents:

  1. Add Monitor → HTTP.
  2. URL: https://status.bitrise.io.
  3. Check interval: 5 minutes.
  4. Response timeout: 15 seconds.
  5. Expected status: 200.
  6. Keyword: All Systems Operational (Bitrise displays this text when all services are healthy).
  7. Label: Bitrise status page.
  8. Click Save.

When the keyword disappears, Bitrise has posted an incident — your team gets notified by Vigilmon before they find out through Slack or social media.

Status page reliability: Status pages can themselves go down during major incidents. If both the Bitrise API monitor and the status page monitor fire simultaneously, Bitrise is experiencing a significant platform outage.


Step 4: Monitor Your Bitrise App Dashboard

Your Bitrise organization dashboard is the entry point your team uses to trigger builds and check results. If it becomes unreachable, developers can't manually trigger builds or review logs:

  1. Add Monitor → HTTP.
  2. URL: https://app.bitrise.io.
  3. Check interval: 5 minutes.
  4. Response timeout: 15 seconds.
  5. Expected status: 200.
  6. Keyword: Bitrise.
  7. Label: Bitrise dashboard.
  8. Click Save.

Login-gated pages: The Bitrise dashboard at https://app.bitrise.io serves a public-facing login page — this page is reachable without authentication and includes Bitrise in its content, making keyword monitoring effective.


Step 5: Monitor Webhook Delivery Endpoints

Bitrise triggers builds through webhooks sent from GitHub, GitLab, and Bitbucket. The webhook delivery endpoint must be reachable for push-triggered builds to work. Test the webhook URL for your app:

# Bitrise webhook delivery endpoint pattern
# https://app.bitrise.io/h/WEBHOOK_TOKEN/push

# Verify it responds (you'll get a method-not-allowed on GET, but that confirms reachability)
curl -I https://app.bitrise.io/h/your_webhook_token/push
  1. Add Monitor → HTTP.
  2. URL: https://app.bitrise.io/h/your_webhook_token/push.
  3. Check interval: 5 minutes.
  4. Expected status: 405 (Method Not Allowed — a GET to a webhook endpoint confirms it is routable; POST triggers the build).
  5. Label: Bitrise webhook endpoint.
  6. Click Save.

A 405 response means the endpoint is healthy and rejecting GETs as expected. A 404 or 5xx means the webhook URL is broken and push-triggered builds will fail silently.


Step 6: Monitor SSL Certificates

Bitrise webhook deliveries and API calls all travel over HTTPS. While Bitrise manages certificates for *.bitrise.io, monitor them to get advance warning before expiry affects your builds:

  1. Add Monitor → SSL Certificate.
  2. Domain: api.bitrise.io.
  3. Alert when expiry is within: 30 days.
  4. Alert again: 14 days, 7 days, 3 days, 1 day.
  5. Click Save.

If you use a custom domain for any Bitrise self-hosted runner or artifact proxy, add a separate SSL monitor for that domain.


Step 7: Configure Alerting

In Vigilmon under Settings → Notifications, configure your alert channels:

| Monitor | Trigger | Action | |---|---|---| | Bitrise API | Non-401 (no auth) | Check status.bitrise.io; pause CI pipelines if API is down | | Status page | Non-200 or keyword missing | Bitrise incident in progress; notify mobile team | | App dashboard | Non-200 or keyword missing | Frontend issue; check Bitrise status page | | Webhook endpoint | Non-405/200 | Webhook routing broken; push-triggered builds will fail | | SSL certificate | < 30 days to expiry | Alert; verify Bitrise cert renewal |

Alert after: 2 consecutive failures for API and dashboard monitors. 1 failure for webhook monitors — a broken webhook endpoint means every push to your repo since the failure has not triggered a build.


Common Bitrise Failure Modes and What Vigilmon Catches

| Scenario | Vigilmon monitor | |---|---| | Bitrise API outage | API monitor fires; all CI integrations fail | | Build queue degradation | Status page keyword disappears; alert before team notices | | Webhook delivery failures | Webhook endpoint monitor fires; push builds stop | | Dashboard unavailable | Dashboard monitor fires; team can't view build logs | | SSL certificate expiry | SSL monitor alerts at 30-day threshold | | Platform-wide incident | Status page + API monitors fire simultaneously | | Partial API degradation | API monitor fires while dashboard stays green | | Network routing issues | All monitors fire; likely a DNS or CDN issue |


Mobile CI/CD failures have outsized impact: a broken Bitrise pipeline means no new TestFlight builds for QA, no automated test results for the release decision, and no App Store submission. Vigilmon gives you early warning through API health, webhook reachability, and status page monitoring — so you catch Bitrise failures in seconds rather than when a QA engineer asks why there's no new build to test.

Start monitoring Bitrise in under 5 minutes — register free at vigilmon.online.

Monitor your app with Vigilmon

Free plan — 5 monitors, no credit card required. Up and running in 60 seconds.

Start free →