buildkite-metrics

README

Buildkite Metrics

A command-line tool for collecting Buildkite build/job statistics for external metrics systems. Currently AWS Cloudwatch is supported.

Installing

Either download the latest binary from buildkite-metrics/buildkite-metrics-Linux-x86_64 or install with:

go get github.com/buildkite/buildkite-metrics

Development

You can build and run the binary tool locally with golang installed:

go run *.go -org [myorg] -token [mytoken]

Currently this will publish metrics to Cloudwatch under the custom metric prefic of Buildkite, using AWS credentials from your environment. It requires the cloudwatch:PutMetricData IAM permission.

Metrics

The following metrics are gathered:

Buildkite > RunningBuildsCount
Buildkite > RunningJobsCount
Buildkite > ScheduledBuildsCount
Buildkite > ScheduledJobsCount
Buildkite > IdleAgentsCount
Buildkite > BusyAgentsCount
Buildkite > TotalAgentsCount

Buildkite > (Queue) > RunningBuildsCount
Buildkite > (Queue) > RunningJobsCount
Buildkite > (Queue) > ScheduledBuildsCount
Buildkite > (Queue) > ScheduledJobsCount
Buildkite > (Queue) > IdleAgentsCount
Buildkite > (Queue) > BusyAgentsCount
Buildkite > (Queue) > TotalAgentsCount

Buildkite > (Pipeline) > RunningBuildsCount
Buildkite > (Pipeline) > RunningJobsCount
Buildkite > (Pipeline) > ScheduledBuildsCount
Buildkite > (Pipeline) > ScheduledJobsCount

License

See LICENSE.md (MIT)