<commit_before>---
title: 2017-48.x Release Notes
keywords: release notes
tags: [release notes]
sidebar: doc_sidebar
permalink: 2017_48.x_release_notes.html
summary: Learn about new and updated features in the Wavefront 2017-48.x release.
---

2017-48.x release highlights:
- The Wavefront UI now conforms to Project Clarity guidelines.
- The Wavefront Dark Theme has been renamed to Carbon Black.
- Improved Query Builder user experience
- Improved series matching
  - A new query language element, `by`, allows you to create join-by-point-tags queries. You can use the `by` element to focus the query that might otherwise be too broad to result in a match.
  - If you use a boolean query language operator such as `and`, the query language now flips the two items if it can't find a result using the original query.
- Source tagging API now ignores system tags.

## Project Clarity UI

Project Clarity is an open source design system that combines UX guidelines, patterns, and front-end code in one solution. Using Clarity for the Wavefront UI adds consistency and makes Wavefront easier to use, while keeping the existing functionality. The actual visible differences are fairly minimal. See https://vmware.github.io/clarity/.

## Improved Query Builder User Experience

Query Builder was designed to allow users easy access to query language elements. After putting together the query's skeleton, users can fine-tune the query in the Query Editor. It's not possible to go from the Query Editor to the Query Builder.

In earlier releases, you can edit the query in query builder, but as a result you enter the query editor. Users often selected the text inadvertendly, and were then unable to return to Query Builder.

Starting with this release, you can view but you cannot change queries that you build in the Query Editor. To enter the Query Editor, you click the Query Builder toggle.

![query_builder_new](images/query_builder_new.png)<commit_msg>Paul's changes to RelNotes<commit_after>---
title: 2017-48.x Release Notes
keywords: release notes
tags: [release notes]
sidebar: doc_sidebar
permalink: 2017_48.x_release_notes.html
summary: Learn about new and updated features in the Wavefront 2017-48.x release.
---

2017-48.x release highlights:
- Wavefront UI now uses Project Clarity visual theme.
- Improved Query Builder user experience
- Improved series matching
- Other improvements

## Wavefront UI and Project Clarity

Wavefront now uses the open source Clarity visual design for a consistent, user friendly experience. This change includes introduction of the new Carbon Black theme, a replacement for the Wavefront Dark Theme.

See https://vmware.github.io/clarity/.

## Improved Series Matching

- A new query language element, `by`, allows you to create join-by-point-tags queries. You can use the `by` element to focus the query that might otherwise be too broad to result in a match.
- If you use a boolean query language operator such as `and`, the query language now flips the two items if it can't find a result using the original query.

## Improved Query Builder User Experience

Query Builder helps users get started with the query language through a guided user experience. The Query Builder enables you to quickly build and run your first queries. As you use Query Builder, you can see the ts() expressions you are building – which helps you learn the query language.

In earlier releases, the ts() Query Editor was also enabled when the Query Builder was open. Users were confused about where to enter information. In this release, Wavefront displays the query being created when the Query Builder is open, but you cannot edit the query when you are in Query Builder mode.

As before, you switch to the Query Editor at any time by clicking the Query Builder icon to turn off Query Builder. 

![query_builder_new](images/query_builder_new.png)

**Note** You cannot turn on Query Builder for queries you have created or edited using the Query Editor.

## Other Improvements

- Source tagging API now ignores system tags.
{'fraction_non_alphanumeric': 0.04865398863917016, 'fraction_numerical': 0.01185477895776735, 'mean_word_length': 4.4072096128170895, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 3, 'https://': 2, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '804553', 'n_tokens_mistral': 1028, 'n_tokens_neox': 956, 'n_words': 602}