Free Report! Gartner® Hype Cycle™ for Monitoring and Observability.Read more

Lookup Fields


The Lookup Fields processsor can be used to add matching telemetry fields from a CSV file.


The Lookup Fields processsor is used to dynamically add fields based on an existing telemetry value. For each unit of telemetry processed, this processor will grab the value of a field and perform a lookup using a CSV file. If that value exists, the processor will add all other fields associated with that CSV row.

Supported Types

MetricsLogsTracesBindPlane Agent


CSVThe CSV file used to perform a lookup operation.
ContextThe context of the lookup operation. The source field must exist here in order to perform a lookup. If a lookup succeeds, all matching fields are also added to this location.
FieldThe field to lookup in the specified context. A lookup operation is performed if the name and value of this field match a header and value in the CSV file.

Example Configuration(s)

Adding Fields Based on Host

In this configuration, the processor will perform a lookup on the value of all incoming metrics. If this field exists on the resource of a metric and the specified CSV file contains a matching value with that header, all other fields in that CSV row will be added to the metric. For example, in this particular configuration, if a metric has a value of MacBook-Pro-4.local for, the corresponding values for region and env will automatically be added to the same context.

Web Interface

observIQ docs - Lookup Fields - image 1

Example CSV