Scott Anderson [InfluxData] | Flux Alerts and Notifications | InfluxDays NA 2021

Flux Alerts &
Notiﬁcations
Scott Anderson
Senior Technical Writer & Technical Lead of
the Docs team @ InﬂuxData

© 2021 InfluxData Inc. All Rights Reserved.
Goals
● Demystify Flux notifications
● Explain notification conventions
● Demonstrate notifications in raw Flux

* *

5
Notiﬁcation packages

Each notification package
An endpoint function
A function that outputs a function that iterates over all input rows
and generates another function that sends a notification for each
input row.
Notification function
A function that sends a single notification.

slack package
slack.endpoint()
slack.message()
pagerduty package
pagerduty.endpoint()
pagerduty.sendEvent()

Notiﬁcation Conventions
● One-off convention
● Map convention
● Endpoint convention

9
One-off convention

sendFn(...)

import "slack"

import "slack"
slack.message(...)

import "slack"
slack.message(
url: "https://slack.com/api/chat.postMessage",
token: "mYSuP3rSecR37T0kEN",
channel: "#mychannel",
text: "Hey, here's a message!",
color: "danger"
)

import "slack"
lastReported = data |> last() |> findRecord(fn: (key) => true, idx: 0)
slack.message(
text: "The last reported value was ${lastReported._value}.",
color: "#000"
)

15
Map Convention

map(fn: (r) => ({ r with sent: sendFn(...) }))

import "slack"
data

import "slack"
data
|> map(fn: (r) => ({ ... }))

import "slack"
data
|> map(fn: (r) => ({ r with sent: ... }))

import "slack"
data
|> map(fn: (r) => ({ r with sent:
slack.message(
text: "Oh no! *${r.tag} had a value of *${r._value}*.",
color: "danger"
}))

21
Endpoint convention

endpointFn(...) => (mapFn) => (tables=<-)

import "slack"
data
|> slack.endpoint(...)

import "slack"
data
|> slack.endpoint(
token: "mYSuP3rSecR37T0kEN"
)

import "slack"
data
|> slack.endpoint(
)(mapFn: (r) => ({
color: "danger"
}))

import "slack"
data
|> slack.endpoint(
)(mapFn: (r) => ({
color: "danger"
}))()

import "influxdata/influxdb/monitor"
import "influxdata/influxdb/secrets"
import "slack"
notification_data = {...}
token = secrets.get(key: "SLACK_TOKEN")
endpoint = slack.endpoint(token: token)(mapFn: (r) => ({
color: "#000"
}))
monitor.from(start: -1h, fn: (r) => r._level == "crit”)
|> monitor.notify(endpoint: endpoint, data: notification_data)

29
Custom notiﬁcations

http.post(
url: "...",
headers: "...",
data: bytes(v: "...")
)

import "http"
tweet = (status, oauth) => {
}

import "http"
apiURL = "https://api.twitter.com/1.1/statuses/update.json"
}

import "http"
return http.post(
)
}

import "http"
return http.post(
url: "${apiURL}?status=${http.pathEscape(inputString: status)}"
headers:
{Authorization: "OAuth ${oauth}"}
)
}

import "http"
tweet = (status, oauth) => {...}
tweet(
status: "This tweet was created by Flux and InfluxDB!",
oauth: "..."
)

import "http"
oauth: "..."
data
|> map(fn: (r) => ({ r with sent:
}))

import "http"
oauth: "..."
data
|> map(fn: (r) => ({ r with sent: tweet(
status: "At ${r._time}, ${r._field} was ${r._value}.",
oauth: oauth
)
}))

http.endpoint(url: "...") =>
(mapFn: (r) => ({ headers: "...", data: bytes(v: "...") })) =>
(tables=<-)

import "http"
import "influxdata/influxdb/monitor"
oauth = "..."
notification_data = {...}
endpoint = http.endpoint(
url: "${apiURL}"
)(mapFn: (r) => ({
url: "${apiURL}?status=${http.pathEscape(inputString: r._message)}",
headers: {Authorization: "OAuth ${oauth}"},
data: bytes(v: "")
}))
monitor.from(start: -1h)
|> monitor.notify(endpoint: endpoint, data: notification_data)

Demo!

Questions?

Thank You

Scott Anderson [InfluxData] | Flux Alerts and Notifications | InfluxDays NA 2021

Scott Anderson [InfluxData] | Flux Alerts and Notifications | InfluxDays NA 2021

Recommended

More Related Content

What's hot

What's hot(20)

Similar to Scott Anderson [InfluxData] | Flux Alerts and Notifications | InfluxDays NA 2021

Similar to Scott Anderson [InfluxData] | Flux Alerts and Notifications | InfluxDays NA 2021(20)

More from InfluxData

More from InfluxData(20)

Recently uploaded

Recently uploaded(20)

Scott Anderson [InfluxData] | Flux Alerts and Notifications | InfluxDays NA 2021