From a6dbb9e3b01d0c4903a6faccd46356f1c3b52c46 Mon Sep 17 00:00:00 2001 From: twang Date: Wed, 4 Dec 2024 12:45:24 -0500 Subject: [PATCH] docs(NR-290692): update docs around how markers are included on NRQL charts --- .../change-tracking-view-analyze.mdx | 39 +++++++++++++++++-- 1 file changed, 35 insertions(+), 4 deletions(-) diff --git a/src/content/docs/change-tracking/change-tracking-view-analyze.mdx b/src/content/docs/change-tracking/change-tracking-view-analyze.mdx index 553d9026eb91..a0d82a64d3b8 100644 --- a/src/content/docs/change-tracking/change-tracking-view-analyze.mdx +++ b/src/content/docs/change-tracking/change-tracking-view-analyze.mdx @@ -34,19 +34,50 @@ Before you jump into the details here about how to view and analyze the impact o If you land on a dashboard or entity summary page and don't see the tracked change you're expecting, check your time picker selection. It might be outside the window you are looking at. - * If you are still not seeing the markers that you're expecting, please verify whether you have added those Change tracking events to the entities relevant to the chart. Do note that charts are usually driven by a NRQL query and "entities relevant to the chart" are derived from the query based on the following logic: - * entities that are directly specified in the query for the chart using either an `IN` or `=` operator (e.g. queries with an `WHERE entity.guid IN ('MTE2NjAxMzJ8QVBNfEFQUExJQ0FUSU9OfDEyMDk1MjY5')` clause). While we use `entity.guid` as an example, other properties may also be used to explicitly designate entities for the query. They are... + * If you are still not seeing the markers that you're expecting, please verify whether you have added those change events to the entities relevant to the chart. Do note that charts are usually driven by a NRQL query (you can see the query for the chart by clicking on the three-dots at the tile's top-right corner) and "entities relevant to the chart" are derived from the query based on the following logic: + * Entities that are directly specified in the query for the chart using either an `IN` or `=` operator (e.g. queries with an `WHERE entity.guid IN ('MTE2NjAxMzJ8QVBNfEFQUExJQ0FUSU9OfDEyMDk1MjY5')` clause). While we use `entity.guid` as an example, other properties may also be used to explicitly designate entities for the query. They are: * `entity.guid` * `entityGuid` - * `appName` * `entity.name` * `entityName` - * entities that are [related](https://docs.newrelic.com/docs/new-relic-solutions/new-relic-one/core-concepts/what-entity-new-relic/#related-entities) to entities specified via the method above. Only the following relationship-types are considered... + * `appName` + * `service.name` + * Entities that are [related](https://docs.newrelic.com/docs/new-relic-solutions/new-relic-one/core-concepts/what-entity-new-relic/#related-entities) to entities specified via the method above. Only the following relationship-types are considered: * `CALLS` * `SERVES` * `IS` * `CONTAINS` * `HOSTS` + + Please be advised that __NRQL queries for charts are currently scoped to a single account__. This means that if you specify entity-GUIDs belonging to multiple accounts, only markers from a single account will be visualized. + + For example, let's say that the query for your chart looks like the following: + ``` + FROM Transaction SELECT count(*) WHERE entityGuid IN ('MTE2NjAxMzJ8QVBNfEFQUExJQ0FUSU9OfDg0MTY1OTI','MTEwNjI2OTl8QVBNfEFQUExJQ0FUSU9OfDg5ODEwMDk5') TIMESERIES MAX SINCE 2 weeks AGO + ``` + Markers from both entities will show up on the chart. Additionally, markers from related-entities will also be included on the chart. To determine the list of related-entities, you can run a GraphQL query similar to the example below: + ``` + { + actor { + entity(guid: "MTEwNjI2OTl8QVBNfEFQUExJQ0FUSU9OfDg5ODEwMDk5") { + relatedEntities( + filter: {relationshipTypes: {include: [CALLS, SERVES, IS, CONTAINS, HOSTS]}} + ) { + results { + type + source { + guid + } + target { + guid + } + } + } + } + } + } + ``` + * **Entity sidebar:** To see a table of changes, click on **Change tracking** for any entity that has recorded changes. It features a time range selector and table filtering and sorting options. Use these to narrow the field of changes or to find a specific change. Note that you may need to adjust the selected time range on this page to see tracked changes. Also, by default the table will only lazy load up to 2,000 changes. Keep this in mind as you're filtering, searching, and adjusting your time range. * **New Relic & Detection:** If your change is related to an issue, you'll see it listed in the **Root Cause Analysis** section of the **Issues** page.