diff --git a/src/content/docs/query-your-data/explore-query-data/query-builder/introduction-new-data-explorer.mdx b/src/content/docs/query-your-data/explore-query-data/query-builder/introduction-new-data-explorer.mdx new file mode 100644 index 00000000000..0b374ca0344 --- /dev/null +++ b/src/content/docs/query-your-data/explore-query-data/query-builder/introduction-new-data-explorer.mdx @@ -0,0 +1,62 @@ +--- +title: Introduction to the data explorer +tags: + - Query your data + - Explore and query data + - Data explorer +metaDescription: 'The New Relic data explorer lets you run queries of your data without using NRQL-format queries' +redirects: + - /docs/query-your-data/explore-query-data/query-builder/introduction-query-builder/#query-from-anywhere + +freshnessValidatedDate: never +--- + +You can now explore all your data visually using the **query experience data explorer** without needing to know how to write [NRQL-format queries](/docs/query-your-data/nrql-new-relic-query-language/get-started/introduction-nrql-new-relics-query-language). + +Need to perform a more detailed search? Read how to [query your data](/docs/query-your-data/explore-query-data/get-started/introduction-querying-new-relic-data/). If you haven't already, create your free New Relic account to start monitoring your data today. + + +## Importance of data explorer [#importance-of-data-explorer] + +Do you research the state of your systems? Do you need to plan resources, identify and respond to incidents, or troubleshoot faulty behaviors? The data explorer makes it easy to identify, fetch and visualize the data you are looking for through visual menus, without ever using NRQL or building queries. + +With the **data explorer**, you can access all data stored in the New Relic database (NRDB) in a quick, intuitive way. You can then select facet your queries using the attributes and filter down to the needed value. + +Other things the data explorer view helps you: + +* View data from different perspectives: from raw data to various visualizations that give insights on evolution, distribution, and more. +* Drill down into data using filters. +* Add your searches to a dashboard. +* Understand how NRQL works: the Data Explorer automatically generates the NRQL queries based on your selections. + +### Types of data you can explore [#types-of-data] + +Following are the types of data you can explore using the **Data Explorer** view: + +* [Dimensional metrics](/docs/data-apis/understand-data/new-relic-data-types/#dimensional-metrics) (the Metric data type). +* [Events](/docs/data-apis/understand-data/new-relic-data-types/#events-new-relic) (the Event data type). +* [Logs](/docs/logs/ui-data/use-logs-ui) (the Log data type). + +## Explore your data [#explore-your-data] + +To access the Data Explorer, navigate to the bottom **Query your data** bar and click the **Data Explorer** icon. + +### Use the data explorer [#use-data-explorer] + +1. **Define the Scope**: Select the data type (metric, event, or log), the account, and the entities. +2. **Select the Time Range**: Use the time picker to define the time range for your query. +3. **Build Your Search**: Use the blocks on the left to browse the available data and construct your search. Blocks are searchable, and you can use the actions in the action menu to create and update your query. + +Data explorer view + +### Components of the data explorer [#data-explorer-components] + +* **Select Your Data Type**: Choose between metrics, events, logs, and accounts. If you select metrics, you can filter by entity. +* **Data Browsing Area**: Located on the left, this area allows you to navigate the data by clicking on the different values displayed on the screen or see the possible actions by clicking on the 3 dots action menu. +* **Workspace**: This area displays the results of your selections. + + diff --git a/src/content/docs/query-your-data/explore-query-data/query-builder/introduction-query-builder.mdx b/src/content/docs/query-your-data/explore-query-data/query-builder/introduction-query-builder.mdx index db8fa125ced..3893091fe0c 100644 --- a/src/content/docs/query-your-data/explore-query-data/query-builder/introduction-query-builder.mdx +++ b/src/content/docs/query-your-data/explore-query-data/query-builder/introduction-query-builder.mdx @@ -60,19 +60,6 @@ Also note that [our NerdGraph API](/docs/apis/nerdgraph/examples/nerdgraph-nrql- To find the query builder, go to **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Query builder**. -## Query from anywhere [#query-from-anywhere] - - - To access the ability to query from anywhere, you can opt-in by selecting the **Try** button on the **Query your data** page. - - -You can also access our query builder from an expandable window at the bottom of any screen in **[one.newrelic.com](https://one.newrelic.com/all-capabilities)**. Whether you're monitoring your services, troubleshooting an issue, or just browsing your platform, you can use explore your data without leaving your current view. Once enabled, just click the bottom bar of any screen within New Relic to use the console and to begin querying your data! - -A screenshot displaying the query from anywhere feature within New Relic ## Use and share charts [#customize-chart] diff --git a/src/content/docs/style-guide/writing-docs/writer-workflow/edit-automated-docs b/src/content/docs/style-guide/writing-docs/writer-workflow/edit-automated-docs new file mode 100644 index 00000000000..74cec0a4d17 --- /dev/null +++ b/src/content/docs/style-guide/writing-docs/writer-workflow/edit-automated-docs @@ -0,0 +1,35 @@ +--- +title: How to edit automatically-generated docs +--- + +Some of the teams at New Relic automatically generate docs content from their GitHub repositories. When these automatically-generated docs appear in pull requests for the main docs repository (`https://github.com/newrelic/docs-website`), writers need to edit these somewhat differently than manually generated docs. + + + You can determine whether a doc is automatically generated by looking at the author in GitHub. + + +## Challenges with editing automatically-generated docs [#challenges] + +When we edit automated documentation, this doesn't address the underlying automation that will generate the same documentation for the next release. + +We need a routine for editing docs that solves two issues: + +* Ensures that the current, automatically-generated pull request is fixed for publication. +* Ensures that the underlying source for these automatically-generated docs is changed. + +## Best practices for editing automatically generated docs [#best-practices] + +When you're reviewing docs that were generated automatically from a repository, do the following: + +1. Make GitHub suggestions instead of pushing up changes directly. +2. Contact the docs hero for the team that pushed up the changes: + * This alerts developers to the suggestions you created. + * They will accept or reject the suggestions. +3. If the suggestions are accepted, merge those changes and publish the current release. +4. If your suggestions also need to be made to the underlying source, create a Github issue in the corresponding team's repository. In that GitHub issue, link to the pull request in the public docs site. This will alert the development team to correct future automated releases. Here are some examples of repositories where you could create follow-up GitHub issues: + * Node.js (`https://github.com/newrelic/node-newrelic`) + * Ruby (`https://github.com/newrelic/newrelic-ruby-agent`) + + + For Node.js docs, you only need to create a corresponding GitHub issue if the suggestions you made were between the marker tags of an automatic doc (`{/* begin: compat-table */}` and `{/* end: compat-table */}`). Any changes outside those sections aren't affected by automation. + \ No newline at end of file diff --git a/src/nav/dashboards.yml b/src/nav/dashboards.yml index 575dd2d5a7f..f4baa36fb31 100644 --- a/src/nav/dashboards.yml +++ b/src/nav/dashboards.yml @@ -11,6 +11,8 @@ pages: path: /docs/query-your-data/explore-query-data/query-builder/introduction-query-builder - title: "Use NRQL to query your data" path: /docs/query-your-data/explore-query-data/query-builder/use-advanced-nrql-mode-query-data + - title: Introduction to the data explorer + path: /docs/query-your-data/explore-query-data/query-builder/introduction-new-data-explorer - title: Charts pages: - title: Use your charts diff --git a/src/nav/style-guide.yml b/src/nav/style-guide.yml index 732afe2303b..007b72ce816 100644 --- a/src/nav/style-guide.yml +++ b/src/nav/style-guide.yml @@ -131,6 +131,8 @@ pages: path: /docs/style-guide/writing-docs/writer-workflow/swiftype-search - title: Edit checklist path: /docs/style-guide/writing-docs/processes-procedures/docs-site-edit-checklist + - title: Edit automated docs + path: /docs/style-guide/writing-docs/writer-workflow/editing-automated-docs - title: Doc types and templates pages: - title: Agent API guide template diff --git a/static/images/data-explorer.gif b/static/images/data-explorer.gif new file mode 100644 index 00000000000..5df8906c1c9 Binary files /dev/null and b/static/images/data-explorer.gif differ