Merge pull request #190013 from bwren/tutorial-fix

Fixes for custom logs tutorial

Author: PRMerger8

articles/azure-monitor/logs/tutorial-custom-logs-api.md

@@ -340,6 +340,12 @@ Once the data collection rule has been created, the application needs to be give
 ## Send sample data
 The following PowerShell code sends data to the endpoint using HTTP REST fundamentals. 
 
+1. Run the following PowerShell command which adds a required assembly for the script.
+
+    ```powershell
+    Add-Type -AssemblyName System.Web
+    ```
+
 1. Replace the parameters in the *step 0* section with values from the resources that you just created. You may also want to replace the sample data in the *step 2* section with your own.  
 
     ```powershell
@@ -364,8 +370,6 @@ The following PowerShell code sends data to the endpoint using HTTP REST fundame
     $uri = "https://login.microsoftonline.com/$tenantId/oauth2/v2.0/token"
 
     $bearerToken = (Invoke-RestMethod -Uri $uri -Method "Post" -Body $body -Headers $headers).access_token
-    ### If the above line throws an 'Unable to find type [System.Web.HttpUtility].' error, execute the line below separately from the rest of the code
-    # Add-Type -AssemblyName System.Web
 
     ##################
     ### Step 2: Load up some sample data. 
@@ -427,9 +431,6 @@ API limits have been exceeded. The limits are currently set to 500MB of data/min
 ### Script returns error code 503
 Ensure that you have the correct permissions for your application to the DCR. You may also need to wait up to 30 minutes for permissions to propagate.
 
-### Script returns error `Unable to find type [System.Web.HttpUtility]`
-Run the last line in section 1 of the script for a fix and execute it directly. Executing it uncommented as part of the script will not resolve the issue. The command must be executed separately.
-
 ### You don't receive an error, but data doesn't appear in the workspace
 The data may take some time to be ingested, especially if this is the first time data is being sent to a particular table. It shouldn't take longer than 15 minutes.
 

articles/azure-monitor/logs/tutorial-custom-logs.md

@@ -73,7 +73,13 @@ A [data collection endpoint (DCE)](../essentials/data-collection-endpoint-overvi
 ## Generate sample data
 The following PowerShell script both generates sample data to configure the custom table and sends sample data to the custom logs API to test the configuration. 
 
-1. Update the values of `$tenantId`, `$appId`, and `$appSecret` with the values you noted for **Directory (tenant) ID**, **Application (client) ID**, and secret **Value** and then save with the file name *LogGenerator.ps1*.
+1. Run the following PowerShell command which adds a required assembly for the script.
+
+    ```powershell
+    Add-Type -AssemblyName System.Web
+    ```
+
+2. Update the values of `$tenantId`, `$appId`, and `$appSecret` with the values you noted for **Directory (tenant) ID**, **Application (client) ID**, and secret **Value** and then save with the file name *LogGenerator.ps1*.
 
     ``` PowerShell
     param ([Parameter(Mandatory=$true)] $Log, $Type="file", $Output, $DcrImmutableId, $DceURI, $Table)
@@ -145,8 +151,6 @@ The following PowerShell script both generates sample data to configure the cust
         $headers = @{"Content-Type" = "application/x-www-form-urlencoded" };
         $uri = "https://login.microsoftonline.com/$tenantId/oauth2/v2.0/token"
         $bearerToken = (Invoke-RestMethod -Uri $uri -Method "Post" -Body $body -Headers $headers).access_token
-        ## If the above line throws an 'Unable to find type [System.Web.HttpUtility].' error, execute the line below separately from the rest of the code
-        # Add-Type -AssemblyName System.Web
 
         ## Generate and send some data
         foreach ($line in $file_data) {
@@ -173,16 +177,14 @@ The following PowerShell script both generates sample data to configure the cust
     }
     ```
 
-2. Copy the sample log data from [sample data](#sample-data) or copy your own Apache log data into a file called *sample_access.log*. Run the script using the following command to read this data and create a JSON file called *data_sample.json* that you can send to the custom logs API.
+3. Copy the sample log data from [sample data](#sample-data) or copy your own Apache log data into a file called *sample_access.log*. 
 
     ```PowerShell
     .\LogGenerator.ps1 -Log "sample_access.log" -Type "file" -Output "data_sample.json"
     ```
 
-3. Run the script using the following command to read this data and create a JSON file called *data_sample.json* that you can send to the custom logs API.
+4. Run the script using the following command to read this data and create a JSON file called *data_sample.json* that you can send to the custom logs API.
  
-    :::image type="content" source="media/tutorial-custom-logs/new-custom-log.png" lightbox="media/tutorial-custom-logs/new-custom-log.png" alt-text="Screenshot showing new DCR-based custom log.":::
-
 ## Add custom log table
 Before you can send data to the workspace, you need to create the custom table that the data will be sent to.
 
@@ -317,7 +319,7 @@ Allow at least 30 minutes for the configuration to take effect. You may also exp
 1. Run the following command providing the values that you collected for your data collection rule and data collection endpoint. The script will start ingesting data by placing calls to the API at pace of approximately 1 record per second.
 
 ```PowerShell
-.\LogGenerator.ps1 -Log "sample_access.log" -Type "API" -Table "ApacheAccess_CL" -DcrImmutableId <immutable ID> -DceUrl <data collection endpoint URL> 
+.\LogGenerator.ps1 -Log "sample_access.log" -Type "API" -Table "ApacheAccess_CL" -DcrImmutableId <immutable ID> -DceUri <data collection endpoint URL> 
 ```
 
 2. From Log Analytics, query your newly created table to verify that data arrived and if it is transformed properly.
@@ -336,9 +338,6 @@ API limits have been exceeded. The limits are currently set to 500MB of data/min
 ### Script returns error code 503
 Ensure that you have the correct permissions for your application to the DCR. You may also need to wait up to 30 minutes for permissions to propagate.
 
-### Script returns error `Unable to find type [System.Web.HttpUtility]`
-Run the last line in section 1 of the script for a fix and execute it directly. Executing it uncommented as part of the script will not resolve the issue. The command must be executed separately.
-
 ### You don't receive an error, but data doesn't appear in the workspace
 The data may take some time to be ingested, especially if this is the first time data is being sent to a particular table. It shouldn't take longer than 15 minutes.