---
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: 844
product: Flux
version: v0
publisher: InfluxData
canonical: https://docs.influxdata.com/flux/v0/stdlib/contrib/bonitoo-io/zenoss/event/
date: '2024-04-08T16:01:02-06:00'
lastmod: '2024-04-08T16:01:02-06:00'
---

* Flux 0.108.0+

InfluxDB support

> [!Important]
> `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/)