---
title: bigpanda.sendAlert() function
description: bigpanda.sendAlert() sends an alert to BigPanda.
url: https://docs.influxdata.com/flux/v0/stdlib/contrib/rhajek/bigpanda/sendalert/
estimated_tokens: 2076
product: Flux
version: v0
---

# bigpanda.sendAlert() function

-   Flux 0.108.0+
-   View InfluxDB support

`bigpanda.sendAlert()` is a user-contributed function maintained by the [package author](#package-author-and-maintainer).

`bigpanda.sendAlert()` sends an alert to [BigPanda](https://www.bigpanda.io/).

##### Function type signature

```js
(
    appKey: A,
    rec: B,
    status: C,
    token: string,
    url: string,
) => int
```

For more information, see [Function type signatures](/flux/v0/function-type-signatures/).

## Parameters

### url

(Required) BigPanda [alerts API URL](https://docs.bigpanda.io/reference#alerts-how-it-works). Default is the value of the `bigpanda.defaultURL` option.

### token

(Required) BigPanda [API Authorization token (API key)](https://docs.bigpanda.io/docs/api-key-management).

### appKey

(Required) BigPanda [App Key](https://docs.bigpanda.io/reference#integrating-monitoring-systems).

### status

(Required) BigPanda [alert status](https://docs.bigpanda.io/reference#alerts).

Supported statuses:

-   `ok`
-   `critical`
-   `warning`
-   `acknowledged`

### rec

(Required) Additional [alert parameters](https://docs.bigpanda.io/reference#alert-object) to send to the BigPanda alert API.

## Examples

### Send the last reported value and status to BigPanda

```js
import "contrib/rhajek/bigpanda"
import "influxdata/influxdb/secrets"
import "json"

token = secrets.get(key: "BIGPANDA_API_KEY")

lastReported =
    from(bucket: "example-bucket")
        |> range(start: -1m)
        |> filter(fn: (r) => r._measurement == "example-measurement" and r._field == "level")
        |> last()
        |> findRecord(fn: (key) => true, idx: 0)

bigpanda.sendAlert(
    token: token,
    appKey: "example-app-key",
    status: bigpanda.statusFromLevel(level: "${lastReported.status}"),
    rec: {
        tags: json.encode(v: [{"name": "host", "value": "my-host"}]),
        check: "my-check",
        description: "${lastReported._field} is ${lastReported.status}: ${string(
                v: lastReported._value,
            )}",
    },
)
```

[single notification](/flux/v0/tags/single-notification/)