90 releases

0.13.13 Mar 29, 2021
0.13.12 Sep 30, 2020
0.13.8 May 22, 2020
0.13.4 Feb 18, 2020
0.6.5 Mar 11, 2018

#445 in Data structures

25 downloads per month
Used in 4 crates

Apache-2.0/MIT

310KB
7.5K SLoC

metrix

crates.io docs.rs downloads CI license-mit license-apache

Metrics for monitoring applications and alerting.

Goal

Applications/services can have a lot of metrics and one of the greatest challenges is organizing them. This is what metrix tries to help with.

Metrix does not aim for providing exact numbers and aims for applications monitoring only.

This crate is in a very early stage and the API might still change. There may be backends provided for monitoring solutions in the future but currently only a snapshot that can be serialized to JSON is provided.

How does it work

Metrix is based on observations collected while running your application. These observations will then be sent to a backend where the actual metrics(counters etc.) are updated. For the metrics configured a snapshot can be queried.

The primary focus of metrix is to organize these metrics. There are several building blocks available. Most of them can have a name that will then be part of a path within a snapshot.

Labels

Labels link observations to panels. Labels can be of any type that implements Clone + Eq + Send + 'static. An enum is a good choice for a label.

Observations

An abservation is made somewhere within your application. When an observation is sent to the backend it must have a label attached. This label is then matched against the label of a panel to determine whether an observation is handled for updating or not.

Instruments

Instruments are gauges, meters, etc. An instrument gets updated by an observation where an update is meaningful. Instruments are grouped by Panels.

You can find instruments in the module instruments.

Panels

A Panel groups instruments under same same label. So each instrument within a panel will be updated by observations that have the same label as the panel.

Lets say you defined a label OutgoingRequests. If you are interested in the request rate and the latencies. You would then create a panel with a label OutgoingRequests and add a histogram and a meter.

Cockpit

A cockpit aggregates multiple Panels. A cockpit can be used to monitor different tasks/parts of a component or worklflow. A cockpit is bound to a label type.

An example can be that you have service component that calls an external HTTP client. You could be interested in successful calls and failed calls individually. So for both cases you would create a value for your label and then add two panels to the cockpit.

Cockpits are in the module cockpit.

Processors

The most important processor is the TelemetryProcessor. It has a label type as a type parameter and consist of a TelemetryTransmitter that sends observations to the backend(used within your app) and the actual TelemetryProcessor that forms the backend and processes observations. The TelemetryProcessor can own several cockpits for a label type.

There is also a ProcessorMount that is label agnostic and can group several processors. It can also have a name that will be included in the snapshot.

The processors can be found the module processor.

Driver

The driver owns processors and asks the owned processors to process their messages. You need to add your processors to a driver to start the machinery. A driver is also a processor which means it can have a name and it can also be part of another hierarchy.

Each driver has its own thread for polling its processors so even when attached to another hierarchy all processors registered with the driver will only be driven by that driver.

Contributing

Contributing is welcome. Criticism is also welcome!

License

Metrix is primarily distributed under the terms of both the MIT license and the Apache License (Version 2.0).

Copyright (c) 2018 Christian Douven

License: Apache-2.0/MIT

Dependencies

~1.6–2.3MB
~43K SLoC