Partilhar via


Integrar o Application Insights no portal do programador

APLICA-SE A: Developer | Básico | Básico v2 | Padrão | Padrão v2 | Prémio | Premium v2

Um recurso popular do Azure Monitor é o Application Insights. É um serviço extensível de Gerenciamento de Desempenho de Aplicativos (APM) para desenvolvedores e profissionais de DevOps. Use-o para monitorar seu portal do desenvolvedor e detetar anomalias de desempenho. O Application Insights inclui poderosas ferramentas de análise para ajudá-lo a saber o que os usuários realmente fazem ao visitar seu portal do desenvolvedor.

Adicionar o Application Insights ao seu portal

Siga estas etapas para conectar o Application Insights ao seu portal do desenvolvedor gerenciado ou auto-hospedado.

Importante

As etapas 1 -3 não são necessárias para portais gerenciados. Se tiver um portal gerido, avance para o passo 4.

  1. Configure um ambiente local para a versão mais recente do portal do desenvolvedor.

  2. Instale o pacote npm para adicionar Paperbits para Azure:

    npm install @paperbits/azure --save
    
  3. startup.publish.ts No arquivo na src pasta, importe e registre o módulo Application Insights. Adicione o AppInsightsPublishModule após os módulos existentes no contêiner de injeção de dependência:

    import { AppInsightsPublishModule } from "@paperbits/azure";
    ...
    const injector = new InversifyInjector();
    injector.bindModule(new CoreModule());
    ...
    injector.bindModule(new AppInsightsPublishModule());
    injector.resolve("autostart");
    
  4. Recupere a configuração do portal usando o Content Item - Get REST API:

    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
    

    A saída é semelhante a:

    {
        "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. Estenda a configuração do site da etapa anterior com a configuração do Application Insights. Atualize a configuração usando o Content Item - Create Or Update REST API. Passe a chave de instrumentação do Application Insights em um integration nó no corpo da solicitação.

    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. Depois de atualizar a configuração, publique novamente o portal para que as alterações entrem em vigor.

Saiba mais sobre o portal do desenvolvedor: