zenoss.endpoint() function
zenoss.endpoint() is a user-contributed function maintained by
the package author.
zenoss.endpoint() sends events to Zenoss using data from input rows.
Usage
zenoss.endpoint is a factory function that outputs another function.
The output function requires a mapFn parameter.
mapFn
A function that builds the object used to generate the POST request. Requires an r parameter.
mapFn accepts a table row (r) and returns an object that must include the following fields:
- summary
- device
- component
- severity
- eventClass
- eventClassKey
- collector
- message
For more information, see zenoss.event() parameters.
Function type signature
(
url: string,
?action: A,
?apiKey: B,
?method: C,
?password: string,
?tid: D,
?type: E,
?username: string,
) => (
mapFn: (
r: F,
) => {
G with
summary: O,
severity: N,
message: M,
eventClassKey: L,
eventClass: K,
device: J,
component: I,
collector: H,
},
) => (<-tables: stream[F]) => stream[{F with _sent: string}] where B: Equatable
For more information, see Function type signatures.
Parameters
url
(Required) Zenoss router endpoint URL.
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.
Default is "add_event".
type
Event type. Default is "rpc".
tid
Temporary request transaction ID.
Default is 1.
Examples
Send critical events to Zenoss
import "contrib/bonitoo-io/zenoss"
import "influxdata/influxdb/secrets"
url = "https://tenant.zenoss.io:8080/zport/dmd/evconsole_router"
username = secrets.get(key: "ZENOSS_USERNAME")
password = secrets.get(key: "ZENOSS_PASSWORD")
endpoint = zenoss.endpoint(url: url, username: username, password: password)
crit_events =
from(bucket: "example-bucket")
|> range(start: -1m)
|> filter(fn: (r) => r._measurement == "statuses" and status == "crit")
crit_events
|> endpoint(
mapFn: (r) =>
({
summary: "Critical event for ${r.host}",
device: r.deviceID,
component: r.host,
severity: "Critical",
eventClass: "/App",
eventClassKey: "",
collector: "",
message: "${r.host} is in a critical state.",
}),
)()
Was this page helpful?
Thank you for your feedback!
Support and feedback
Thank you for being part of our community! We welcome and encourage your feedback and bug reports for Flux and this documentation. To find support, use the following resources:
Customers with an annual or support contract can contact InfluxData Support.