# Buildkite Insights Documentation

> Buildkite documentation for pipeline and cluster insights, including waterfall views, cluster metrics, and queue monitoring.

## Pipelines

### Best practices

- [Monitoring and observability](https://buildkite.com/docs/pipelines/best-practices/monitoring-and-observability.md): Best practices for telemetry, metrics collection, alerting, log management, and integrating with observability tools.

### Agent

#### Self-hosted agents

##### Monitoring and observability

- [Overview](https://buildkite.com/docs/agent/self-hosted/monitoring-and-observability.md): Agent health checks, HTTP status endpoints, and Prometheus metrics for monitoring self-hosted agents.
- [Tracing](https://buildkite.com/docs/agent/self-hosted/monitoring-and-observability/tracing.md): Setting up distributed tracing for the Buildkite agent using Datadog APM or OpenTelemetry.

### Insights

- [Waterfall view](https://buildkite.com/docs/pipelines/insights/waterfall.md): Waterfall chart view for visualizing build job timing, wait times, agent assignment, and execution durations.
- [Cluster insights](https://buildkite.com/docs/pipelines/insights/clusters.md): Enterprise dashboard showing real-time cluster metrics: queue wait time, agent utilization, and job pass rate.
- [Queue metrics](https://buildkite.com/docs/pipelines/insights/queue-metrics.md): Real-time queue statistics showing connected agents, running/waiting/scheduled jobs, and agent utilization.

### Integrations

#### Observability

- [Overview](https://buildkite.com/docs/pipelines/integrations/observability/overview.md): Overview of observability integrations: Datadog, Honeycomb, OpenTelemetry, Amazon EventBridge, and community plugins.
- [Datadog](https://buildkite.com/docs/pipelines/integrations/observability/datadog.md): Configuring Datadog APM tracing and CI Pipeline Visibility for Buildkite Pipelines.
- [Honeycomb](https://buildkite.com/docs/pipelines/integrations/observability/honeycomb.md): Integrating Honeycomb with Buildkite using buildevents binary, OpenTelemetry tracing, or the Markers plugin.
- [OpenTelemetry](https://buildkite.com/docs/pipelines/integrations/observability/opentelemetry.md): Sending OpenTelemetry traces from Buildkite agents and the dashboard to your OTLP endpoint.
- [Amazon EventBridge](https://buildkite.com/docs/pipelines/integrations/observability/amazon-eventbridge.md): Streaming real-time build, job, and agent events to Amazon EventBridge with full event schema reference.

## See also

- [Buildkite Troubleshooting and Debugging Documentation](https://buildkite.com/docs/llms-debugging.txt): Buildkite documentation for debugging and troubleshooting builds, agents, and infrastructure, covering log output management, build annotations, terminal access, agent lifecycle, and platform-specific troubleshooting guides.
- [Buildkite Best Practices Documentation](https://buildkite.com/docs/llms-best-practices.txt): Buildkite documentation for CI/CD best practices, covering pipeline design and structure, agent management, Docker-based builds, parallelization, monorepos, dependency management, secrets, infrastructure as code, caching, monitoring, and security controls.