Schnellstart: Starten der Überwachung Ihrer Node.js-Webanwendung mit Azure Application InsightsQuickstart: Start monitoring your Node.js Web application with Azure Application Insights

Diese Schnellstartanleitung führt Sie durch die notwendigen Schritte, um das Application Insights SDK für Node.js, Version 0.22, zu einer vorhandenen Node.js-Webanwendung hinzuzufügen.This quickstart guides you through adding the version 0.22 Application Insights SDK for Node.js to an existing Node.js web application.

Mit Azure Application Insights können Sie die Verfügbarkeit, Leistung und Nutzung Ihrer Webanwendung ganz einfach überwachen.With Azure Application Insights, you can easily monitor your web application for availability, performance, and usage. Sie können auch Fehler in Ihrer Anwendung schnell erkennen und diagnostizieren, ohne darauf warten zu müssen, dass diese Fehler von Benutzern gemeldet werden.You can also quickly identify and diagnose errors in your application without waiting for a user to report them. Ab der SDK-Version 0.20 können Sie allgemeine Drittanbieterpakete einschließlich MongoDB, MySQL und Redis überwachen.With the version 0.20 SDK release onward, you can monitor common third-party packages, including MongoDB, MySQL, and Redis.

VoraussetzungenPrerequisites

So führen Sie diesen Schnellstart durch:To complete this quickstart:

  • Sie benötigen ein Azure-Abonnement und eine vorhandene Node.js-Webanwendung.You need an Azure Subscription and an existing Node.js web application.

Wenn Sie noch nicht über eine Node.js-Webanwendung verfügen, können Sie mithilfe der Schnellstartanleitung unter Erstellen einer Node.js-Web-App eine erstellen.If you don't have a Node.js web application, you can create one by following the Create a Node.js web app quickstart.

Wenn Sie kein Azure-Abonnement besitzen, können Sie ein kostenloses Konto erstellen, bevor Sie beginnen.If you don't have an Azure subscription, create a free account before you begin.

Melden Sie sich auf dem Azure-Portal an.Sign in to the Azure portal

Melden Sie sich beim Azure-Portal an.Sign in to the Azure portal.

Aktivieren von Application InsightsEnable Application Insights

Application Insights kann Telemetriedaten von jeder mit dem Internet verbundenen Anwendung erfassen, unabhängig davon, ob die Anwendung lokal oder in der Cloud ausgeführt wird.Application Insights can gather telemetry data from any internet-connected application, regardless of whether it's running on-premises or in the cloud. Geben Sie folgendermaßen vor, um diese Daten anzuzeigen.Use the following steps to start viewing this data.

  1. Klicken Sie auf Ressource erstellen > Entwicklertools > Application Insights.Select Create a resource > Developer tools > Application Insights.

    Hinzufügen einer Azure Application Insights-Ressource

    Hinweis

    Wenn Sie zum ersten Mal eine Application Insights-Ressource erstellen, können Sie mehr dazu im Dokument Erstellen einer Application Insights-Ressource erfahren.If this is your first time creating an Application Insights resource you can learn more by visiting the Create an Application Insights Resource doc.

    Eine Seite für die Konfiguration wird geöffnet. Füllen Sie die Eingabefelder anhand der Informationen in der folgenden Tabelle aus.A configuration page appears; use the following table to fill out the input fields.

    EinstellungenSettings WertValue BESCHREIBUNGDescription
    NameName Global eindeutiger WertGlobally Unique Value Der Name, der die zu überwachende App identifiziert.Name that identifies the app you are monitoring
    AnwendungstypApplication Type Node.js-AnwendungNode.js Application Der Typ der zu überwachenden App.Type of app you are monitoring
    LocationLocation East USEast US Wählen Sie einen Standort in Ihrer Nähe oder in der Nähe des Standorts, in dem Ihre App gehostet wird.Choose a location near you, or near where your app is hosted
  2. Klicken Sie auf Erstellen.Select Create.

Konfigurieren des Application Insights SDKConfigure App Insights SDK

  1. Wählen Sie Übersicht aus, und kopieren Sie den Instrumentierungsschlüssel Ihrer Anwendung.Select Overview and copy your application's Instrumentation Key.

    Anzeigen des Application Insights-Instrumentierungsschlüssels

  2. Fügen Sie das Application Insights SDK für Node.js zu Ihrer Anwendung hinzu.Add the Application Insights SDK for Node.js to your application. Führen Sie folgenden Befehl im Stammverzeichnis Ihrer App aus:From your app's root folder run:

    npm install applicationinsights --save
    
  3. Bearbeiten Sie die erste JS-Datei Ihrer App, und fügen Sie dem obersten Teil Ihres Skripts die beiden unten stehenden Zeilen hinzu.Edit your app's first .js file and add the two lines below to the topmost part of your script. Wenn Sie die Node.js-Schnellstart-App verwenden, bearbeiten Sie die Datei „index.js“.If you are using the Node.js quickstart app, you would modify the index.js file. Ersetzen Sie <instrumentation_key> durch den Instrumentierungsschlüssel Ihrer Anwendung.Replace <instrumentation_key> with your application's instrumentation key.

    const appInsights = require('applicationinsights');
    appInsights.setup('<instrumentation_key>').start();
    
  4. Starten Sie die App neu.Restart your app.

Hinweis

Es dauert ca. 3-5 Minuten, bis die ersten Daten im Portal angezeigt werden.It takes 3-5 minutes before data begins appearing in the portal. Wenn es sich um eine Test-App mit geringem Datenverkehr handelt, denken Sie daran, dass die meisten Metriken nur erfasst werden, wenn aktive Anforderungen oder Vorgänge vorhanden sind.If this app is a low-traffic test app, keep in mind that most metrics are only captured when there are active requests or operations occurring.

Starten der Überwachung im Azure-PortalStart monitoring in the Azure portal

  1. Sie können jetzt im Azure-Portal erneut die Seite Übersicht für Application Insights öffnen, von der Sie den Instrumentierungsschlüssel abgerufen haben, um Details zu Ihrer aktuell ausgeführten Anwendung anzuzeigen.You can now reopen the Application Insights Overview page in the Azure portal, where you retrieved your instrumentation key, to view details about your currently running application.

    Application Insights: Menü „Übersicht“

  2. Wählen Sie Anwendungsübersicht aus, um ein visuelles Layout der Abhängigkeitsbeziehungen zwischen den Komponenten Ihrer Anwendung zu erhalten.Select Application map for a visual layout of the dependency relationships between your application components. Jede Komponente zeigt KPIs wie z.B. Last, Leistung, Fehler und Warnungen an.Each component shows KPIs such as load, performance, failures, and alerts.

    Application Insights-Anwendungsübersicht

  3. Wählen Sie das App-Analyse-Symbol Symbol „Anwendungsübersicht“ In Analytics anzeigen aus.Select the App Analytics icon Application Map icon View in Analytics. Dadurch wird die Application Insights-Analyse geöffnet, die eine erweiterte Abfragesprache zum Analysieren aller Daten bereitstellt, die von Application Insights gesammelt werden.This opens Application Insights Analytics, which provides a rich query language for analyzing all data collected by Application Insights. In diesem Fall wird eine Abfrage für Sie generiert, die die Anzahl von Anforderungen als Diagramm darstellt.In this case, a query is generated for you that renders the request count as a chart. Sie können selbst Abfragen zum Analysieren anderer Daten schreiben.You can write your own queries to analyze other data.

    Application Insights-Analysediagramme

  4. Kehren Sie zur Seite Übersicht zurück, und untersuchen Sie die KPI-Graphen.Return to the Overview page and examine the KPI graphs. Dieses Dashboard zeigt Statistiken zur Integrität Ihrer Anwendung, einschließlich der Anzahl von eingehenden Anforderungen, der Dauer dieser Anforderungen und aller auftretenden Fehler.This dashboard provides statistics about your application health, including the number of incoming requests, the duration of those requests, and any failures that occur.

    Application Insights-Diagramm der Übersichtszeitachse für die Integrität

    Damit das Diagramm Ladezeit der Seitenansicht mit clientseitigen Telemetriedaten aufgefüllt werden kann, fügen Sie dieses Skript zu jeder Seite hinzu, die Sie nachverfolgen möchten:To enable the Page View Load Time chart to populate with client-side telemetry data, add this script to each page that you want to track:

    <!-- 
    To collect user behavior analytics tools about your application, 
    insert the following script into each page you want to track.
    Place this code immediately before the closing </head> tag,
    and before any other scripts. Your first data will appear 
    automatically in just a few seconds.
    -->
    <script type="text/javascript">
      var appInsights=window.appInsights||function(config){
        function i(config){t[config]=function(){var i=arguments;t.queue.push(function(){t[config].apply(t,i)})}}var t={config:config},u=document,e=window,o="script",s="AuthenticatedUserContext",h="start",c="stop",l="Track",a=l+"Event",v=l+"Page",y=u.createElement(o),r,f;y.src=config.url||"https://az416426.vo.msecnd.net/scripts/a/ai.0.js";u.getElementsByTagName(o)[0].parentNode.appendChild(y);try{t.cookie=u.cookie}catch(p){}for(t.queue=[],t.version="1.0",r=["Event","Exception","Metric","PageView","Trace","Dependency"];r.length;)i("track"+r.pop());return i("set"+s),i("clear"+s),i(h+a),i(c+a),i(h+v),i(c+v),i("flush"),config.disableExceptionTracking||(r="onerror",i("_"+r),f=e[r],e[r]=function(config,i,u,e,o){var s=f&&f(config,i,u,e,o);return s!==!0&&t["_"+r](config,i,u,e,o),s}),t
        }({
            instrumentationKey:"<insert instrumentation key>"
        });
    
        window.appInsights=appInsights;
        appInsights.trackPageView();
    </script>
    
  5. Wählen Sie links die Option Metrik aus.On the left, select Metrics. Untersuchen Sie mithilfe des Metrik-Explorers die Integrität und Auslastung Ihrer Ressource.Use the metrics explorer to investigate the health and utilization of your resource. Sie können Neues Diagramm hinzufügen auswählen, um zusätzliche benutzerdefinierte Ansichten zu erstellen, oder Bearbeiten auswählen, um Typ, Höhe, Farbpalette, Gruppierungen und Metriken der vorhandenen Diagramme zu ändern.You can select Add new chart to create additional custom views or select Edit to modify the existing chart types, height, color palette, groupings, and metrics. Sie können beispielsweise ein Diagramm für die durchschnittliche Seitenladezeit des Browsers erstellen, indem Sie in der Metrik-Dropdownliste die Option für die Browser-Seitenladezeit und unter „Aggregation“ die Durchschnittsoption auswählen.For example, you can make a chart that displays the average browser page load time by selecting "Browser page load time" from the metrics drop down and "Avg" from aggregation. Weitere Informationen zum Azure-Metrik-Explorer finden Sie unter Erste Schritte mit dem Azure-Metrik-Explorer.To learn more about Azure Metrics Explorer visit Getting started with Azure Metrics Explorer.

    Application Insights-Diagramm der Servermetriken

Weitere Informationen zum Überwachen von Node.js finden Sie in der weiteren Dokumentation zu Application Insights und Node.js.To learn more about monitoring Node.js, check out the additional App Insights Node.js documentation.

Bereinigen von RessourcenClean up resources

Wenn Sie die Tests abgeschlossen haben, können Sie die Ressourcengruppe und alle dazugehörigen Ressourcen löschen.When you are done testing, you can delete the resource group and all related resources. Gehen Sie dazu wie folgt vor:To do so follow the steps below.

  1. Wählen Sie im Azure-Portal im Menü auf der linken Seite die Option Ressourcengruppen und dann myResourceGroup.From the left-hand menu in the Azure portal, select Resource groups and then select myResourceGroup.
  2. Wählen Sie auf der Seite mit Ihrer Ressourcengruppe die Option Löschen aus, geben Sie in das Textfeld myResourceGroup ein, und wählen Sie anschließend Löschen aus.On your resource group page, select Delete, enter myResourceGroup in the text box, and then select Delete.

Nächste SchritteNext steps