Skip to content

Commit

Permalink
fix(external services): Re-arrange intro sections and remove warning …
Browse files Browse the repository at this point in the history
…from DT
  • Loading branch information
rhetoric101 committed Jan 28, 2022
1 parent ce28c25 commit 4419d7e
Show file tree
Hide file tree
Showing 2 changed files with 13 additions and 22 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -30,19 +30,6 @@ To use the external services feature, you need a New Relic account with an insta
![Screenshot showing the opening map for external services](./images/intro-example.png "Screenshot showing the opening map for external services")
<figcaption>The thickness of the lines represents the throughput from your service to the upstream or downstream services. When you select a specific service, you will see the various endpoints making calls between the two services.</figcaption>

## Relationship to classic external services [#classic-external-services]

While you can still reach classic external services by using the UI toggle, the main external services UI is populated by data from distributed tracing. It still provides transaction data similar to classic external services, but here are some key things you need to know about the expanded external services:

* **Dependency:** To use the external services feature, you need to enable distributed tracing on services that make calls to each other.
* **Compatibility:** Distributed tracing is not backwards compatible with cross application tracing, so if you currently rely on classic external services, please note that you will only have visibility into calls between services using the same protocol.
* **Data:** Unlike classic external services, the transaction-level detail of distributed tracing is based on sampling instead of metrics. This sampled data links into distributed tracing, which can give you deeper insights into what’s driving the performance of the transactions.


<Callout variant="tip">
The external services feature does not support browser and mobile data.
</Callout>

## When would you use external services? [#when-to-use]

The external services feature is a tool you can use by itself to tune or troubleshoot a specific service. You can also use it as a starting point for additional troubleshooting with distributed tracing.
Expand All @@ -59,6 +46,19 @@ Then, you can use distributed tracing to drill into more detail:
1. Drill into distributed tracing and see in the trace that the calls in this transaction are doing something odd.
2. Jump to that transaction on service B and see that it got slow after a deploy.

## Relationship to classic external services [#classic-external-services]

While you can still reach classic external services by using the UI toggle, the main external services UI is populated by data from distributed tracing. It still provides transaction data similar to classic external services, but here are some key things you need to know about the expanded external services:

* **Dependency:** To use the external services feature, you need to enable distributed tracing on services that make calls to each other.
* **Compatibility:** Distributed tracing is not backwards compatible with cross application tracing, so if you currently rely on classic external services, please note that you will only have visibility into calls between services using the same protocol.
* **Data:** Unlike classic external services, the transaction-level detail of distributed tracing is based on sampling instead of metrics. This sampled data links into distributed tracing, which can give you deeper insights into what’s driving the performance of the transactions.


<Callout variant="tip">
The external services feature does not support browser and mobile data.
</Callout>

## What's next? [#next]

If you're ready to enable this feature, check out our [setup steps](/docs/apm/apm-ui-pages/monitoring/external-services/external-services-setup).
Original file line number Diff line number Diff line change
Expand Up @@ -29,15 +29,6 @@ Our distributed tracing improves on APM's previous [cross application tracing fe
We may provide backward compatibility with some or all of the affected features in future releases. For now, you should understand the following changes before enabling distributed tracing:

<CollapserGroup>
<Collapser
id="external-details"
title="External services page has less detail"
>
When distributed tracing is enabled for an application, external calls do not have internal transaction details at **[one.newrelic.com](https://one.newrelic.com) > APM > (select an app) > Monitor > External services > (select external service)**.

To find that information, you would instead go to the **Distributed tracing** UI page, find the external call URLs, and see what their child spans are.
</Collapser>

<Collapser
id="txn-trace-changes"
title="Transaction trace UI displays service URLs, not transaction links"
Expand Down

0 comments on commit 4419d7e

Please sign in to comment.