1. Docs
2. Observe
3. General Health

View General Health

Honeycomb’s Home area provides a snapshot of your dataset. Home displays visualizations of some commonly-used queries and breakdowns, and an overview of your most recent traces and events. Both can be used as a jumping-off point to explore your data.

Use this view to become familiar with key system metrics and to check on the health of your systems.

Visualizations by Data Type 

Home lets you visualize the data in your dataset in different ways: as trace-specific or log-specific visualizations, and as events in a table.

Trace Visualizations 

The trace view contains these visualizations:

• Total Traces: Total number of distinct traces or requests that have been sent.
• Total Spans with Errors: Total number of spans with errors.
• 95th Percentile Latency: 95th-percentile latency of traces or requests that have been sent.

You can control the data your visualizations show by:

• selecting the desired dataset and time window
• selecting a field to group by (for charts only)

You can access additional settings and data visualization options by selecting Dataset Settings, which controls the current dataset’s settings.

Total Traces 

Both “Total Traces” visualizations display the total number of distinct traces or requests during the selected time window.

You can separate the data in your chart visualizations into groups, so you can compare data segments. To do so, select from the available fields in the accompanying dropdown. The accompanying table shows values for each group, plus the total number of traces for the given time period.

Total Spans with Errors 

Both “Total Spans with Errors” visualizations display the total number of spans with errors during the selected time window.

You can separate the data in your chart visualizations into groups, so you can compare data segments. To do so, select from the available fields in the accompanying dropdown. The accompanying table shows values for each group, plus the total number of error events for the selected time period.

95th Percentile Latency 

Both “95th Percentile Latency” visualizations display the 95th-percentile latency of traces or requests that have been sent over the selected time window.

In statistics, a percentile describes how a value compares to other values in the sample. A 95th percentile means that 95% of values in the sample are below that value. 95th percentile latency means that 95% of traces or requests are faster than that threshold value.

You can separate the data in your chart visualizations into groups, so you can compare data segments. To do so, select from the available fields in the accompanying dropdown. The accompanying table shows values for each group, plus the total 95th percentile (p95 Latency) for the given time period.

Grouping Data in Chart Visualizations 

You can quickly compare segments of key data in your chart visualizations by separating your data into groups. Grouping your data by useful fields helps you explore your data and assess the health of your system.

To group your data, select a field from a chart visualization’s accompanying dropdown. Once you have selected a field, the chart visualization’s accompanying table will populate with values for each group. This data can help you answer questions like:

• What route is erroring the most?
• What function is erroring the most?
• What user is sending the most requests?
• What route takes the longest to process a request?

Recent Traces 

In addition to data visualizations, Home displays an overview of the most recent traces in your dataset or service.

If you have sent traces into your dataset, the Recent Traces view displays the five traces with the most recent root spans for the selected service.

To inspect the spans in a trace, select the waterfall icon for the row that contains that trace; this will allow you to navigate to the trace’s waterfall diagram.

To see the breakdown of a trace by span name, hover over the Details field in the row that contains that trace.

Logs Visualizations 

The Logs view contains visualizations to help you better understand your log data and to surface signals in the noise.

• Total Logs: Displays the total number of logs received within the selected time range.

• Total Errors: Displays the total number of logs that contain error or fatal severities within the selected time range.

• Total Warnings: Displays the total number of logs with warn severities within the selected time range.

• Logs by Severity: Displays the percent of logs by severity levels within the selected time range. Only standard severities, which include fatal, error, warn, info, trace, debug, and unspecified, are distinctly represented. Other, non-standard severities are bucketed into an Other group.

  Tip

  For more insights using BubbleUp, parse your severities into Honeycomb standard severities.

• Log Volume: Displays a line graph of the log volume within the selected time range.

• Total Events by Severity: Displays the volume of logs, grouped by severity, within the selected time range. Select the table icon or chart icon to switch between displaying this data as a table or line graph.

  Note

  Non-standard severities are also displayed in this chart.

• Top Messages: Displays the most frequently occurring log messages within the selected time range. Select the table icon or chart icon to switch between displaying this data as a table or line graph. Enter a string in the search box to filter the body by that string.

• Total Errors by Severity: Displays the volume of logs where severity is error or fatal, grouped by severity, for the selected time range. Select the table icon or chart icon to switch between displaying this data as a table or line graph.

• Top Errors: Displays the most frequently occurring errors within the selected time range. Select the table icon or chart icon to switch between displaying this data as a table or line graph. Enter a string in the search box to filter the body by that string.

Grouping & Filtering 

You can slice and dice visualizations in the Logs view by selecting options within the Group by and Filter by dropdowns.

Group By 

Use the Group by dropdown to group all logs visualizations by additional fields.

To create a group:

1. From the Group by dropdown, select Customize Groups.
2. In the modal, for Property, select the field you want to be able to group your data by.
3. Enter a Display Name, and select Add Field.

Your named group will appear as an option in both the Group by and Filter by dropdowns.

To delete a group:

1. From the Group by dropdown, select Customize Groups.
2. In the modal, locate the Existing Fields section.
3. Locate the group that you want to delete, and select its trash bin icon.
4. Close the modal.

Your group will no longer appear as an option in the Group by and Filter by dropdowns.

Filter By 

Use the Filter by dropdown to filter all logs visualizations by additional fields.

To create a filter:

1. From the Filter by dropdown, select Customize Filters.
2. In the modal, for Property, select the field you want to be able to filter your data by.
3. Enter a Display Name, and select Add Field.

Your named filter will appear as an option in the Filter by and Group by dropdowns.

To delete a filter:

1. From the Filter by dropdown, select Customize Filters.
2. In the modal, locate the Existing Fields section.
3. Locate the filter that you want to delete, and select its trash bin icon.
4. Close the modal.

Your filter will no longer appear as an option in the Filter by and Group by dropdowns.

To filter by multiple values:

1. From the Filter by dropdown, select a field you would like to filter by.
2. Select the values you would like to include for the field.
3. Repeat for any other fields you would like to filter by.
4. Select Apply Filters.

Your visualizations will update and will now be restricted by your applied filters.

Chart Actions 

Use chart actions to dig deeper into the insights displayed on Honeycomb Home. Select any point on a line graph or any values in a table to open the action menu.

View Query 

Each visualization lets you navigate directly to the Query Results page for the underlying query.

To explore a visualization’s underlying query:

1. Select a point on a chart or a cell in a table.
2. From the context menu, select View Query.

You will be redirected to the Overview view on the Query Results page for the underlying query.

Detect Anomalies 

Visualizations that are grouped by fields will let you use BubbleUp to explore differences between groups:

1. On a grouped visualization, select a point on a chart or a cell in a table.
2. From the context menu, select Detect Anomalies (BubbleUp).

You will be redirected to the Anomalies view on the Query Results page for the underlying query.

Filter 

Visualizations that are grouped by fields will let you filter directly by a severity or log message group.

To filter directly by a group:

1. Select a point on a chart or a cell in a table.
2. From the context menu, select Filter to this….

Your visualizations will update and will now be restricted by your applied filter.

View Events 

Each visualization lets you navigate directly to selected events.

To explore events:

1. Select a point on a chart or a cell in a table.
2. From the context menu, select View Events.

You will be redirected to the Explore Data view on the Query Results page for the selected point.

Explore Data 

The Explore Data view lets you explore all of the events in the dataset.

Troubleshooting 

To explore common issues when working with Honeycomb Home visualizations, visit Common Issues with Visualization: Home.