docs-v2/content/flux/v0/stdlib/influxdata/influxdb/monitor/logs.md

2.5 KiB

title description menu weight flux/v0/tags
monitor.logs() function `monitor.logs()` retrieves notification events stored in the `notifications` measurement in the `_monitoring` bucket.
flux_v0_ref
name parent identifier
monitor.logs influxdata/influxdb/monitor influxdata/influxdb/monitor/logs
301
inputs

monitor.logs() retrieves notification events stored in the notifications measurement in the _monitoring bucket.

Function type signature
(
    fn: (
        r: {
            A with
            _value: B,
            _time: time,
            _stop: time,
            _start: time,
            _measurement: string,
            _field: string,
        },
    ) => bool,
    start: C,
    ?stop: D,
) => stream[E] where E: Record

{{% caption %}} For more information, see Function type signatures. {{% /caption %}}

Parameters

start

({{< req >}}) Earliest time to include in results.

Use a relative duration, absolute time, or integer (Unix timestamp in seconds). For example, -1h, 2019-08-28T22:00:00Z, or 1567029600. Durations are relative to now().

stop

Latest time to include in results. Default is now().

Use a relative duration, absolute time, or integer (Unix timestamp in seconds). For example, -1h, 2019-08-28T22:00:00Z, or 1567029600. Durations are relative to now().

fn

({{< req >}}) Predicate function that evaluates true or false.

Records or rows (r) that evaluate to true are included in output tables. Records that evaluate to null or false are not included in output tables.

Examples

Query notification events from the last hour

import "influxdata/influxdb/monitor"

monitor.logs(start: -2h, fn: (r) => true)