opsgenie.endpoint() function

The opsgenie.endpoint() function is a user-contributed function maintained by the package author and can be updated or removed at any time.

The opsgenie.endpoint() function sends an alert message to Opsgenie using data from table rows.

Function type: Output

import "contrib/sranka/opsgenie"

  url: "",
  apiKey: "YoUrSup3R5ecR37AuThK3y",
  entity: "example-entity"



Opsgenie API URL. Defaults to

Data type: String


Required Opsgenie API authorization key.

Data type: String


Alert entity used to specify the alert domain.

Data type: String


opsgenie.endpoint is a factory function that outputs another function. The output function requires a mapFn parameter.


A function that builds the record used to generate the POST request. Requires an r parameter.

Data type: Function

mapFn accepts a table row (r) and returns a record that must include the following fields:

  • message
  • alias
  • description
  • priority
  • responders
  • tags
  • actions
  • details
  • visibleTo

For more information, see opsgenie.sendAlert().


Send critical statuses to Opsgenie
import "influxdata/influxdb/secrets"
import "contrib/sranka/opsgenie"

apiKey = secrets.get(key: "OPSGENIE_APIKEY")
endpoint = opsgenie.endpoint(apiKey: apiKey)

crit_statuses = from(bucket: "example-bucket")
  |> range(start: -1m)
  |> filter(fn: (r) => r._measurement == "statuses" and status == "crit")

  |> endpoint(mapFn: (r) => ({
    message: "Great Scott!- Disk usage is: ${r.status}.",
      alias: "disk-usage-${r.status}",
      description: "",
      priority: "P3",
      responders: ["", "team:itcrowd"],
      tags: [],
      entity: "my-lab",
      actions: [],
      details: "{}",
      visibleTo: []

Package author and maintainer

Github: @sranka
InfluxDB Slack: @sranka

New! Cloud or OSS?

InfluxDB OSS 2.0 release candidate

InfluxDB OSS v2.0.rc includes breaking changes that require a manual upgrade from all alpha and beta versions. For information, see:

Upgrade to InfluxDB OSS v2.0.rc