Create custom checks

In the UI, you can create two kinds of checks: threshold and deadman.

Using a Flux task, you can create a custom check that provides a couple advantages:

• Customize and transform the data you would like to use for the check.
• Set up custom criteria for your alert (other than threshold and deadman).

Create a task

1. In the InfluxDB UI, select Tasks in the navigation menu on the left.

   Tasks

   Tasks

2. Click Create Task, and then select New Task.

3. In the Name field, enter a descriptive name, and then enter how often to run the task in the Every field (for example, 10m). For more detail, such as using cron syntax or including an offset, see Task configuration options.

4. Enter the Flux script for your custom check, including the monitor.check function.

Example: Monitor failed tasks

The script below is fairly complex, and can be used as a framework for similar tasks. It does the following:

• Import the necessary influxdata/influxdb/monitor package, and other packages for data processing.
• Query the _tasks bucket to retrieve all statuses generated by your check.
• Set the _level to alert on, for example, crit, warn, info, or ok.
• Create a check object that specifies an ID, name, and type for the check.
• Define the ok and crit statuses.
• Execute the monitor function on the check using the task_data.

Example alert task script

import "strings"
import "regexp"
import "influxdata/influxdb/monitor"
import "influxdata/influxdb/schema"

option task = {name: "Failed Tasks Check", every: 1h, offset: 4m}

task_data = from(bucket: "_tasks")
	|> range(start: -task.every)
	|> filter(fn: (r) =>
		(r["_measurement"] == "runs"))
	|> filter(fn: (r) =>
		(r["_field"] == "logs"))
	|> map(fn: (r) => ({ r with name: strings.split(v: regexp.findString(r: /option task = \{([^\}]+)/, v: r._value), t: "\\\\\\\"")[1] }))
	|> drop(columns: ["_value", "_start", "_stop"])
	|> group(columns: ["name", "taskID", "status", "_measurement"])
	|> map(fn: (r) =>
		({r with _value: if r.status == "failed" then 1 else 0}))
	|> last()
check = {
	_check_id: "0000000000000001",      // 16 characters, alphanumeric
	_check_name: "Failed Tasks Check",  // string
	_type: "custom",                    // can also use "threshold" or "deadman"
	tags: {},
}
ok = (r) =>
	(r["logs"] == 0)
crit = (r) =>
	(r["logs"] == 1)
messageFn = (r) =>
	("The task: ${r.taskID} - ${r.name} has a status of ${r.status}")

task_data
	|> schema["fieldsAsCols"]()
	|> monitor["check"](
		data: check,
		messageFn: messageFn,
		ok: ok,
		crit: crit,
	)