> For the complete documentation index, see [llms.txt](https://support.incidents.cloud.solarwinds.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://support.incidents.cloud.solarwinds.com/integrations/alert-source-integrations-native/buildkite.md).

# Buildkite

[<mark style="color:blue;">Buildkite</mark>](https://buildkite.com/) is a platform for running fast, secure, and scalable continuous-integration pipelines on your own infrastructure.

Route detailed alerts from Buildkite to the right users in Squadcast.

### Using Buildkite as an Alert Source

1. Navigate to **Services** -> **Service Overview** -> select or search for your Service. Expand the accordion -> In the Alert Sources section, click **Add**.

![](/files/ej4AI9zpOyFu5NZJCbwC)

2\. Select **Buildkite**. Copy the displayed **Webhook URL** to [configure](#create-a-squadcast-webhook-in-buildkite) it within **Buildkite**. Finish by clicking **Add Alert Source** -> **Done**.

![](/files/imc1jJzpbafaxuZL19jr)

{% hint style="warning" %} <mark style="color:orange;">**Important**</mark>**:**

When an alert source turns <mark style="color:green;">Active</mark>, it’ll show up under Configured Alert Sources. You can either generate a test alert from the integration or wait for a real-time alert to be generated by the Alert Source.\
\
An Alert Source is <mark style="color:green;">active</mark> if there is a recorded incident via that Alert Source for the Service.
{% endhint %}

### Create a Squadcast webhook in Buildkite

1. Login to your build kite web console and go to **Settings** tab on the top.

![](/files/YrnT0pghx5nzARiQWmr0)

2.Click on **Notification Services** on left sidebar.

![](/files/mHICTlM7XAriMyqxc4ld)

3.Click on **Add** button beside Webhook.

![](/files/C3dKBuE69soffXD2Rm4h)

4.Paste the Build Kite Webhook URL copied from the Squadcast dashboard into the **Webhook URL** field. In events, select :

```
* build.finished
* agent.connected
* agent.lost
* agent.disconnected
* agent.stopped
```

![](/files/96QdGviYrqFN4W77nfS9)

5.Configure the **Pipelines** and **Branch filtering** sections as per your requirements. 6.Finally, click on the **Add Webhook Notification**

Now whenever a build fails in Buildkite, an incident will be created automatically in Squadcast. And once the build for the same pipeline passes, all the Squadcast incidents created would get resolved automatically.

Similarly, when the agent gets disconnected / lost / stopped, an incident is created in Squadcast automatically. And once that agent is connected again, the incident is automatically resolved.

**NOTE** : The incident gets resolved automatically only if the same agent connects back. If a different agent connects, the user need to manually resolve the incident in the Squadcast Dashboard.

*Have any questions?* [*Ask the community*](https://community.squadcast.com/view/home)*.*


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://support.incidents.cloud.solarwinds.com/integrations/alert-source-integrations-native/buildkite.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
