Partager via

Intégrer Application Insights au portail des développeurs

S’applique à : Développeur | Essentiel | Essentiel v2 | Standard | Standard v2 | Premium | Premium v2

L’une des fonctionnalités les plus populaires d’Azure Monitor est Application Insights. Il s’agit d’un service extensible de gestion des performances des applications (APM) qui est destiné aux développeurs et aux professionnels DevOps. Vous pouvez l’utiliser pour superviser votre portail des développeurs et détecter les anomalies de performances. Application Insights intègre de puissants outils d’analytique qui vous permettent de savoir ce que font les utilisateurs en visitant le portail des développeurs.

Ajouter Application Insights à votre portail

Effectuez les étapes suivantes pour connecter Application Insights à votre portail des développeurs managé ou auto-hébergé.

Important

Les étapes 1 -3 ne sont pas requises pour les portails gérés. Si vous disposez d’un portail managé, passez à l’étape 4.

  1. Configurez un environnement local pour la dernière version du portail des développeurs.

  2. Installez le package npm pour ajouter Paperbits for Azure :

    npm install @paperbits/azure --save

  3. Dans le fichier startup.publish.ts du dossier src, importez puis inscrivez le module Application Insights : Ajoutez les AppInsightsPublishModule modules existants dans le conteneur d’injection de dépendances :

    import { AppInsightsPublishModule } from "@paperbits/azure";
...
const injector = new InversifyInjector();
injector.bindModule(new CoreModule());
...
injector.bindModule(new AppInsightsPublishModule());
injector.resolve("autostart");

  4. Récupérez la configuration du portail à l’aide de l’élément de contenu - Obtenir l’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

    Le résultat se présente ainsi :

    {
    "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. Étendez la configuration du site de l’étape précédente avec la configuration Application Insights. Mettez à jour la configuration à l’aide de l’élément de contenu - Créer ou mettre à jour l’API REST. Transmettez la clé d’instrumentation Application Insights dans un nœud integration dans le corps de la requête.

    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. Après avoir mis à jour la configuration, vous devez republier le portail pour que les modifications prennent effet.

Contenu connexe

Pour plus d’informations sur le portail des développeurs :

  • Last updated on