Manage Custom Fields

Each Environment allows you to define unique custom fields for use within it.

Tip

You can create custom fields at both the Environment and the Dataset level. All custom fields are applied at the Dataset level, but Environment-level custom fields are shared and available for you to use across all Datasets in your Environment.

What are Custom Fields?

Otherwise known as Derived Columns, custom fields are computed properties that are calculated by a formula.

The field’s value is based on the result of a formula, which can contain functions, mathematical and/or logical operations on other field values, and constants and literals, similar to expressions defined in a spreadsheet. To learn more about syntax and available functions, visit Derived Column Formula Reference.

Uses

Though functionally different, you can use custom fields in Honeycomb just as you would use other fields in your data (building queries; defining Triggers and Service Level Objectives (SLOs)). For example, you can use custom fields to express:

an event detail in a more human-readable way
business measures that may change over time
common field across services with different implementations

Some examples include:

Use a Custom Field in a Query to Compare Values

Example scenario: Your team manages a web server that handles requests with varying sizes of content. Querying with GROUP BY content_length returns a time series graph that displays the count for each value of content_length. You want to compare small requests to all other requests. Your team internally categorizes a small request as having a content_length of less than or equal to 1000.

Solution: Create a Derived Column named smallRequest with the function LTE($content_length, 1000).

When you query in Honeycomb with a GROUP BY clause of smallRequest, you receive a time series graph that displays the small requests alongside the other requests.

Use a Custom Field across Multiple Datasets

Example scenario: Your team has an Environment named “Production”, which contains Datasets named “PaymentService”, “CheckoutService”, and “SupportService”. You have defined a derived column with the same name in each Dataset:

Dataset	Derived Column Name	Formula
PaymentService	total_amount_in_usd	COALESCE($usd_total, ADD(MUL($tax_rate, $item_total), $fees))
CheckoutService	total_amount_in_usd	MUL($cart_total, $tax_rate)
SupportService	total_amount_in_usd	SUM(0)

When you query across the Production Environment in Honeycomb, you receive:

data for the PaymentService with the total_amount_in_usd values calculated with its expression
data for the CheckoutService with the total_amount_in_usd values calculated with its expression
data for the SupportService with the total_amount_in_usd values calculated with its expression

You cannot define an Environment-level Derived Column for “Production” with the name total_amount_in_usd because the name is already used by a Dataset-level Derived Column in one or more datasets.

Solution: Name the Environment-level Derived Column something unique to your Environment or change your instrumentation to rename the Derived Columns in the Datasets.

Create Derived Column

To create a Derived Column:

Log in to the Honeycomb UI.
Select the Environments label on the top-left, then select Manage Environments.
In the list, locate the Environment to which you would like to add a Derived Column, and select its name to view the available settings.
Navigate to the Define Schema view.
Select Add New Derived Column.
In the modal, enter a Display Name, which will show as the field name in the Query Builder.

Tip

Enter a display name that is unique across the containing Environment. Your Derived Column name should not match the name of any other Derived Column or any other field in any Dataset contained within the Environment.

Although Honeycomb tries to prevent duplicate field names, they can still occur. To learn more about behaviors related to name collision and solutions, visit Common Issues with Queries: Derived Columns.
In the editor, define the formula for your Derived Column. To learn more about syntax and available functions, and to explore some example formulas, visit Derived Column Formula Reference.

Hover over any syntax errors (red underlines or red triangles) for assistance with correcting them.
Select Save.

Change Derived Column

Warning

Changes to a Derived Column may affect Boards, Triggers, or SLOs.

To change a Derived Column:

Log in to the Honeycomb UI.
Select the Environments label on the top-left, then select Manage Environments.
In the list, locate the Environment that contains the Derived Column that you would like to change, and select its name to view the available settings.
Navigate to the Define Schema view.
In the list, locate the Derived Column that you want to edit, and select Edit.

If any dependencies exist, Honeycomb will prompt you to choose whether to clone or continue editing the Derived Column. If you are unsure about whether to clone or edit, reach out to the Derived Column’s most recent editor.
In the modal, modify the pre-populated name and formula as needed. To learn more about syntax and available functions, and to explore some example formulas, visit Derived Column Formula Reference.
Select Save.

Clone Derived Column

If you have a Derived Column that is similar to one you want to create, you can clone it and use it as the base for a new Derived Column. To clone a Derived Column:

Log in to the Honeycomb UI.
Select the Environments label on the top-left, then select Manage Environments.
In the list, locate the Environment that contains the Derived Column you want to clone, and select its name to view the available settings.
Navigate to the Define Schema view.
In the list, locate the Derived Column that you want to clone, and select Clone.
In the modal, modify the pre-populated name and formula as needed. To learn more about syntax and available functions, and to explore some example formulas, visit Derived Column Formula Reference.
Select Save.

Delete Derived Column