Drone CI Integration
Pipeline execution metrics, runner utilization, and build event tracking for Drone CI. Get full visibility into your Docker-native pipelines and ensure your runner fleet keeps pace with build demand.
How It Works
Configure Drone Server Webhook
Add the TigerOps webhook URL to your Drone server environment configuration via DRONE_WEBHOOK_ENDPOINT. Drone will POST build, stage, and step lifecycle events to TigerOps for every pipeline execution.
Enable Prometheus Metrics Endpoint
Set DRONE_PROMETHEUS_ANONYMOUS_ACCESS=true or configure authentication on the Drone server /metrics endpoint. Add a Prometheus scrape job or ServiceMonitor to forward runner and server metrics to TigerOps.
Add TigerOps Step to Drone Pipelines
Include the tigerops/notify plugin step in your .drone.yml to emit enriched deployment events with service name, environment, and version metadata at the point in the pipeline you choose.
Correlate Builds with Service Metrics
TigerOps matches Drone pipeline completion events with downstream metric changes in your services, automatically linking regression onset to the pipeline run that triggered the deployment.
What You Get Out of the Box
Pipeline Execution Tracking
Monitor Drone pipeline duration from trigger to completion, with per-stage and per-step breakdowns. TigerOps tracks duration trends across branches and repos, alerting when pipelines regress beyond baseline.
Runner Pool Utilization
Track runner busy and idle counts, concurrent build limits, and runner capacity across your fleet. TigerOps alerts when runner utilization consistently exceeds thresholds that would cause build queuing.
Step Failure Rate Analysis
Capture failing step names, exit codes, and error signals across all pipeline runs. TigerOps groups failures by step name and trigger branch to surface systemic instability in specific pipeline stages.
Build Queue Depth Monitoring
Monitor the depth of pending builds waiting for available runners. TigerOps alerts when queue depth indicates capacity constraints and tracks peak queue times to inform runner fleet sizing decisions.
Secrets & Registry Pull Timing
Track Docker registry pull times and secret injection latency that contribute to step startup overhead. TigerOps identifies pipelines with excessive image pull times that inflate total build duration.
Deployment Event Change Tracking
When a Drone pipeline promotes a build to production, TigerOps records a deployment change event and correlates it with APM and infrastructure metrics to detect deploy-induced regressions automatically.
Drone Server Webhook & Pipeline Plugin
Configure the Drone server webhook and add the TigerOps notify plugin to your pipeline.
# Drone Server environment variables (docker-compose or Kubernetes secret)
# DRONE_WEBHOOK_ENDPOINT=https://ingest.atatus.net/api/v1/drone/events
# DRONE_WEBHOOK_SECRET=<your-tigerops-api-key>
# DRONE_PROMETHEUS_ANONYMOUS_ACCESS=false
# DRONE_PROMETHEUS_AUTH_TOKEN=<prometheus-scrape-token>
---
# .drone.yml — TigerOps notify plugin
kind: pipeline
type: docker
name: default
steps:
- name: test
image: node:20-alpine
commands:
- npm ci
- npm test
- name: deploy
image: alpine
commands:
- ./scripts/deploy.sh
when:
branch: [main]
- name: notify-tigerops
image: plugins/tigerops
settings:
api_key:
from_secret: tigerops_api_key
service: my-api
environment: production
event_type: deployment
when:
branch: [main]
status: [success]
depends_on: [deploy]Common Questions
Does TigerOps support both Drone Cloud and self-hosted Drone Server?
TigerOps supports self-hosted Drone Server via the DRONE_WEBHOOK_ENDPOINT server webhook and the Prometheus /metrics endpoint. Drone Cloud is also supported via webhooks configured in the Drone Cloud organization settings.
Which Drone runner types does TigerOps monitor?
TigerOps collects metrics from the Drone Docker runner, Kubernetes runner, Exec runner, and SSH runner via the Drone server Prometheus metrics endpoint, which aggregates runner capacity and utilization across all runner types.
How does TigerOps receive Drone step events in real time?
Drone server fires webhook events at build start, stage start, stage stop, step start, step stop, and build complete lifecycle points. TigerOps processes these events as they arrive, giving near-real-time pipeline visibility.
Can TigerOps integrate with Drone Autoscaler?
Yes. The Drone Autoscaler also exposes a Prometheus metrics endpoint with server capacity, running count, and pending count. TigerOps scrapes this endpoint to provide a unified view of autoscaler decisions alongside pipeline queue metrics.
What data does the tigerops/notify Drone plugin send?
The notify plugin sends pipeline number, repo name, branch, commit SHA, triggering event type, build status, build duration, and any custom annotations you define via plugin environment variables. No source code or secret values are transmitted.
Full Visibility Into Your Drone CI Pipelines
Runner utilization, pipeline execution tracking, and build-to-production correlation. Set up in under 5 minutes.