Merge pull request #208226 from dlepow/dpai

[APIM] Update developer-portal-integrate-application-insights.md

Author: BCS2022

articles/api-management/developer-portal-integrate-application-insights.md

@@ -4,7 +4,7 @@ titleSuffix: Azure API Management
 description: Learn how to integrate Application Insights into your managed or self-hosted developer portal.
 author: dlepow
 ms.author: danlep
-ms.date: 03/25/2021
+ms.date: 08/16/2022
 ms.service: api-management
 ms.topic: how-to
 ---
@@ -18,7 +18,7 @@ A popular feature of Azure Monitor is Application Insights. It's an extensible A
 Follow these steps to plug Application Insights into your managed or self-hosted developer portal.
 
 > [!IMPORTANT]
-> Steps 1 and 2 are not required for managed portals. If you have a managed portal, skip to step 4.
+> Steps 1 -3 are not required for managed portals. If you have a managed portal, skip to step 4.
 
 1. Set up a [local environment](developer-portal-self-host.md#step-1-set-up-local-environment) for the latest release of the developer portal.
 
@@ -28,23 +28,33 @@ Follow these steps to plug Application Insights into your managed or self-hosted
     npm install @paperbits/azure --save
     ```
 
-1. In the `startup.publish.ts` file in the `src` folder, import and register the Application Insights module:
+1. In the `startup.publish.ts` file in the `src` folder, import and register the Application Insights module. Add the `AppInsightsPublishModule` after the existing modules in the dependency injection container:
 
     ```typescript
     import { AppInsightsPublishModule } from "@paperbits/azure";
     ...
+    const injector = new InversifyInjector();
+    injector.bindModule(new CoreModule());
+    ...
     injector.bindModule(new AppInsightsPublishModule());
+    injector.resolve("autostart");
     ```
 
-1. Retrieve the portal's configuration:
+1. Retrieve the portal's configuration using the [Content Item - Get](/rest/api/apimanagement/current-ga/content-item/get) REST API:
 
     ```http
-    GET /contentTypes/document/contentItems/configuration
+    GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft.ApiManagement/service/{api-management-service-name}/contentTypes/document/contentItems/configuration?api-version=2021-08-01
     ```
+    
+    Output is similar to:
 
     ```json
     {
-        "nodes": [
+        "id": "/contentTypes/document/contentItems/configuration",
+        "type": "Microsoft.ApiManagement/service/contentTypes/contentItems",
+          "name": "configuration",
+          "properties": {
+          "nodes": [
             {
                 "site": {
                     "title": "Microsoft Azure API Management - developer portal",
@@ -55,17 +65,23 @@ Follow these steps to plug Application Insights into your managed or self-hosted
                 }
             }
         ]
+        }
     }
     ```
 
-1. Extend the site configuration from the previous step with Application Insights configuration:
+1. Extend the site configuration from the previous step with Application Insights configuration. Update the configuration using the [Content Item - Create or Update](/rest/api/apimanagement/current-ga/content-item/create-or-update) REST API. Pass the Application Insights instrumentation key in an `integration` node in the request body.
+
 
     ```http
-    PUT /contentTypes/document/contentItems/configuration
+    PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft.ApiManagement/service/{api-management-service-name}/contentTypes/document/contentItems/configuration?api-version=2021-08-01
     ```
 
     ```json
     {
+        "id": "/contentTypes/document/contentItems/configuration",
+        "type": "Microsoft.ApiManagement/service/contentTypes/contentItems",
+        "name": "configuration",
+        "properties": {  
         "nodes": [
             {
                 "site": { ... },
@@ -76,9 +92,12 @@ Follow these steps to plug Application Insights into your managed or self-hosted
                 }
             }
         ]
+        }
     }
     ```
 
+1. After you update the configuration, [republish the portal](api-management-howto-developer-portal-customize.md#publish) for the changes to take effect.
+
 ## Next steps
 
 Learn more about the developer portal:

articles/api-management/developer-portal-integrate-google-tag-manager.md

@@ -20,7 +20,7 @@ Follow the steps in this article to plug Google Tag Manager into your managed or
 Follow these steps to plug Google Tag Manager into your managed or self-hosted developer portal.
 
 > [!IMPORTANT]
-> Steps 1 and 2 are not required for managed portals. If you have a managed portal, skip to step 4.
+> Steps 1 - 3 are not required for managed portals. If you have a managed portal, skip to step 4.
 
 1. Set up a [local environment](developer-portal-self-host.md#step-1-set-up-local-environment) for the latest release of the developer portal.