Skip to content

Commit e22659e

Browse files
authored
Merge pull request #263488 from akarshprabhu/main
Added portal experience steps to enable AMS insights
2 parents 81a7b50 + fa120f6 commit e22659e

File tree

5 files changed

+22
-16
lines changed

5 files changed

+22
-16
lines changed

articles/sap/monitor/enable-sap-insights.md

Lines changed: 21 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -31,13 +31,25 @@ In this how-to-guide, learn to enable Insights in Azure Monitor for SAP solution
3131

3232
To enable Insights for Azure Monitor for SAP solutions, you need to:
3333

34-
1. [Run a PowerShell script for access](#run-a-powershell-script-for-access)
3534
1. [Prerequisite - Unprotect methods](#unprotect-the-getenvironment-method)
35+
1. [Provide required access](#provide-required-access)
3636

37-
### Run a PowerShell script for access
37+
### Unprotect the GetEnvironment method
38+
Follow steps to unprotect methods from the [NetWeaver provider configuration page](provider-netweaver.md#prerequisite-unprotect-methods-for-metrics).
39+
<br/>If you completed these steps during NetWeaver provider setup, you can skip this section. Ensure that you have unprotected the GetEnvironment method in particular for this capability to work.
40+
41+
### Provide required access
42+
In order to provide issue correlations with infrastructure, the Azure Monitor for SAP solutions(AMS) service requires Reader access over the resource groups or subscriptions that hold your SAP system infrastructure - virtual machines and virtual networks. You can assign these role assignments using one of the two methods mentioned.
3843

39-
> [!Note]
40-
> The intent of this step is to give the Azure Monitor for SAP solutions(AMS) instance access to the virtual machines that host the SAP systems you want to monitor. This will help your AMS instance correlate issues you face with Azure infrastructure telemetry, giving you an end-to-end troubleshooting experience.
44+
#### Provide access using AMS portal experience
45+
1. Open the AMS instance of your choice and visit the insights tab under Monitoring on the left navigation pane and choose to Configure Insights.
46+
:::image type="content" source="./media/enable-sap-insights/configure-insights-button.png" alt-text="Screenshot that shows the configuration button of Insights on AMS.":::
47+
1. Choose the 'Add role assignment' button to open the role assignment experience.
48+
:::image type="content" source="./media/enable-sap-insights/configure-insights-flyout.png" alt-text="Screenshot that shows the configuration flyout of Insights on AMS.":::
49+
1. Choose the scope at which you would want to assign the Reader role. You can assign the reader role to multiple resource groups at a time under a subscription scope. Make sure that the scope(s) chosen encompass the SAP system's infrastructure on Azure. Save the role assignments.
50+
:::image type="content" source="./media/enable-sap-insights/add-role-assignment.png" alt-text="Screenshot that shows the 'Add role assignment' screen of Insights on AMS.":::
51+
52+
#### Provide access using a PowerShell script
4153
This script gives your AMS instance Reader role permission over the subscriptions that hold the SAP systems. Feel free to modify the script to scope it down to a resource group or a set of virtual machines.
4254

4355
1. Download the onboarding script [from GitHub](https://github.com/Azure/Azure-Monitor-for-SAP-solutions-preview/blob/main/Scripts/AMS_AIOPS_SETUP.ps1)
@@ -69,14 +81,8 @@ $subscriptions = "<Subscription ID 1>","<Subscription ID 2>"
6981
```PowerShell
7082
.\AMS_AIOPS_SETUP.ps1 -ArmId $armId
7183
```
72-
73-
### Unprotect the GetEnvironment method
74-
75-
Follow steps to unprotect methods from the [NetWeaver provider configuration page](provider-netweaver.md#prerequisite-unprotect-methods-for-metrics).
76-
<br/>If you have already followed these steps during Netweaver provider setup, you can skip this section. Ensure that you have unprotected the GetEnvironment method in particular for this capability to work.
77-
7884
> [!Important]
79-
> You might have to wait for up to 2 hours for your AMS to start receiving metadata of the infrastructure that it needs to monitor.
85+
> You might have to wait for up to 30 minutes for your AMS to start receiving metadata of the infrastructure that it needs to monitor.
8086
8187
## Using Insights on Azure Monitor for SAP Solutions(AMS)
8288
We have two categories of issues we help you get insights for.
@@ -92,12 +98,12 @@ This capability helps you get an overview regarding availability of your SAP sys
9298
#### Steps to use availability insights
9399
1. Open the AMS instance of your choice and visit the insights tab under Monitoring on the left navigation pane.
94100
:::image type="content" source="./media/enable-sap-insights/visit-insights-tab.png" alt-text="Screenshot that shows the landing page of Insights on AMS.":::
95-
1. If you have followed all [the steps mentioned](#steps-to-enable-insights-in-azure-monitor-for-sap-solutions), you should see the above screen asking for context to be set up. You can set the Time range, SID and the provider (optional, All selected by default).
101+
1. If you completed all [the steps mentioned](#steps-to-enable-insights-in-azure-monitor-for-sap-solutions), you should see the above screen asking for context to be set up. You can set the Time range, SID and the provider (optional, All selected by default).
96102
1. On the top, you're able to see all the fired alerts related to SAP system and instance availability on this screen.
97103
:::image type="content" source="./media/enable-sap-insights/availability-overview.png" alt-text="Screenshot of the overview page of availability insights.":::
98-
1. If you're able to see SAP system availability trend, categorized by VM - SAP process list. If you have selected a fired alert in the previous step, you're able to see these trends in context with the fired alert. If not, these trends respect the time range you set on the main Time range filter.
104+
1. If you're able to see SAP system availability trend, categorized by VM - SAP process list. If you selected a fired alert in the previous step, you're able to see these trends in context with the fired alert. If not, these trends respect the time range you set on the main Time range filter.
99105
:::image type="content" source="./media/enable-sap-insights/availability-trends.png" alt-text="Screenshot of the availability trends of availability insights.":::
100-
1. You can see the Azure virtual machine on which the process is hosted and the corresponding availability trends for the combination. To view detailed insights, select the Investigate link.
106+
1. You can see the Azure virtual machine on which the process is hosted and the corresponding availability trends for the combination. To view detailed insights, select the 'Investigate' link.
101107
1. It opens a context pane that shows you availability insights on the corresponding virtual machine and the SAP application.
102108
It has two categories of insights:
103109
* Azure platform: VM health events filtered by the time range set, either by the workbook filter or the selected alert. This pane also consists of VM availability metric trend for the chosen VM.
@@ -111,7 +117,7 @@ This capability helps you get an overview regarding performance of your SAP syst
111117
1. Open the AMS instance of your choice and visit the insights tab under Monitoring on the left navigation pane.
112118
1. On the top, you're able to see all the fired alerts related to SAP application performance degradations.
113119
:::image type="content" source="./media/enable-sap-insights/performance-overview.png" alt-text="Screenshot of the overview page of performance insights.":::
114-
1. Next you're able to see key metrics related to performance issues and its trend during the timerange you have chosen.
120+
1. Next you're able to see key metrics related to performance issues and its trend during the timerange you chose.
115121
1. To view detailed insights issues, you can either choose to investigate a fired alert or view insights for a key metric.
116122
1. On investigating, you see a context pane, which shows you four categories of metrics in context of the issue/key metric chosen.
117123
* Issue/Key metric details - Detailed visualizations of the key metric that defines the problem.
20.5 KB
Loading
35.5 KB
Loading
34.4 KB
Loading

articles/sap/monitor/provider-netweaver.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -49,7 +49,7 @@ You can collect the below metric using SAP NetWeaver Provider
4949
To configure the NetWeaver provider for the current Azure Monitor for SAP solutions version, you'll need to:
5050

5151
1. [Prerequisite - Unprotect methods for metrics](#prerequisite-unprotect-methods-for-metrics)
52-
1. [Prerequisite to enable RFC metrics ](#prerequisite-to-enable-rfc-metrics)
52+
1. [Prerequisite to enable RFC metrics](#prerequisite-to-enable-rfc-metrics)
5353
1. [Add the NetWeaver provider](#adding-netweaver-provider)
5454

5555
Refer to troubleshooting section to resolve any issue faced while adding the SAP NetWeaver Provider.

0 commit comments

Comments
 (0)