Skip to content

Commit b788c49

Browse files
authored
Merge pull request #258788 from AaronMaxwell/aaronmax-transaction-search-combo-article
Refactoring article to merge transaction search and diags
2 parents 885b4b7 + fcc6c74 commit b788c49

24 files changed

+64
-55
lines changed

.openpublishing.redirection.azure-monitor.json

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6394,6 +6394,11 @@
63946394
"redirect_url": "/previous-versions/azure/azure-monitor/app/tutorial-asp-net-core",
63956395
"redirect_document_id": false
63966396
},
6397+
{
6398+
"source_path_from_root": "/articles/azure-monitor/app/search-and-transaction-diagnostics.md",
6399+
"redirect_url": "/previous-versions/azure/azure-monitor/app/search-and-transaction-diagnostics-redirect",
6400+
"redirect_document_id": false
6401+
},
63976402
{
63986403
"source_path_from_root": "/articles/azure-monitor/app/tutorial-asp-net-custom-metrics.md",
63996404
"redirect_url": "/previous-versions/azure/azure-monitor/app/tutorial-asp-net-custom-metrics",

articles/azure-monitor/alerts/proactive-diagnostics.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -53,7 +53,7 @@ Alternatively, you can change the configuration by using Azure Resource Manager
5353
These diagnostic tools help you inspect the telemetry from your app:
5454

5555
* [Metric explorer](../essentials/metrics-charts.md)
56-
* [Search explorer](../app/search-and-transaction-diagnostics.md?tabs=transaction-search)
56+
* [Search explorer](../app/transaction-search-and-diagnostics.md?tabs=transaction-search)
5757
* [Analytics: Powerful query language](../logs/log-analytics-tutorial.md)
5858

5959
Smart detection is automatic, but if you want to set up more alerts, see:

articles/azure-monitor/alerts/proactive-failure-diagnostics.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -389,7 +389,7 @@ Notice that if you delete an Application Insights resource, the associated Failu
389389

390390
An alert indicates that an abnormal rise in the failed request rate was detected. It's likely that there's some problem with your app or its environment.
391391

392-
To investigate further, click on 'View full details in Application Insights' the links in this page take you straight to a [search page](../app/search-and-transaction-diagnostics.md?tabs=transaction-search) filtered to the relevant requests, exception, dependency, or traces.
392+
To investigate further, click on 'View full details in Application Insights' the links in this page take you straight to a [search page](../app/transaction-search-and-diagnostics.md?tabs=transaction-search) filtered to the relevant requests, exception, dependency, or traces.
393393

394394
You can also open the [Azure portal](https://portal.azure.com), navigate to the Application Insights resource for your app, and open the Failures page.
395395

@@ -451,7 +451,7 @@ Smart Detection of Failure Anomalies complements other similar but distinct feat
451451
These diagnostic tools help you inspect the data from your app:
452452

453453
* [Metric explorer](../essentials/metrics-charts.md)
454-
* [Search explorer](../app/search-and-transaction-diagnostics.md?tabs=transaction-search)
454+
* [Search explorer](../app/transaction-search-and-diagnostics.md?tabs=transaction-search)
455455
* [Analytics - powerful query language](../logs/log-analytics-tutorial.md)
456456

457457
Smart detections are automatic. But maybe you'd like to set up some more alerts?

articles/azure-monitor/app/api-custom-events-metrics.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -108,7 +108,7 @@ In Node.js projects, you can use `new applicationInsights.TelemetryClient(instru
108108

109109
## TrackEvent
110110

111-
In Application Insights, a *custom event* is a data point that you can display in [Metrics Explorer](../essentials/metrics-charts.md) as an aggregated count and in [Diagnostic Search](./search-and-transaction-diagnostics.md?tabs=transaction-search) as individual occurrences. (It isn't related to MVC or other framework "events.")
111+
In Application Insights, a *custom event* is a data point that you can display in [Metrics Explorer](../essentials/metrics-charts.md) as an aggregated count and in [Diagnostic Search](./transaction-search-and-diagnostics.md?tabs=transaction-search) as individual occurrences. (It isn't related to MVC or other framework "events.")
112112

113113
Insert `TrackEvent` calls in your code to count various events. For example, you might want to track how often users choose a particular feature. Or you might want to know how often they achieve certain goals or make specific types of mistakes.
114114

@@ -319,7 +319,7 @@ The recommended way to send request telemetry is where the request acts as an <a
319319

320320
## Operation context
321321

322-
You can correlate telemetry items together by associating them with operation context. The standard request-tracking module does this for exceptions and other events that are sent while an HTTP request is being processed. In [Search](./search-and-transaction-diagnostics.md?tabs=transaction-search) and [Analytics](../logs/log-query-overview.md), you can easily find any events associated with the request by using its operation ID.
322+
You can correlate telemetry items together by associating them with operation context. The standard request-tracking module does this for exceptions and other events that are sent while an HTTP request is being processed. In [Search](./transaction-search-and-diagnostics.md?tabs=transaction-search) and [Analytics](../logs/log-query-overview.md), you can easily find any events associated with the request by using its operation ID.
323323

324324
For more information on correlation, see [Telemetry correlation in Application Insights](distributed-tracing-telemetry-correlation.md).
325325

@@ -371,7 +371,7 @@ requests
371371
Send exceptions to Application Insights:
372372

373373
* To [count them](../essentials/metrics-charts.md), as an indication of the frequency of a problem.
374-
* To [examine individual occurrences](./search-and-transaction-diagnostics.md?tabs=transaction-search).
374+
* To [examine individual occurrences](./transaction-search-and-diagnostics.md?tabs=transaction-search).
375375

376376
The reports include the stack traces.
377377

@@ -464,7 +464,7 @@ exceptions
464464

465465
## TrackTrace
466466

467-
Use `TrackTrace` to help diagnose problems by sending a "breadcrumb trail" to Application Insights. You can send chunks of diagnostic data and inspect them in [Diagnostic Search](./search-and-transaction-diagnostics.md?tabs=transaction-search).
467+
Use `TrackTrace` to help diagnose problems by sending a "breadcrumb trail" to Application Insights. You can send chunks of diagnostic data and inspect them in [Diagnostic Search](./transaction-search-and-diagnostics.md?tabs=transaction-search).
468468

469469
In .NET [Log adapters](./asp-net-trace-logs.md), use this API to send third-party logs to the portal.
470470

@@ -533,7 +533,7 @@ properties.put("Database", db.ID);
533533
telemetry.trackTrace("Slow Database response", SeverityLevel.Warning, properties);
534534
```
535535

536-
In [Search](./search-and-transaction-diagnostics.md?tabs=transaction-search), you can then easily filter out all the messages of a particular severity level that relate to a particular database.
536+
In [Search](./transaction-search-and-diagnostics.md?tabs=transaction-search), you can then easily filter out all the messages of a particular severity level that relate to a particular database.
537537

538538
### Traces in Log Analytics
539539

@@ -723,7 +723,7 @@ appInsights.setAuthenticatedUserContext(validatedId, accountId);
723723

724724
In [Metrics Explorer](../essentials/metrics-charts.md), you can create a chart that counts **Users, Authenticated**, and **User accounts**.
725725

726-
You can also [search](./search-and-transaction-diagnostics.md?tabs=transaction-search) for client data points with specific user names and accounts.
726+
You can also [search](./transaction-search-and-diagnostics.md?tabs=transaction-search) for client data points with specific user names and accounts.
727727

728728
> [!NOTE]
729729
> The [EnableAuthenticationTrackingJavaScript property in the ApplicationInsightsServiceOptions class](https://github.com/microsoft/ApplicationInsights-dotnet/blob/develop/NETCORE/src/Shared/Extensions/ApplicationInsightsServiceOptions.cs) in the .NET Core SDK simplifies the JavaScript configuration needed to inject the user name as the Auth ID for each trace sent by the Application Insights JavaScript SDK.
@@ -1174,4 +1174,4 @@ Azure alerts are only on metrics. Create a custom metric that crosses a value th
11741174

11751175
## <a name="next"></a>Next steps
11761176

1177-
* [Search events and logs](./search-and-transaction-diagnostics.md?tabs=transaction-search)
1177+
* [Search events and logs](./transaction-search-and-diagnostics.md?tabs=transaction-search)

articles/azure-monitor/app/api-filtering-sampling.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -561,6 +561,6 @@ What's the difference between telemetry processors and telemetry initializers?
561561
* [JavaScript SDK](https://github.com/Microsoft/ApplicationInsights-JS)
562562

563563
## <a name="next"></a>Next steps
564-
* [Search events and logs](./search-and-transaction-diagnostics.md?tabs=transaction-search)
564+
* [Search events and logs](./transaction-search-and-diagnostics.md?tabs=transaction-search)
565565
* [sampling](./sampling.md)
566566

articles/azure-monitor/app/app-insights-overview.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ Application Insights provides many experiences to enhance the performance, relia
1919
- [Application dashboard](overview-dashboard.md): An at-a-glance assessment of your application's health and performance.
2020
- [Application map](app-map.md): A visual overview of application architecture and components' interactions.
2121
- [Live metrics](live-stream.md): A real-time analytics dashboard for insight into application activity and performance.
22-
- [Transaction search](search-and-transaction-diagnostics.md?tabs=transaction-search): Trace and diagnose transactions to identify issues and optimize performance.
22+
- [Transaction search](transaction-search-and-diagnostics.md?tabs=transaction-search): Trace and diagnose transactions to identify issues and optimize performance.
2323
- [Availability view](availability-overview.md): Proactively monitor and test the availability and responsiveness of application endpoints.
2424
- Performance view: Review application performance metrics and potential bottlenecks.
2525
- Failures view: Identify and analyze failures in your application to minimize downtime.
@@ -245,6 +245,6 @@ Review dedicated [troubleshooting articles](/troubleshoot/azure/azure-monitor/we
245245
- [Application dashboard](overview-dashboard.md)
246246
- [Application Map](app-map.md)
247247
- [Live metrics](live-stream.md)
248-
- [Transaction search](search-and-transaction-diagnostics.md?tabs=transaction-search)
248+
- [Transaction search](transaction-search-and-diagnostics.md?tabs=transaction-search)
249249
- [Availability overview](availability-overview.md)
250250
- [Users, sessions, and events](usage-segmentation.md)

articles/azure-monitor/app/app-map.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -568,5 +568,5 @@ To provide feedback, use the feedback option.
568568
## Next steps
569569

570570
* To learn more about how correlation works in Application Insights, see [Telemetry correlation](distributed-tracing-telemetry-correlation.md).
571-
* The [end-to-end transaction diagnostic experience](./search-and-transaction-diagnostics.md?tabs=transaction-diagnostics) correlates server-side telemetry from across all your Application Insights-monitored components into a single view.
571+
* The [end-to-end transaction diagnostic experience](./transaction-search-and-diagnostics.md?tabs=transaction-diagnostics) correlates server-side telemetry from across all your Application Insights-monitored components into a single view.
572572
* For advanced correlation scenarios in ASP.NET Core and ASP.NET, see [Track custom operations](custom-operations-tracking.md).

articles/azure-monitor/app/application-insights-asp-net-agent.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1039,7 +1039,7 @@ See the dedicated [troubleshooting article](/troubleshoot/azure/azure-monitor/ap
10391039

10401040
View your telemetry:
10411041
- [Explore metrics](../essentials/metrics-charts.md) to monitor performance and usage.
1042-
- [Search events and logs](./search-and-transaction-diagnostics.md?tabs=transaction-search) to diagnose problems.
1042+
- [Search events and logs](./transaction-search-and-diagnostics.md?tabs=transaction-search) to diagnose problems.
10431043
- [Use Log Analytics](../logs/log-query-overview.md) for more advanced queries.
10441044
- [Create dashboards](./overview-dashboard.md).
10451045

articles/azure-monitor/app/asp-net-dependencies.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -125,7 +125,7 @@ In the preceding cases, the proper way of validating that the instrumentation en
125125
## Where to find dependency data
126126

127127
* [Application Map](app-map.md) visualizes dependencies between your app and neighboring components.
128-
* [Transaction Diagnostics](./search-and-transaction-diagnostics.md?tabs=transaction-diagnostics) shows unified, correlated server data.
128+
* [Transaction Diagnostics](./transaction-search-and-diagnostics.md?tabs=transaction-diagnostics) shows unified, correlated server data.
129129
* [Browsers tab](javascript.md) shows AJAX calls from your users' browsers.
130130
* Select from slow or failed requests to check their dependency calls.
131131
* [Analytics](#logs-analytics) can be used to query dependency data.
@@ -230,7 +230,7 @@ Like every Application Insights SDK, the dependency collection module is also op
230230

231231
## Dependency auto-collection
232232

233-
Below is the currently supported list of dependency calls that are automatically detected as dependencies without requiring any additional modification to your application's code. These dependencies are visualized in the Application Insights [Application map](./app-map.md) and [Transaction diagnostics](./search-and-transaction-diagnostics.md?tabs=transaction-diagnostics) views. If your dependency isn't on the list below, you can still track it manually with a [track dependency call](./api-custom-events-metrics.md#trackdependency).
233+
Below is the currently supported list of dependency calls that are automatically detected as dependencies without requiring any additional modification to your application's code. These dependencies are visualized in the Application Insights [Application map](./app-map.md) and [Transaction diagnostics](./transaction-search-and-diagnostics.md?tabs=transaction-diagnostics) views. If your dependency isn't on the list below, you can still track it manually with a [track dependency call](./api-custom-events-metrics.md#trackdependency).
234234

235235
### .NET
236236

articles/azure-monitor/app/asp-net-exceptions.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -76,11 +76,11 @@ To get diagnostic data specific to your app, you can insert code to send your ow
7676

7777
Using the <xref:Microsoft.VisualStudio.ApplicationInsights.TelemetryClient?displayProperty=fullName>, you have several APIs available:
7878

79-
* <xref:Microsoft.VisualStudio.ApplicationInsights.TelemetryClient.TrackEvent%2A?displayProperty=nameWithType> is typically used for monitoring usage patterns, but the data it sends also appears under **Custom Events** in diagnostic search. Events are named and can carry string properties and numeric metrics on which you can [filter your diagnostic searches](./search-and-transaction-diagnostics.md?tabs=transaction-search).
79+
* <xref:Microsoft.VisualStudio.ApplicationInsights.TelemetryClient.TrackEvent%2A?displayProperty=nameWithType> is typically used for monitoring usage patterns, but the data it sends also appears under **Custom Events** in diagnostic search. Events are named and can carry string properties and numeric metrics on which you can [filter your diagnostic searches](./transaction-search-and-diagnostics.md?tabs=transaction-search).
8080
* <xref:Microsoft.VisualStudio.ApplicationInsights.TelemetryClient.TrackTrace%2A?displayProperty=nameWithType> lets you send longer data such as POST information.
8181
* <xref:Microsoft.VisualStudio.ApplicationInsights.TelemetryClient.TrackException%2A?displayProperty=nameWithType> sends exception details, such as stack traces to Application Insights.
8282

83-
To see these events, on the left menu, open [Search](./search-and-transaction-diagnostics.md?tabs=transaction-search). Select the dropdown menu **Event types**, and then choose **Custom Event**, **Trace**, or **Exception**.
83+
To see these events, on the left menu, open [Search](./transaction-search-and-diagnostics.md?tabs=transaction-search). Select the dropdown menu **Event types**, and then choose **Custom Event**, **Trace**, or **Exception**.
8484

8585
:::image type="content" source="./media/asp-net-exceptions/customevents.png" lightbox="./media/asp-net-exceptions/customevents.png" alt-text="Screenshot that shows the Search screen.":::
8686

@@ -165,7 +165,7 @@ Catch ex as Exception
165165
End Try
166166
```
167167

168-
The properties and measurements parameters are optional, but they're useful for [filtering and adding](./search-and-transaction-diagnostics.md?tabs=transaction-search) extra information. For example, if you have an app that can run several games, you could find all the exception reports related to a particular game. You can add as many items as you want to each dictionary.
168+
The properties and measurements parameters are optional, but they're useful for [filtering and adding](./transaction-search-and-diagnostics.md?tabs=transaction-search) extra information. For example, if you have an app that can run several games, you could find all the exception reports related to a particular game. You can add as many items as you want to each dictionary.
169169

170170
## Browser exceptions
171171

0 commit comments

Comments
 (0)