Integrar o Application Insights ao portal do desenvolvedor

Artigo
04/11/2024

Um recurso popular do Azure Monitor é o Application Insights. É um serviço de APM (gerenciamento de desempenho do aplicativo) extensível para desenvolvedores e profissionais de DevOps. Use-o para monitorar o portal do desenvolvedor e detectar anomalias de desempenho. O Application Insights inclui ferramentas de análise eficazes para ajudar você a descobrir o que os usuários realmente fazem ao visitar o portal do desenvolvedor.

Adicione o Application Insights ao portal

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

Importante

As etapas 1 a 3 não são necessárias para portais gerenciados. Se você tiver um portal gerenciado, pule para a etapa 4.

Configure um ambiente local para a versão mais recente do portal do desenvolvedor.
Instale o pacote npm para adicionar o Paperbits para Azure:
```
npm install @paperbits/azure --save
```

No arquivo startup.publish.ts na pasta src, importe e registre o módulo Application Insights. Adicione os módulos 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");

Recupere a configuração do portal usando o Item de Conteúdo – Obter da API REST:

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"
            }
        }
    ]
    }
}

Estenda a configuração do site da etapa anterior com a configuração do Application Insights. Atualize a configuração usando o Item de Conteúdo – Criar ou atualizar da API REST. Passe a chave de instrumentação do Application Insights em um nó integration 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"
                }
            }
        }
    ]
    }
}

Depois de atualizar a configuração,publique novamente o portal para que as alterações entrem em vigor.

Próximas etapas

Saiba mais sobre o portal do desenvolvedor:

Integrar o Application Insights ao portal do desenvolvedor

Adicione o Application Insights ao portal

Próximas etapas

Recursos adicionais