Event to Metric Processor
Description
This processor provides an easy way to create a new metric event within the pipeline, typically from an existing log message. The new metric event can use data from the log to generate the metric, including the value if desired.
Use
Log messages may contain embedded metrics that can be used in downstream alerting or analysis. However, extracting the metric from the log and putting it into a metric format can be a challenge.
This processor has predefined fields to build a new metric event from a log message. You could also use it to transform an existing metric event if needed.
The output of this processor is allowed to be one of the following types:
- Counter
- Sum
- Gauge
The data model corresponds to the Mezmo metric data model.
This processor drops the input event and outputs the metric event. If you want to keep the original event, wire it in parallel to another destination or processor.
Configuration
The configuration of this processor corresponds directly to the metric data model. Many of the values could be taken from the original event or from user given static values within the processor itself.
| Option | Description | Example |
|---|---|---|
| Metric Name | The name you want to give the metric, without spaces | Error_count |
| Kind | The kind of metric this event represents, either incremental or absolute | incremental |
| Type | Can be a sum, counter, or gauge | Counter |
| Value | The numeric value of the metric. Can be provided as a static or a field reference from within the incoming event. | 42 |
| Namespace | The namespace to give the metric. Can be provided as a static or a field reference from within the incoming event. | .env |
| Tag Field | Tag names to be added. More than one can be defined. Can be provided as a static or a field reference from within the incoming event. | app |
| Tag Value | The value to include for the tag. Can be provided as a static or a field reference from within the incoming event. | prod |
Interactive Demo
Check out an interactive demo of the Event to Metric Processor as a component in of an event to metric conversion Processor Group, as well as instructions for building a version of the Pipette with your own sample data in the topic Tutorial: Convert Events to Metrics. You will need to have pop-ups enabled to view the demo, or you can view it without a pop-up at mezmo.com.