beta:repeating( ) Query Function

Marks the live query the function is used in as repeating.

A repeating query is a live query that is implemented by making repeated historical queries. This can be useful when combined with functions not supported in live queries, such as selfJoin, selfJoinFilter, or certain applications of join when joining on the same repository.

When the query snapshot cache is enabled, the historical queries made by a repeating query will reuse previous results and will therefore not be as much work for Humio to execute as a regular historical query. When this happens, the update interval will be adjusted to the nearest time-bucket.

This function has no effect if used in a historical query.

This function is in beta and the behavior may change in future versions of Humio.

The feature RepeatingQueries must be enabled for this function to be available. This feature can be enabled by making the following GraphQL mutation as root from the API explorer at $YOUR_HUMIO_URL/docs/api-explorer:

  mutation {
    enableFeature(feature: RepeatingQueries)
  }

Note that if this feature is disabled later then any alert, dashboard, or saved query using beta:repeating in the query will not function.

Parameters

Name Type Required Default Description
interval string No The time interval between successive historical queries. The time span is defined as a relative time modifier. If not specified, a default interval is selected.

interval is the unnamed parameter.

Examples

repeat a query every 5 min

beta:repeating(5m)