Skip to content

Commit 9c25db9

Browse files
authored
Merge pull request #78810 from v-albemi/status-monitor-v2-articles-batch2
edit pass: Status monitor v2 articles batch2
2 parents 7c66563 + 1025275 commit 9c25db9

6 files changed

+257
-261
lines changed

articles/azure-monitor/app/status-monitor-v2-api-enable-monitoring.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ This article describes a cmdlet that's a member of the [Az.ApplicationMonitor Po
1919

2020
> [!IMPORTANT]
2121
> Status Monitor v2 is currently in public preview.
22-
> This preview version is provided without a service-level agreement, and we don't recommended it for production workloads. Some features might not be supported, and some might have constrained capabilities.
22+
> This preview version is provided without a service-level agreement, and we don't recommend it for production workloads. Some features might not be supported, and some might have constrained capabilities.
2323
> For more information, see [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/).
2424
2525
## Description
@@ -39,7 +39,7 @@ After you enable monitoring, we recommend that you use [Live Metrics](live-strea
3939
> - This cmdlet requires that you review and accept our license and privacy statement.
4040
4141
> [!IMPORTANT]
42-
> This cmdlet requires a PowerShell session with Admin permissions and an elevated execution policy. For more information, see [Run PowerShell as administrator with an elevated execution policy](status-monitor-v2-detailed-instructions.md#run-powershell-as-administrator-with-an-elevated-execution-policy).
42+
> This cmdlet requires a PowerShell session with Admin permissions and an elevated execution policy. For more information, see [Run PowerShell as administrator with an elevated execution policy](status-monitor-v2-detailed-instructions.md#run-powershell-as-admin-with-an-elevated-execution-policy).
4343
4444
## Examples
4545

@@ -103,7 +103,7 @@ The instrumentation engine adds overhead and is off by default.
103103
**Optional.** Use this switch to accept the license and privacy statement in headless installations.
104104

105105
### -Verbose
106-
**Common parameter.** Use this switch to output detailed logs.
106+
**Common parameter.** Use this switch to display detailed logs.
107107

108108
### -WhatIf
109109
**Common parameter.** Use this switch to test and validate your input parameters without actually enabling monitoring.
@@ -149,7 +149,7 @@ Successfully enabled Application Insights Status Monitor
149149
View your telemetry:
150150
- [Explore metrics](../../azure-monitor/app/metrics-explorer.md) to monitor performance and usage.
151151
- [Search events and logs](../../azure-monitor/app/diagnostic-search.md) to diagnose problems.
152-
- Use [analytics](../../azure-monitor/app/analytics.md) for more advanced queries.
152+
- [Use Analytics](../../azure-monitor/app/analytics.md) for more advanced queries.
153153
- [Create dashboards](../../azure-monitor/app/overview-dashboard.md).
154154

155155
Add more telemetry:
Lines changed: 38 additions & 38 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
2-
title: "Azure Status Monitor v2 API Reference: Set config | Microsoft Docs"
3-
description: Status Monitor v2 API Reference Set-ApplicationInsightsMonitoringConfig. Monitor website performance without redeploying the website. Works with ASP.NET web apps hosted on-premises, in VMs or on Azure.
2+
title: "Azure Status Monitor v2 API reference: Set config | Microsoft Docs"
3+
description: Status Monitor v2 API reference. Set-ApplicationInsightsMonitoringConfig. Monitor website performance without redeploying the website. Works with ASP.NET web apps hosted on-premises, in VMs, or on Azure.
44
services: application-insights
55
documentationcenter: .net
66
author: MS-TimothyMothra
@@ -15,39 +15,39 @@ ms.author: tilee
1515
---
1616
# Status Monitor v2 API: Set-ApplicationInsightsMonitoringConfig (v0.2.1-alpha)
1717

18-
This document describes a cmdlet that's shipped as a member of the [Az.ApplicationMonitor PowerShell module](https://www.powershellgallery.com/packages/Az.ApplicationMonitor/).
18+
This document describes a cmdlet that's a member of the [Az.ApplicationMonitor PowerShell module](https://www.powershellgallery.com/packages/Az.ApplicationMonitor/).
1919

2020
> [!IMPORTANT]
2121
> Status Monitor v2 is currently in public preview.
22-
> This preview version is provided without a service level agreement, and it's not recommended for production workloads. Certain features might not be supported or might have constrained capabilities.
23-
> For more information, see [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/)
22+
> This preview version is provided without a service-level agreement, and we don't recommend it for production workloads. Some features might not be supported, and some might have constrained capabilities.
23+
> For more information, see [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/).
2424
2525
## Description
2626

27-
Set the config file without repeating a full reinstall.
27+
Sets the config file without doing a full reinstallation.
2828
Restart IIS for your changes to take effect.
2929

3030
> [!IMPORTANT]
31-
> This cmdlet requires a PowerShell Session with Administrator permissions.
31+
> This cmdlet requires a PowerShell session with Admin permissions.
3232
3333

3434
## Examples
3535

36-
### Example with single instrumentation key
37-
In this example, all applications on the current machine will be assigned a single instrumentation key.
36+
### Example with a single instrumentation key
37+
In this example, all apps on the current computer will be assigned a single instrumentation key.
3838

3939
```powershell
4040
PS C:\> Enable-ApplicationInsightsMonitoring -InstrumentationKey xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
4141
```
4242

43-
### Example with instrumentation key map
44-
In this example,
45-
- `MachineFilter` will match the current machine using the `'.*'` wildcard.
46-
- `AppFilter='WebAppExclude'` provides a `null` InstrumentationKey. This app won't be instrumented.
47-
- `AppFilter='WebAppOne'` will assign this specific app a unique instrumentation key.
48-
- `AppFilter='WebAppTwo'` will also assign this specific app a unique instrumentation key.
49-
- Lastly, `AppFilter` also uses the `'.*'` wildcard to match all other web apps not matched by the earlier rules and assigns a default instrumentation key.
50-
- Spaces added for readability only.
43+
### Example with an instrumentation key map
44+
In this example:
45+
- `MachineFilter` matches the current computer by using the `'.*'` wildcard.
46+
- `AppFilter='WebAppExclude'` provides a `null` instrumentation key. The specified app won't be instrumented.
47+
- `AppFilter='WebAppOne'` assigns the specified app a unique instrumentation key.
48+
- `AppFilter='WebAppTwo'` assigns the specified app a unique instrumentation key.
49+
- Finally, `AppFilter` also uses the `'.*'` wildcard to match all web apps that aren't matched by the earlier rules and assign a default instrumentation key.
50+
- Spaces are added for readability.
5151

5252
```powershell
5353
PS C:\> Enable-ApplicationInsightsMonitoring -InstrumentationKeyMap
@@ -59,38 +59,38 @@ PS C:\> Enable-ApplicationInsightsMonitoring -InstrumentationKeyMap
5959
```
6060

6161

62-
## Parameters
62+
## Parameters
6363

6464
### -InstrumentationKey
65-
**Required.** Use this parameter to supply a single iKey for use by all applications on the target machine.
65+
**Required.** Use this parameter to supply a single instrumentation key for use by all apps on the target computer.
6666

6767
### -InstrumentationKeyMap
68-
**Required.** Use this parameter to supply multiple ikeys and a mapping of which apps to use which ikey.
69-
You can create a single installation script for several machines by setting the MachineFilter.
68+
**Required.** Use this parameter to supply multiple instrumentation keys and a mapping of the instrumentation keys used by each app.
69+
You can create a single installation script for several computers by setting `MachineFilter`.
7070

71-
> [!IMPORTANT]
72-
> Applications will match against rules in the order that they're provided. As such you should specify the most specific rules first and the most generic rules last.
71+
> [!IMPORTANT]
72+
> Apps will match against rules in the order that the rules are provided. So you should specify the most specific rules first and the most generic rules last.
7373
7474
#### Schema
7575
`@(@{MachineFilter='.*';AppFilter='.*';InstrumentationKey='xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx'})`
7676

77-
- **MachineFilter** is a required c# regex of the computer or vm name.
77+
- **MachineFilter** is a required C# regex of the computer or VM name.
7878
- '.*' will match all
79-
- 'ComputerName' will match only computers with that exact name.
80-
- **AppFilter** is a required c# regex of the computer or vm name.
79+
- 'ComputerName' will match only computers with the specified name.
80+
- **AppFilter** is a required C# regex of the computer or VM name.
8181
- '.*' will match all
82-
- 'ApplicationName' will match only IIS applications with that exact name.
83-
- **InstrumentationKey** is required to enable monitoring of the applications that match the above two filters.
84-
- Leave this value null if you wish to define rules to exclude monitoring
82+
- 'ApplicationName' will match only IIS apps with the specified name.
83+
- **InstrumentationKey** is required to enable monitoring of the apps that match the preceding two filters.
84+
- Leave this value null if you want to define rules to exclude monitoring.
8585

8686

8787
### -Verbose
88-
**Common Parameter.** Use this switch to output detailed logs.
88+
**Common parameter.** Use this switch to display detailed logs.
8989

9090

9191
## Output
9292

93-
No Output by default.
93+
By default, no output.
9494

9595
#### Example verbose output from setting the config file via -InstrumentationKey
9696

@@ -121,17 +121,17 @@ C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\applica
121121
## Next steps
122122

123123
View your telemetry:
124-
- [Explore metrics](../../azure-monitor/app/metrics-explorer.md) to monitor performance and usage
125-
- [Search events and logs](../../azure-monitor/app/diagnostic-search.md) to diagnose problems
126-
- [Analytics](../../azure-monitor/app/analytics.md) for more advanced queries
127-
- [Create dashboards](../../azure-monitor/app/overview-dashboard.md)
124+
- [Explore metrics](../../azure-monitor/app/metrics-explorer.md) to monitor performance and usage.
125+
- [Search events and logs](../../azure-monitor/app/diagnostic-search.md) to diagnose problems.
126+
- [Use Analytics](../../azure-monitor/app/analytics.md) for more advanced queries.
127+
- [Create dashboards](../../azure-monitor/app/overview-dashboard.md).
128128

129129
Add more telemetry:
130130
- [Create web tests](monitor-web-app-availability.md) to make sure your site stays live.
131-
- [Add web client telemetry](../../azure-monitor/app/javascript.md) to see exceptions from web page code and to let you insert trace calls.
132-
- [Add Application Insights SDK to your code](../../azure-monitor/app/asp-net.md) so that you can insert trace and log calls
131+
- [Add web client telemetry](../../azure-monitor/app/javascript.md) to see exceptions from web page code and to enable trace calls.
132+
- [Add the Application Insights SDK to your code](../../azure-monitor/app/asp-net.md) so you can insert trace and log calls
133133

134134
Do more with Status Monitor v2:
135-
- Use our guide to [Troubleshoot](status-monitor-v2-troubleshoot.md) Status Monitor v2.
135+
- Use our guide to [troubleshoot](status-monitor-v2-troubleshoot.md) Status Monitor v2.
136136
- [Get the config](status-monitor-v2-api-get-config.md) to confirm that your settings were recorded correctly.
137137
- [Get the status](status-monitor-v2-api-get-status.md) to inspect monitoring.

0 commit comments

Comments
 (0)