# Sensu Go

Follow the steps below to configure a service so as to push related alert data from Sensu Go onto Squadcast.

Squadcast will then process this information to create incidents for this service as per your preferences.

### Using Sensu Go 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 **Sensu Go.** Copy the displayed **Webhook URL** to [configure](#squadcast-handler-installation) it within **Sensu Go**. Finish by clicking **Add Alert Source** -> **Done.**

![](/files/pk8NCmIjHdrpGmHNLpbh)

{% hint style="warning" %}
**Important:**

When an alert source turns Active, 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 active if there is a recorded incident via that Alert Source for the Service.
{% endhint %}

#### Squadcast handler installation

If you're using sensuctl 5.13 with Sensu Backend 5.13 or later, you can use the following command to add the asset:

```
sensuctl asset add sensu/sensu-squadcast-handler
```

**Installation from source**

Download the latest version of the sensu-squadcast-handler from releases, or create an executable script by cloning the [sensu-squadcast-handler](https://github.com/SquadcastHub/sensu-squadcast-handler.git) repository. From the local path of the sensu-squadcast-handler repository run the following command:

{% hint style="warning" %}
**Important**

For the command mentioned below to work, you would need **Go Programming Language** installed beforehand.
{% endhint %}

```
go build -o /usr/local/bin/sensu-squadcast-handler
```

Create a `squadcast-handler.yaml` file like the following :-

```yaml
type: Handler
api_version: core/v2
metadata:
  name: squadcast
  namespace: default
spec:
  command: sensu-squadcast-handler
  env_vars:
  - SENSU_SQUADCAST_APIURL= <Squadcast Alert Source Url>
  runtime_assets:
  - SquadcastHub/sensu-squadcast-handler
  filters:
  - is_incident 
  timeout: 10
  type: pipe
```

Make sure to replace `<Squadcast Alert Source Url>` with the webhook url you copied from Squadcast.

Then run the following command :-

```
sensuctl create -f squadcast-handler.yaml
```

While creating checks for your client systems make sure to add `squadcast` as a handler. An example check using the squadcast handler is shown below :-

```yaml
api_version: core/v2
type: CheckConfig
metadata:
  namespace: default
  name: health-check
spec:
  command: check-http -u http://localhost:8080/health
  subscriptions:
  - test
  publish: true
  interval: 10
  handlers:
  - squadcast
```

Now whenever an event is triggered in Sensu Go , an incident will be created automatically in Squadcast. Also when an event is resolved in Sensu Go the corresponding incident gets **auto-resolved in Squadcast.**

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


---

# Agent Instructions: 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:

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

The question should be specific, self-contained, and written in natural language.
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.
