Add Fields

warning

This processor has been deprecated and replaced with a new Add Fields processor that supports additional functionality and improved layout. While it will continue to function, it will no longer receive any enhancements and you should migrate to the new processor. For more information about the new processor, see here.

Description

The Add Fields processor can be used to add attributes, resources, and log record body keys from telemetry in the pipeline.

Use

The Add Fields processor is utilized for enriching telemetry data by appending or modifying attributes, resources, and log record body keys in metrics, logs, and traces based on specified conditions.

Supported Types

Metrics	Logs	Traces
✓	✓	✓

Configuration

Field	Description
Telemetry Types	The types of telemetry to apply the processor to.
Log Condition	An OTTL condition that must evaluate to true to apply this processor. By default, the processor applies to all logs.
Datapoint Condition	An OTTL condition that must evaluate to true to apply this processor to metrics. By default, the processor applies to all datapoints.
Span Condition	An OTTL condition that must evaluate to true to apply this processor. By default, the processor applies to all spans.
Resource Keys	One or more resource attribute names to add to logs.
Resource Action	`insert`: Add resource if it does not exist. `update`: Update existing value. `upsert`: Insert or update.
Attribute Keys	One or more attribute names to add to logs.
Attribute Action	`insert`: Add attribute(s) if it does not exist. `update`: Update existing value. `upsert`: Insert or update.
Body Keys	One or more body key names to add to log records.
Body Action	`insert`: Add body key(s) if it does not exist. `update`: Update existing value. `upsert`: Insert or update.

Example Configuration(s)

Append Resource to Metrics for Categorization by Source

In this configuration, additional resource data is appended to the metrics to categorize and identify them based on their source. This is particularly useful for differentiating and filtering metrics that are generated from various environments or locations.

environment: dev
location: us-east1-b

Web Interface

Add Custom Attributes to Logs for Enhanced Searchability Based on Error Status

This configuration will add custom resource (application_name) to logs that have a log level of 'ERROR'. This can help in quickly identifying and tracing critical issues within a specific or part of the application.

our example log body:

JSON

1{
2  "error": "incorrect username or password",
3  "level": "error",
4  "message": "failed to authenticate user: test",
5  "timestamp": "2023-07-05T13:40:17.549-0400"
6}

The log condition we use to determine what logs to append the resource to:

expr

1body["level"] == error

Updated 2 months ago