# Humio

[<mark style="color:blue;">Humio</mark>](https://www.humio.com/) is a modern log management tool with streaming observability and is built to ingest & retain streaming data as quickly as it arrives, regardless of volume.

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

### Using Humio 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 **Humio**. Copy the displayed **Webhook URL** to [configure](#create-a-squadcast-webhook-alert-in-humio) it within **Humio.** Finish by clicking **Add Alert Source** -> **Done**.

![](/files/V6tYu0LxGmUJFkwf5ThO)

{% 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 %}

### Create a Squadcast Webhook Alert in Humio

**(1)** Login to your Humio dashboard. Head over to the **Alerts** tab. Then under **Actions**, click on **+ New Action**

![](/files/FkwVby22vz3wWz0fD8NA)

**(2)** Select **Action Type** as **Webhook**. Put in the **Name**, select **Method** as **POST** and paste the previously copied Squadcast Webhook URL in the placeholder for **Endpoint URL**. Paste the payload mentioned below under the **Message Body Template** box and save it

```json
{
    "repository": "{repo_name}",
    "timestamp": "{triggered_timestamp}",
    "alert": {
    "name": "{name}",
    "description": "{description}",
    "query": {
        "queryString": "{query_string} ",
        "end": "{query_time_end}",
        "start": "{query_time_start}"
    },
    "notifierID": "{action_id}",
    "id": "{id}"
    },
    "warnings": "{warnings}",
    "numberOfEvents": {event_count},
    "url": "{url}"
}
```

![](/files/jfnieG62Xjw9zkKkw6NI)

{% hint style="info" %}
**Note: Custom Defined Variables**

Users can define custom variables under the **Message Body Template** box :

**{ "custom" : { "key" : "value" , . . . , "key" : "value" } }**

Replace the **\[key]** & **\[value]** with proper values and add at the end of the variables mentioned in **Step 2**. This is how it might look like.

**Eg. :**

```json
{
    "repository": "{repo_name}",
    "timestamp": "{triggered_timestamp}",
    "alert": {
    "name": "{name}",
    "description": "{description}",
    "query": {
        "queryString": "{query_string} ",
        "end": "{query_time_end}",
        "start": "{query_time_start}"
    },
    "notifierID": "{action_id}",
    "id": "{id}"
    },
    "warnings": "{warnings}",
    "numberOfEvents": {event_count},
    "url": "{url}",
    "custom" : {
        "key1" : "value1",
        "key2" : "value2",
        "key3" : "value3"
    }
}
```

{% endhint %}

**(3)** Now, click on **Alerts** and then on **+ New Alert**. Put in the **Name**, check the **Alert enabled** checkbox and create your **Query** accordingly. Then under **Actions**, click on the **+** icon and add the previously created action. Then click on **Create alert**

![](/files/rPAOTddE80vmXUqpBWxK)

![](/files/tOSjwjZCrGjw2xJ1V85X)

![](/files/0ECeNRk1kyjxoP8wcwpL)

That's it, you are good to go! Your Humio integration is now complete. Whenever Humio fires an alert, an incident will be created in Squadcast for it.

*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/humio.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.
