The humio-metrics Repository

The humio-metrics repository is a system repository that holds metrics generated by LogScale itself. There are metrics on both system-wide scope, such as total number of live queries active, and metrics for each repository.

Note

Special access restrictions apply: a user can get access to search this repository using the same set of rules as any other repository. But any user who does not have access through those rules can search this repo, being restricted to searching only the events that directly relate to other repositories, that said user has access to. You can thus not see what other repositories may exist in LogScale through this access, and neither can you query the "global" metrics without being a member of the repository.

By default, a user can only query the humio-metrics repository for the repositories they can search. A user must be a member of the humio-metrics repository to query about all repositories.

The metrics logged into this repository are also available on JMX and Prometheus endpoints provided those are enabled. By default those listeners are disabled, whereas logging to this repository is always enabled.

On cloud, the metrics for an organization can be accessed through the humio-organization-metrics view. An organization root can query metrics for all repositories in the organization.

Metric Structure

An event within the humio-metrics repository will include the following core fields:

  • name

    The name of the metric being reported. A list of possible metrics is shown in Node-Level Metrics.

  • type

    The type of the metric, which provides an indication of the other fields that will be included within the event. For more information, see Metric Types.

Additional fields within an event will depend on the underlying type.

Metric Types

There are two major types of metrics in LogScale; node level metrics and object level metrics. Objects include repositories, ingest listeners, or storage partitions. For example ingest metrics for a given repository can be obtained by viewing ingest-bytes.

Within the individual metric types there are different event entries for different metrics that include different fields. The underlying type can be identified using the type field:

Show:

The Counter event is a count of the corresponding metric event as an integer. A metric event of this type may contain the following fields:

Field Type Description
count Integer An incremental count of the metric.