---
title: zenoss.event() function
description: zenoss.event() sends an event to Zenoss.
url: https://docs.influxdata.com/flux/v0/stdlib/contrib/bonitoo-io/zenoss/event/
estimated_tokens: 3116
product: Flux
version: v0
---

# zenoss.event() function

-   Flux 0.108.0+
-   View InfluxDB support

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

`zenoss.event()` sends an event to [Zenoss](https://www.zenoss.com/).

##### Function type signature

```js
(
    severity: A,
    url: string,
    ?action: B,
    ?apiKey: C,
    ?collector: D,
    ?component: E,
    ?device: F,
    ?eventClass: G,
    ?eventClassKey: H,
    ?message: I,
    ?method: J,
    ?password: string,
    ?summary: K,
    ?tid: L,
    ?type: M,
    ?username: string,
) => int where C: Equatable
```

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

## Parameters

### url

(Required) Zenoss [router endpoint URL](https://help.zenoss.com/zsd/RM/configuring-resource-manager/enabling-access-to-browser-interfaces/creating-and-changing-public-endpoints).

### username

Zenoss username to use for HTTP BASIC authentication. Default is `""` (no authentication).

### password

Zenoss password to use for HTTP BASIC authentication. Default is `""` (no authentication).

### apiKey

Zenoss cloud API key. Default is `""` (no API key).

### action

Zenoss router name. Default is “EventsRouter”.

### method

[EventsRouter method](https://help.zenoss.com/dev/collection-zone-and-resource-manager-apis/codebase/routers/router-reference/eventsrouter). Default is “add\_event”.

### type

Event type. Default is “rpc”.

### tid

Temporary request transaction ID. Default is `1`.

### summary

Event summary. Default is `""`.

### device

Related device. Default is `""`.

### component

Related component. Default is `""`.

### severity

(Required) [Event severity level](https://help.zenoss.com/zsd/RM/administering-resource-manager/event-management/event-severity-levels).

**Supported values**:

-   Critical
-   Warning
-   Info
-   Clear

### eventClass

[Event class](https://help.zenoss.com/zsd/RM/administering-resource-manager/event-management/understanding-event-classes). Default is `""`.

### eventClassKey

Event [class key](https://help.zenoss.com/zsd/RM/administering-resource-manager/event-management/event-fields). Default is `""`.

### collector

Zenoss [collector](https://help.zenoss.com/zsd/RM/administering-resource-manager/event-management/event-fields). Default is `""`.

### message

Related message. Default is `""`.

## Examples

### Send the last reported value and severity to Zenoss

```js
import "contrib/bonitoo-io/zenoss"
import "influxdata/influxdb/secrets"

username = secrets.get(key: "ZENOSS_USERNAME")
password = secrets.get(key: "ZENOSS_PASSWORD")

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

zenoss.event(
    url: "https://tenant.zenoss.io:8080/zport/dmd/evconsole_router",
    username: username,
    username: password,
    device: lastReported.host,
    component: "CPU",
    eventClass: "/App",
    severity:
        if lastReported._value < 1.0 then
            "Critical"
        else if lastReported._value < 5.0 then
            "Warning"
        else if lastReported._value < 20.0 then
            "Info"
        else
            "Clear",
)
```

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