Merge pull request #285175 from suzuber/suzuber/refresh-sap-monitor-2024

Update about-azure-monitor-sap-solutions.md

Author: Court72

articles/sap/monitor/about-azure-monitor-sap-solutions.md

@@ -6,7 +6,7 @@ ms.service: sap-on-azure
 ms.subservice: sap-monitor
 ms.topic: overview
 ms.custom: subject-monitoring
-ms.date: 10/27/2022
+ms.date: 08/21/2024
 ms.author: jushiman
 #Customer intent: As a developer, I want to learn how to monitor my SAP resources on Azure so that I can better understand their availability, performance, and operation.
 ---

articles/sap/monitor/data-reference.md

@@ -7,7 +7,7 @@ ms.author: jushiman
 ms.service: sap-on-azure
 ms.subservice: sap-monitor
 ms.custom: subject-monitoring
-ms.date: 10/27/2022
+ms.date: 08/21/2024
 ---
 
 # Data reference for Azure Monitor for SAP solutions 
@@ -20,7 +20,7 @@ Azure Monitor for SAP solutions doesn't support metrics.
 
 ## Azure Monitor logs tables
 
-This section refers to all of the Azure Monitor Logs Kusto tables relevant to Azure Monitor for SAP solutions and available for query by Log Analytics. Azure Monitor for SAP solutions uses custom logs. The schemas for some tables are defined by third-party providers, such as SAP. Here are the current custom logs for Azure Monitor for SAP solutions with links to sources for more information.
+This section refers to all of the Azure Monitor Logs Kusto tables relevant to Azure Monitor for SAP solutions and available for query by Log Analytics. Azure Monitor for SAP solutions uses custom logs. The schemas for some tables are defined by non-Microsoft providers, such as SAP. Here are the current custom logs for Azure Monitor for SAP solutions with links to sources for more information.
 
 ### SapHana_HostConfig_CL
 

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

@@ -5,7 +5,7 @@ author: akarshprabhu
 ms.service: sap-on-azure
 ms.subservice: sap-monitor
 ms.topic: how-to
-ms.date: 05/10/2023
+ms.date: 08/21/2024
 ms.author: akak
 #Customer intent: I am an SAP BASIS or cloud infrastructure team member, I want to enable SAP Insights on my Azure monitor for SAP Instance.
 ---
@@ -14,7 +14,7 @@ ms.author: akak
 
 [!INCLUDE [Azure Monitor for SAP solutions public preview notice](./includes/preview-sap-insights.md)]
 
-The Insights capability in Azure Monitor for SAP Solutions helps you troubleshoot Availability and Performance issues on your SAP workloads. It helps you correlate key SAP components issues with SAP logs, Azure platform metrics and health events. 
+The Insights capability in Azure Monitor for SAP Solutions helps you troubleshoot Availability and Performance issues on your SAP workloads. It helps you correlate key SAP components issues with SAP logs, Azure platform metrics, and health events. 
 In this how-to-guide, learn to enable Insights in Azure Monitor for SAP solutions. You can use SAP Insights with only the latest version of the service, *Azure Monitor for SAP solutions* and not *Azure Monitor for SAP solutions (classic)*
 
 > [!NOTE]
@@ -65,7 +65,7 @@ cd <script_path>
 ```PowerShell
 $armId = "<AMS ARM ID>"
 ```
-7.	If the VMs belong to a different subscription than AMS, set the list of subscriptions in which VMs of the SAP system are present (use subscription IDs): 
+7.	If the virtual machines (VMs) belong to a different subscription than AMS, set the list of subscriptions in which VMs of the SAP system are present (use subscription IDs): 
 ```PowerShell
 $subscriptions = "<Subscription ID 1>","<Subscription ID 2>"
 ```
@@ -98,7 +98,7 @@ This capability helps you get an overview regarding availability of your SAP sys
 #### Steps to use availability insights
 1.	Open the AMS instance of your choice and visit the insights tab under Monitoring on the left navigation pane. 
 :::image type="content" source="./media/enable-sap-insights/visit-insights-tab.png" alt-text="Screenshot that shows the landing page of Insights on AMS.":::
-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).
+1. If you completed all [the steps mentioned](#steps-to-enable-insights-in-azure-monitor-for-sap-solutions), you should see the screen shown in step 1 asking for context to be set up. You can set the Time range, SID, and the provider (optional, All selected by default).
 1.	On the top, you're able to see all the fired alerts related to SAP system and instance availability on this screen. 
 :::image type="content" source="./media/enable-sap-insights/availability-overview.png" alt-text="Screenshot of the overview page of availability insights.":::
 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. 
@@ -108,7 +108,7 @@ This capability helps you get an overview regarding availability of your SAP sys
 It has two categories of insights:
     * 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.
     :::image type="content" source="./media/enable-sap-insights/availability-vm-health.png" alt-text="Screenshot of the VM health events of availability insights.":::
-    * SAP Application: Process availability and contextual insights on the process like error messages (SM21), Lock entries (SM12) and Canceled jobs (SM37) which can help you find issues that might exist in parallel in the system, at the point in time. 
+    * SAP Application: Process availability and contextual insights on the process like error messages (SM21), Lock entries (SM12), and Canceled jobs (SM37) which can help you find issues that might exist in parallel in the system, at the point in time. 
 
 ### Performance Insights
 This capability helps you get an overview regarding performance of your SAP system in one place. You can also correlate key SAP performance issues with related SAP application logs alongside Azure platform utilization metrics and SAP workload configuration drifts easing the overall root-causing process. 
@@ -134,7 +134,7 @@ This capability helps you get an overview regarding performance of your SAP syst
 
 #### Scope of the preview
 We have insights only for a limited set of issues as part of the preview. We extend this capability to most of the issues supported by AMS alerts before this capability is Generally Available(GA). 
-* Availability insights let you detect and troubleshoot unavailability of Netweaver system, instance and HANA DB. 
+* Availability insights let you detect and troubleshoot unavailability of Netweaver system, instance, and HANA DB. 
 * Performance insights are provided for NetWeaver metrics - High response time(ST03) and Long running batch jobs. 
 
 ## Next steps

articles/sap/monitor/enable-tls-azure-monitor-sap-solutions.md

@@ -5,7 +5,7 @@ author: sameeksha91
 ms.service: sap-on-azure
 ms.subservice: sap-monitor
 ms.topic: how-to
-ms.date: 12/14/2022
+ms.date: 08/21/2024
 ms.author: sakhare
 #Customer intent: As an SAP Basis or cloud infrastructure team member, I want to deploy Azure Monitor for SAP solutions with secure communication.
 ---
@@ -26,7 +26,7 @@ To enable secure communication in Azure Monitor for SAP solutions, you can choos
 
 We highly recommend that you use root certificates. For root certificates, Azure Monitor for SAP solutions supports only certificates from [certificate authorities (CAs) that participate in the Microsoft Trusted Root Program](/security/trusted-root/participants-list).
 
-Certificates must be signed by a trusted root authority. Self-signed certificates are not supported.
+Certificates must be signed by a trusted root authority. Self-signed certificates aren't supported.
 
 ## How does it work?
 

articles/sap/monitor/get-alerts-portal.md

@@ -6,7 +6,7 @@ ms.author: sakhare
 ms.topic: how-to
 ms.service: sap-on-azure
 ms.subservice: sap-monitor
-ms.date: 10/19/2022
+ms.date: 08/21/2024
 #Customer intent: As a developer, I want to configure alerts in Azure Monitor for SAP solutions so that I can receive alerts and notifications about my SAP systems.
 ---
 
@@ -80,7 +80,7 @@ To access the new Alerts experience in Azure Monitor for SAP Solutions:
 1. Navigate to the Azure portal.
 1. Select your Azure Monitor for SAP Solutions instance.
     :::image type="content" source="./media/get-alerts-portal/new-alerts-view.png" alt-text="Screenshot showing central alerts view." lightbox="./media/get-alerts-portal/new-alerts-view.png":::
-1. Click on the "Alerts" tab to explore the enhanced alert management capabilities.
+1. Select the "Alerts" tab to explore the enhanced alert management capabilities.
 
 ## Next steps
 

articles/sap/monitor/provider-ha-pacemaker-cluster.md

@@ -5,7 +5,7 @@ author: MightySuz
 ms.service: sap-on-azure
 ms.subservice: sap-monitor
 ms.topic: how-to
-ms.date: 01/05/2023
+ms.date: 08/21/2024
 ms.author: sujaj
 #Customer intent: As a developer, I want to create a high-availability Pacemaker cluster so that I can use the resource with Azure Monitor for SAP solutions.
 ---
@@ -45,8 +45,8 @@ For SUSE-based Pacemaker clusters, Please follow below steps to install in each
     sudo systemctl enable prometheus-ha_cluster_exporter
     ```
 
-1. Data is then collected in the system by ha_cluster_exporter. You can export the data via URL `http://<ip address of the server>:9664/metrics`. 
-To check if the metrics are fetched via URL on the server where the ha_cluster_exporter is installed, Run below command on the server.
+1. Data is collected in the system through the ha_cluster_exporter. You can export the data via URL `http://<ip address of the server>:9664/metrics`. 
+To check if the metrics are fetched via URL on the server where the ha_cluster_exporter is installed, Run the following command on the server.
 
     ```bash
      curl http://localhost:9664/metrics
@@ -74,8 +74,8 @@ For RHEL-based Pacemaker clusters, Please follow below steps to install in each
     sudo systemctl enable pmcd
     ```
 
-1. Install and enable the HA cluster PMDA. Replace `$PCP_PMDAS_DIR` with the path where `hacluster` is installed. Use the `find` command in Linux to find the path of "hacluster" bits. usually hacluster will be in path "/var/lib/pcp/pmdas".
-Example : cd /var/lib/pcp/pmdas/hacluster
+1. Install and enable the HA cluster PMDA. Replace `$PCP_PMDAS_DIR` with the path where `hacluster` is installed. Use the `find` command in Linux to find the path of "hacluster" bits. Usually hacluster is in path "/var/lib/pcp/pmdas".
+Example: cd /var/lib/pcp/pmdas/hacluster
 
     ```bash
     cd $PCP_PMDAS_DIR/hacluster
@@ -95,8 +95,8 @@ Example : cd /var/lib/pcp/pmdas/hacluster
     sudo systemctl enable pmproxy
     ```
 
-1. Data is then collected in the system by PCP. You can export the data by using `pmproxy` via URL `http://<ipaddress of the serrver>:44322/metrics?names=ha_cluster`. 
-To check if the metrics are fetched via URL on the server where the hacluster is installed, Run below command on the server.
+1. Data gets collected in the system by PCP. You can export the data by using `pmproxy` via URL `http://<ipaddress of the serrver>:44322/metrics?names=ha_cluster`. 
+To check if the metrics are fetched via URL on the server where the hacluster is installed, Run the following command on the server.
 
     ```bash
      curl http://localhost:44322/metrics?names=ha_cluster
@@ -111,7 +111,7 @@ To [enable TLS 1.2 or higher](enable-tls-azure-monitor-sap-solutions.md), follow
 1. Sign in to the [Azure portal](https://portal.azure.com).
 1. Go to the Azure Monitor for SAP solutions service.
 1. Open your Azure Monitor for SAP solutions resource.
-1. On the resource's menu, under **Settings**, select **Providers**.
+1. On the resource menu, under **Settings**, select **Providers**.
 1. Select **Add** to add a new provider.
 
     ![Diagram that shows Azure Monitor for SAP solutions resource in the Azure portal, showing button to add a new provider.](./media/provider-ha-pacemaker-cluster/azure-monitor-providers-ha-cluster-start.png)
@@ -128,13 +128,12 @@ To [enable TLS 1.2 or higher](enable-tls-azure-monitor-sap-solutions.md), follow
 
         ![Diagram that shows the setup for an Azure Monitor for SAP solutions resource, showing the fields for RHEL-based clusters.](./media/provider-ha-pacemaker-cluster/azure-monitor-providers-ha-cluster-rhel.png)
 
-1. Enter the SID - SAP system ID, Hostname - SAP hostname of the Virtual machine (Command `hostname -s` for SUSE and RHEL based servers will give hostname detail.), Cluster - Provide any custom name that is easy to identify the SAP system cluster - this Name will be visible in the workbook for metrics (need not have to be the cluster name configured on the server). 
+1. Enter the SID - SAP system ID, Hostname - SAP hostname of the Virtual machine (Command `hostname -s` for SUSE and RHEL based servers provide hostname detail), and Cluster - Provide any custom name that is easy to identify the SAP system cluster - this Name is visible in the workbook for metrics (need not have to be the cluster name configured on the server). 
 
-1. Click on "Start test" under "Prerequisite check (Preview) - highly recommended" - This test will help validate the connectivity from AMS subnet to the SAP source system and list out if any error's found - which need to be addressed before provider creation otherwise the provider creation will fail with error.
+1. Select "Start test" under "Prerequisite check (Preview) - highly recommended" - This test helps validate the connectivity from AMS subnet to the SAP source system and list out if any errors  are found - which need to be addressed before provider creation otherwise the provider creation will fail with error.
 1. Select **Create** to finish creating the Provider.
 
-1. Create provider for each of the servers in the cluster to be able to see the metrics in the workbook
-For example - If the Cluster has three servers configured, Create three providers for each of the three servers with all of the above steps followed.
+1. Create provider for each of the servers in the cluster to be able to see the metrics in the workbook. For example, if the Cluster has three servers configured, Create three providers for each of the three servers with all of the above steps followed.
 
 ## Troubleshooting
 

articles/sap/monitor/provider-hana.md

@@ -5,7 +5,7 @@ author: MightySuz
 ms.service: sap-on-azure
 ms.subservice: sap-monitor
 ms.topic: how-to
-ms.date: 10/27/2022
+ms.date: 08/22/2024
 ms.author: sujaj
 #Customer intent: As a developer, I want to create an SAP HANA provider so that I can use the resource with Azure Monitor for SAP solutions.
 ---

articles/sap/monitor/provider-ibm-db2.md

@@ -5,7 +5,7 @@ author: MightySuz
 ms.service: sap-on-azure
 ms.subservice: sap-monitor
 ms.topic: how-to
-ms.date: 12/03/2022
+ms.date: 08/22/2024
 ms.author: sujaj
 #Customer intent: As a developer, I want to create an IBM Db2 provider so that I can monitor the resource through Azure Monitor for SAP solutions.
 ---
@@ -110,7 +110,7 @@ To create the IBM Db2 provider for Azure Monitor for SAP solutions:
 1. Sign in to the [Azure portal](https://portal.azure.com).
 1. Go to the Azure Monitor for SAP solutions service.
 1. Open the Azure Monitor for SAP solutions resource you want to modify.
-1. On the resource's menu, under **Settings**, select **Providers**.
+1. On the resource menu, under **Settings**, select **Providers**.
 1. Select **Add** to add a new provider.
     1. For **Type**, select **IBM Db2**.
     1. (Optional) Select **Enable secure communication** and choose a certificate type from the dropdown list.

articles/sap/monitor/provider-linux.md

@@ -6,7 +6,7 @@ ms.service: sap-on-azure
 ms.subservice: sap-monitor
 ms.custom: linux-related-content
 ms.topic: how-to
-ms.date: 03/09/2023
+ms.date: 08/22/2024
 ms.author: sujaj
 #Customer intent: As a developer, I want to configure a Linux provider so that I can use Azure Monitor for SAP solutions for monitoring.
 ---
@@ -20,12 +20,12 @@ In this how-to guide, you learn how to create a Linux OS provider for Azure Moni
 - An existing Azure Monitor for SAP solutions resource. To create an Azure Monitor for SAP solutions resource, see the [quickstart for the Azure portal](quickstart-portal.md) or the [quickstart for PowerShell](quickstart-powershell.md).
 - Install the [node exporter latest version](https://prometheus.io/download/#node_exporter) in each SAP host that you want to monitor, either BareMetal or Azure virtual machine (VM). For more information, see the [node exporter GitHub repository](https://github.com/prometheus/node_exporter).
 - Node exporter uses the default port 9100 to expose the metrics. If you want to use a custom port, make sure to open the port in the firewall and use the same port while creating the provider.
-- Default port 9100 or custom port that will be configured for node exporter should be open and listening on the Linux host.
+- Default port 9100 or custom port that is configured for node exporter should be open and listening on the Linux host.
 
 To install the node exporter on Linux:
 
-Right click on the relevant node exporter version for linux from https://prometheus.io/download/#node_exporter and copy the link address which will be used in the below command.
-For example - https://github.com/prometheus/node_exporter/releases/download/v1.6.1/node_exporter-1.6.1.linux-amd64.tar.gz
+Right click on the relevant node exporter version for linux from https://prometheus.io/download/#node_exporter and copy the link address to be used in the following command.
+For example, https://github.com/prometheus/node_exporter/releases/download/v1.6.1/node_exporter-1.6.1.linux-amd64.tar.gz
 
 1. Change to the directory where you want to install the node exporter.
 1. Run `wget https://github.com/prometheus/node_exporter/releases/download/v<xxx>/node_exporter-<xxx>.linux-amd64.tar.gz`. Replace `xxx` with the version number.
@@ -129,7 +129,7 @@ When the provider settings validation operation fails with the code `PrometheusU
 1. Try to restart the node exporter agent:
     1. Go to the folder where you installed the node exporter (the file name resembles `node_exporter-<xxxx>-amd64`).
     1. Run `./node_exporter`.
-    1. Run `nohup ./node_exporter &` command to enable node_exporter. Adding nohup and & to above command decouples the node_exporter from linux machine commandline. If not included node_exporter would stop when the commandline is closed.
+    1. Run `nohup ./node_exporter &` command to enable node_exporter. Adding nohup and & to the previous command decouples the node_exporter from the linux machine commandline. If not included, the node_exporter stops when the commandline is closed.
 1. Verify that the Prometheus endpoint is reachable from the subnet that you provided when you created the Azure Monitor for SAP solutions resource.
 
 ## Suggestion