Skip to content

Commit

Permalink
Merge pull request #15020 from aeliaNR/develop
Browse files Browse the repository at this point in the history
chore: Updating Lookout documentation
  • Loading branch information
ally-sassman authored Nov 2, 2023
2 parents 914de2e + f7a5598 commit 3d41adf
Show file tree
Hide file tree
Showing 4 changed files with 56 additions and 32 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -30,6 +30,12 @@ import lookoutChangeView from 'images/platform_screenshot-crop_lookout-metrics.w

import lookoutEditQuery from 'images/platform_screenshot-full_lookout-edit-query.webp'

import diagnoseWorkloadChange from 'images/lookout-diagnose-workload-change.webp'

import diagnoseRelatedChange from 'images/lookout-diagnose-related-changes.webp'

import diagnoseSeasonality from 'images/lookout-diagnose-seasonality.webp'

New Relic Lookout gives you visibility into important deviations from across your entire digital estate.

Go to **[one.newrelic.com > New Relic Lookout](https://one.newrelic.com/nr1-core/lookout/recent-deviations)**.
Expand Down Expand Up @@ -63,6 +69,8 @@ There are two versions of New Relic Lookout:

* The global version of Lookout: This version of Lookout shows you data and deviations from across all your monitored entities. This also gives you data spanning 13-months, correlations, profiles, traces, and other details. You access this by going to **All Capabilities** and clicking on **Lookout**, and it shows up on your left-side nav.
* Requires being a full platform user.
* Requires [Pro or Enterprise edition](/docs/accounts/accounts-billing/new-relic-one-pricing-billing/new-relic-one-pricing-billing/#editions).
* If you are on Standard edition, you can still use the New Relic Lookout view in the [New Relic Explorer](/docs/new-relic-one/use-new-relic-one/core-concepts/entity-explorer-view-performance-across-apps-services-hosts). You must upgrade to a higher edition if you want to see data spanning 13-months or to visualize anomalies for custom signals views.
* Lookout for specific entities: A simpler version of Lookout that you can use to explore specific entity types. For example, you can go to **APM and services** and access Lookout, and see data and deviations for those entity types.
* Available to all user types.

Expand Down Expand Up @@ -129,38 +137,6 @@ The right side panel shows you all the entity-specific golden signals you can to
By choosing the **Browser Golden Signal** or other views, you can change from the default view. Each new view will have the golden signals appropriate for that entity type.
</figcaption>

## Drill down into the details [#explore-the-data]

To analyze an application or facet, click a circle, table row, or abnormal golden signal. When clicked, the button opens a diagnostic tool you can use to explore details about your golden signals. The details panel shows a link to the affected [entity](/docs/new-relic-one/use-new-relic-one/core-concepts/what-entity-new-relic), the golden signals over time and deviations of the performance indicator, and recent alert and deployment activity for that entity, when available.

There's also an indication of whether the selected evaluation time period would be abnormal or not in reference to other comparison time windows, such as the same time yesterday or the same time last week. This allows you to quickly see if the abnormal behavior is odd in general, or just based on the comparison time window.

There are five tabs available, and you can click on **Modify views** to show or hide individual tabs. The details of the individual tabs are outlined further.

### Workload change tab [#workload-change]

This tab helps you spot patterns in attributes that might be related to the deviation in the main entity.

You can select each individual golden signal of your entity and see how the values of its event attributes changed when the deviation began. These are presented in a collapsible section so you can focus on the ones you want to see. They're sortable based on the significance.

### Related changes tab [#related-changed]

New Relic Lookout can find other signals that began behaving differently around the same time as the selected signal for that entity type. Clicking the name of the signal reruns the analysis, focusing on that key performance indicator. This tab shows correlated behavior in the golden signals of related entities for a selected golden signal of the main entity. You can select the different golden signals and you can view signals which have a high confidence score or a low confidence. This tab displays a table format and, to dig in further, you can click through to the correlated entity.

### Seasonality tab [#seasonality]

The seasonality tab shows the changes in the selected golden signal over time and also surfaces any patterns in the anomalies that we find. Once you select the golden signal you can then view the data over an hour, a day or a week. The anomaly patterns are also presented in a table below the chart and you can click on a link to see more details of the anomaly.

### Performance tab [#performance]

This tab shows charts for other key performance indicators for the selected application or facet.

When the target is a New Relic application, we show the top transactions, error classes, external services, and database operations, alongside links to the relevant features. If there is no data for any of these, the charts are not shown.

## Traces tab [#traces]

If the entity has distributed traces configured and available in the selected evaluated time window, the **Traces** section is enabled. Each card shows a summary of a trace and can be clicked for details. **Explore all traces** links to the distributed traces application, filtered to the selected entity.

## Create a custom view [#edit-query]

To target signals and time windows beyond the default values, click the **Change view** button and select **Custom view**.
Expand Down Expand Up @@ -237,3 +213,51 @@ You can also create your own query. To do that:
Combining the information from these sections, not only can you get a sense of what is going on, but also where to focus actions to resolve the problem.
</Collapser>
</CollapserGroup>

## Diagnose anomalies with Lookout [#explore-the-data]

To analyze an application or facet, click a circle, table row, or abnormal golden signal. When clicked, the button opens a diagnostic tool you can use to explore details about your golden signals. The details panel shows a link to the affected [entity](/docs/new-relic-one/use-new-relic-one/core-concepts/what-entity-new-relic), the golden signals over time and deviations of the performance indicator, and recent alert and deployment activity for that entity, when available.

There are up to five tabs available. The details of the individual tabs are outlined further.

### Workload change tab [#workload-change]

The Workload change tab helps you spot patterns in event attributes that might be related to the deviation in the main entity.

You can select an event type to see how the values of its event attributes changed for your entity in the selected time period against the preceding same duration. A timeline visualization is provided to show the sample time period and the preceding comparison time period.

<img
title="Workload change"
alt="An image showing the workload change tab"
src={diagnoseWorkloadChange}
/>

To visualize and analyze a specific event attribute, toggle **Show detailed view**.

### Related changes tab [#related-changes]

The Related changes tab shows correlated behavior in the golden signals of related entities for a selected golden signal of the main entity. New Relic Lookout can find other signals that began behaving differently around the same time as the selected signal for that entity type. Clicking the name of the signal reruns the analysis, focusing on that key performance indicator. You can select the different golden signals and you can view signals which have a high or low confidence score. This tab displays a table format and, to dig in further, you can click through to the correlated entity.

<img
title="Related changes"
alt="An image showing the related changes tab"
src={diagnoseRelatedChange}
/>

### Seasonality tab [#seasonality]

The Seasonality tab shows the changes in the selected golden signal over time and also surfaces any patterns in the anomalies that we find. Once you select the golden signal you can then view the data over an hour, a day or a week. The anomaly patterns are also presented in a table below the chart and you can click on a link to see more details of the anomaly.

<img
title="Seasonality"
alt="An image showing the seasonality tab"
src={diagnoseSeasonality}
/>

### Performance tab [#performance]

The Performance tab shows charts for other key performance indicators for the selected application or facet. When the target is a New Relic application, we show the top transactions, error classes, external services, and database operations, alongside links to the relevant features. If there is no data for any of these, the charts are not shown.

### Traces tab [#traces]

The Traces tab is displayed only if the entity has distributed traces configured and available in the selected evaluated time window. Each card shows a summary of a trace and can be clicked for details. **Explore all traces** links to the [distributed traces application](/docs/distributed-tracing/ui-data/understand-use-distributed-tracing-ui), filtered to the selected entity.
Binary file added src/images/lookout-diagnose-related-changes.webp
Binary file not shown.
Binary file added src/images/lookout-diagnose-seasonality.webp
Binary file not shown.
Binary file added src/images/lookout-diagnose-workload-change.webp
Binary file not shown.

0 comments on commit 3d41adf

Please sign in to comment.