elastic / elastic/integrations

[New Integration] Buildkite

Open
#18,165 2 comments 0 reactions 0 assignees View on GitHub
enhancement Integration:buildkite New Integration Team:Security-Service Integrations
Dominant language
Handlebars
Stars
333
Forks
647
Avg merge
3d 4h
Merged PRs (30d)
209

Description

## Description

[Buildkite](https://buildkite.com/) is a CI/CD platform. Organization-level audit log events capture administrative and security-sensitive actions: pipeline lifecycle, user and team management, secret access and configuration, SSO, API token management, cluster/agent token changes, user account security events, Test Engine suite lifecycle, package registry lifecycle, and related governance activity.

The use cases supported include monitoring pipeline, secret and token changes; user and team membership/access changes; and correlation with other telemetry in Elastic Security.
Audit events can be fetched via the Buildkite GraphQL API.

## Architecture
Elastic Agent cel input polls the Buildkite GraphQL endpoint `https://graphql.buildkite.com/v1`.
The integration collects all organization audit event types surfaced by the API (**~150 `AuditEventType` values** in one **`buildkite.audit`** stream), including at minimum these **categories** (non-exhaustive):

- **Organization management** — members, invitations, settings
- **Pipeline management** — create/update/delete, schedules, visibility, webhooks
- **Secrets** — create/update/delete; **reads** (**`SECRET_READ`**)
- **Teams** — membership and resource access
- **SSO** — provider lifecycle and configuration
- **API tokens** — create/revoke/update and org access changes
- **Clusters and agents** — cluster/queue/token and permission changes
- **User account** — password reset/TOTP/email changes
- **Test Engine** — suite lifecycle events
- **Package registries** — registry lifecycle events

## References

- [Buildkite GraphQL API](https://buildkite.com/docs/apis/graphql-api)
- [Audit log](https://buildkite.com/docs/platform/audit-log)

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.