Manage Dataset Structure

When you send data to Honeycomb, a dataset is created with a schema based on the incoming data. Adjust the dataset’s structure and settings to control how your data is organized.

Introduction 

In Honeycomb, managing your dataset’s structure ensures that your data is displayed in ways that support your analysis needs.

Managing Unique Fields 

Your dataset is created when you first send data to Honeycomb, and its unique fields are automatically generated based on the incoming data.

Tip
If you name your incoming data fields in a specific way, Honeycomb can automatically map them. To learn more about field mapping, visit Map Your Data.

By managing these unique fields, you can control how your data is structured and displayed, ensuring it meets your goals.

Modifying Field Data Types 

In Honeycomb, you can modify the data type of a field to ensure it accurately reflects the data it holds. Adjusting field data types can help improve data consistency and support more accurate analysis.

To modify a field’s data type:

  1. Log in to the Honeycomb UI.

  2. In the navigation menu, select the Environment label, then choose the environment that includes the dataset with the unique field you want to change.

  3. In the navigation menu, select Manage Data, then choose Datasets.

  4. Locate the dataset that contains the unique field you want to change, and select its name to open its settings.

  5. Go to the Schema view.

  6. Expand the Unique Fields section.

  7. Locate the field you want to change, and use the dropdown in the Type column to select a new data type.

    Tip
    In the future, if you send an event that does not match the selected data type, Honeycomb will try to coerce the value. If coercion is not possible, the value will be set to 0 instead of being dropped.

We save and apply your changes automatically.

Managing Field Visibility 

You can control the visibility of unique fields in your dataset to streamline your data and focus on the most relevant information. Hiding fields that aren’t needed helps keep your dataset clean and easy to navigate without losing data.

When you hide a field, the field will no longer display in:

Hidden fields will still display in:

  • Triggers
  • Calculated Fields (with a warning)

To hide or show a unique field:

  1. Log in to the Honeycomb UI.

  2. In the navigation menu, select the Environment label, then choose the environment that includes the dataset with the unique field for which you want to change visibility.

  3. In the navigation menu, select Manage Data, then choose Datasets.

  4. Locate the dataset that contains the unique field for which you want to change visibility, and select its name to open its settings.

  5. Go to the Schema view.

  6. Expand the Unique Fields section.

  7. Locate the field for which you want to change visibility, and locate its Hide column, then:

    • Select the checkbox to hide the field.
    • Deselect the checkbox to show the field.

We save and apply your changes automatically.

Editing Unique Fields 

You can customize the properties of your unique fields to refine your dataset’s structure.

To edit a unique field:

  1. Log in to the Honeycomb UI.

  2. In the navigation menu, select the Environment label, then choose the environment that includes the dataset with the unique field you want to change.

  3. In the navigation menu, select Manage Data, then choose Datasets.

  4. Locate the dataset that contains the unique field you want to change, and select its name to open its settings.

  5. Go to the Schema view.

  6. Expand the Unique Fields section.

  7. Locate the field you want to change, and edit its properties:

    Property Description
    Type Data type of the field.
    Hide Controls whether the field is visible in queries. Select to hide, or deselect to show.
    Description Description of the field. Maximum of 255 characters.
    Max Key Length Maximum length allowed for key names in the field.

We save and apply your changes automatically.