Compartir a través de


Integración de Application Insights en el portal para desarrolladores

SE APLICA A: Desarrollador | Básico | Básico v2 | Estándar | Standard v2 | Premium |Premium v2

Una característica conocida de Azure Monitor es Application Insights. Se trata de un servicio de Application Performance Management (APM) extensible para desarrolladores y profesionales de DevOps. Úselo para supervisar el portal para desarrolladores y detectar anomalías en el rendimiento. Application Insights incluye eficaces herramientas de análisis para ayudarle a aprender qué hacen realmente los usuarios al visitar su portal para desarrolladores.

Adición de Application Insights a un portal

Siga estos pasos para conectar Application Insights con el portal para desarrolladores administrado o autohospedado.

Importante

Los pasos 1 -3 no son necesarios para los portales administrados. Si tiene un portal administrado, vaya al paso 4.

  1. Configure un entorno local para la versión más reciente del portal para desarrolladores.

  2. Instale el paquete npm para agregar Paperbits para Azure:

    npm install @paperbits/azure --save
    
  3. En el archivo startup.publish.ts de la carpeta src, importe el módulo de Application Insights y regístrelo. Agregue AppInsightsPublishModule después de los módulos existentes en el contenedor de inserción de dependencias:

    import { AppInsightsPublishModule } from "@paperbits/azure";
    ...
    const injector = new InversifyInjector();
    injector.bindModule(new CoreModule());
    ...
    injector.bindModule(new AppInsightsPublishModule());
    injector.resolve("autostart");
    
  4. Recupere la configuración del portal mediante la API de REST Content Item - Get:

    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
    

    La salida es parecida a esta:

    {
        "id": "/contentTypes/document/contentItems/configuration",
        "type": "Microsoft.ApiManagement/service/contentTypes/contentItems",
          "name": "configuration",
          "properties": {
          "nodes": [
            {
                "site": {
                    "title": "Microsoft Azure API Management - developer portal",
                    "description": "Discover APIs, learn how to use them, try them out interactively, and sign up to acquire keys.",
                    "keywords": "Azure, API Management, API, developer",
                    "faviconSourceId": null,
                    "author": "Microsoft Azure API Management"
                }
            }
        ]
        }
    }
    
  5. Extienda la configuración del sitio del paso anterior con la configuración de Application Insights. Actualice la configuración mediante la API REST Elemento de contenido: crear o actualizar . Pase la clave de instrumentación de Application Insights en un nodo de integration en el cuerpo de la solicitud.

    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
    
    {
        "id": "/contentTypes/document/contentItems/configuration",
        "type": "Microsoft.ApiManagement/service/contentTypes/contentItems",
        "name": "configuration",
        "properties": {  
        "nodes": [
            {
                "site": { ... },
                "integration": {
                    "appInsights": {
                        "instrumentationKey": "xxxxxxxx-xxxx-xxxx-xxxxxxxxxxxxxxxxx"
                    }
                }
            }
        ]
        }
    }
    
  6. Después de actualizar la configuración, vuelva a publicar el portal para que los cambios surtan efecto.

Obtenga más información sobre el portal para desarrolladores: