Quickstart: Node.js Web uygulamanızı Azure Uygulama Öngörüleri ile izlemeye başlayınQuickstart: Start monitoring your Node.js Web application with Azure Application Insights

Bu hızlı başlangıçta, Node.js için Application Insights SDK sürümünü 0.22'yi varolan bir Node.js web uygulamasına eklersiniz.In this quickstart, you add the Application Insights SDK version 0.22 for Node.js to an existing Node.js web application.

Azure Application Insights ile web uygulamanızı kullanılabilirlik, performans ve kullanım bakımından kolayca izleyebilirsiniz.With Azure Application Insights, you can easily monitor your web application for availability, performance, and usage. Ayrıca, bir kullanıcının bildirmesini beklemeden uygulamanızdaki hataları hızlıca tanımlayıp tespit edebilirsiniz.You can also quickly identify and diagnose errors in your application without waiting for a user to report them. Sürüm 0.20 SDK yayınından itibaren MongoDB, MySQL ve Redis dahil olmak üzere yaygın üçüncü taraf paketleri izleyebilirsiniz.With the version 0.20 SDK release onward, you can monitor common third-party packages, including MongoDB, MySQL, and Redis.

Ön koşullarPrerequisites

Application Insights'ı etkinleştirmeEnable Application Insights

Application Insights, şirket içinde veya bulutta çalışıyor olsun veya olmasın, internete bağlı herhangi bir uygulamadan telemetri verileri toplayabilir.Application Insights can gather telemetry data from any internet-connected application, whether or not it's running on-premises or in the cloud. Bu verileri görüntülemeyi başlatmak için aşağıdaki adımları kullanın.Use the following steps to start viewing this data.

  1. Azure portalındaoturum açın.Sign in to the Azure portal.

  2. Kaynak > Oluştur Geliştirici araçları > Uygulama Öngörüleri'niseçin.Select Create a resource > Developer tools > Application Insights.

    Azure Uygulama Öngörüleri kaynağı ekleme

    Not

    Uygulama Öngörüleri kaynağını ilk kez oluşturuyorsanız, Uygulama Öngörüleri Oluştur Kaynak dokümanını ziyaret ederek daha fazla bilgi edinebilirsiniz.If this is your first time creating an Application Insights resource you can learn more by visiting the Create an Application Insights Resource doc.

    Bir yapılandırma sayfası görüntülenir; giriş alanlarını doldurmak için aşağıdaki tabloyu kullanın.A configuration page appears; use the following table to fill out the input fields.

    AyarlarSettings DeğerValue AçıklamaDescription
    AdıName Genel Olarak Benzersiz DeğerGlobally Unique Value İzlediğiniz uygulamayı tanımlayan adName that identifies the app you're monitoring
    Kaynak GrubuResource Group myResourceGroupmyResourceGroup AppInsights verilerini barındıracak yeni kaynak grubunun adı.Name for the new resource group to host AppInsights data. Yeni bir kaynak grubu oluşturabilir veya varolan bir kaynak grubu kullanabilirsiniz.You can create a new resource group or use an existing one.
    KonumLocation Doğu ABDEast US Yakınınızda bulunan veya uygulamanızın barındırıldığı konumun yakınında olan bir konum seçinChoose a location near you, or near where your app is hosted
  3. Oluştur'useçin.Select Create.

AppInsights SDK'yı YapılandırConfigure AppInsights SDK

  1. Genel Bakış'ı seçin ve uygulamanızın Enstrümantasyon Anahtarınıkopyalayın.Select Overview and copy your application's Instrumentation Key.

    Uygulama Öngörüleri Enstrümantasyon Anahtarını Görüntüleyin

  2. Uygulamanıza Node.js için Application Insights SDK’sı ekleyin.Add the Application Insights SDK for Node.js to your application. Uygulamanızın kök klasörü çalıştırmasından:From your app's root folder run:

    npm install applicationinsights --save
    
  3. Uygulamanızın ilk .js dosyasını edin ve aşağıdaki iki satırı komut dosyanızın en üst kısmına ekleyin.Edit your app's first .js file and add the two lines below to the topmost part of your script. Node.js quickstart uygulamasınıkullanıyorsanız, index.js dosyasını değiştirirsiniz.If you're using the Node.js quickstart app, you would modify the index.js file. Uygulamanızın enstrümantasyon anahtarıyla değiştirin. <instrumentation_key>Replace <instrumentation_key> with your application's instrumentation key.

    const appInsights = require('applicationinsights');
    appInsights.setup('<instrumentation_key>').start();
    
  4. Uygulamanızı yeniden başlatın.Restart your app.

Not

Verilerin portalda görünmesi 3-5 dakika sürer.It takes 3-5 minutes before data begins appearing in the portal. Bu uygulama düşük trafikli bir test uygulaması ise, çoğu ölçümün yalnızca etkin istek veya gerçekleşen işlemler olduğunda yakalandığını aklınızda bulundurun.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.

Azure portalında izlemeyi başlatınStart monitoring in the Azure portal

  1. Artık izleme anahtarınızı aldığınız Application Insights Genel Bakış sayfasını yeniden açarak o anda çalışan uygulamanıza ilişkin ayrıntıları görüntüleyebilirsiniz.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.

    Uygulama Öngörüleri Genel Bakış menüsü

  2. Uygulama bileşenleriniz arasındaki bağımlılık ilişkilerinin görsel düzeni için Uygulama haritasını seçin.Select Application map for a visual layout of the dependency relationships between your application components. Her bileşen yük, performans, hatalar ve uyarılar gibi KPI'leri gösterir.Each component shows KPIs such as load, performance, failures, and alerts.

    Uygulama Öngörüleri Uygulama haritası

  3. ](./media/nodejs-quick-start/azure-app-insights-analytics-icon.png) Analytics'teUygulama Analizi simgesi ![Uygulama Haritası simgesini seçin.Select the App Analytics icon Application Map icon View in Analytics. Bu eylem, Application Insights tarafından toplanan tüm verileri analiz etmek için zengin bir sorgu dili sağlayan Application Insights Analytics'iaçar.This action opens Application Insights Analytics, which provides a rich query language for analyzing all data collected by Application Insights. Bu örnekte, istek sayısını grafik olarak işleyen bir sorgu oluşturulur.In this case, a query is generated for you that renders the request count as a chart. Diğer verileri çözümlemek için kendi sorgularınızı yazabilirsiniz.You can write your own queries to analyze other data.

    Uygulama Öngörüleri Analiz grafikleri

  4. Genel Bakış sayfasına geri dönüp KPI graflarını inceleyin.Return to the Overview page and examine the KPI graphs. Bu pano, gelen istek sayısı, bu isteklerin süresi ve oluşan hatalar dahil olmak üzere uygulamanızın sistem durumu hakkında istatistikler sağlar.This dashboard provides statistics about your application health, including the number of incoming requests, the duration of those requests, and any failures that occur.

    Uygulama Öngörüleri Sağlık Genel Bakış zaman çizelgesi grafikleri

    Sayfa Görünümü Yükleme Süresi grafiğini istemci tarafı telemetri verileriyle doldurmak üzere etkinleştirmek için, bu betiği izlemek istediğiniz her sayfaya ekleyin: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. Sol tarafta İzleyici’yi seçin.On the left, select Metrics. Kaynağınızın durumunu ve kullanımını araştırmak için ölçüler gezginini kullanın.Use the metrics explorer to investigate the health and utilization of your resource. Ek özel görünümler oluşturmak için yeni grafik ekle'yi veya varolan grafik türlerini, yüksekliği, renk paletini, gruplandırmaları ve ölçümleri değiştirmek için Edit'i seçebilirsiniz.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. Örneğin, ölçümler inmeden "Tarayıcı sayfası yükleme süresi" ve toplamadan "Avg" seçerek ortalama tarayıcı sayfası yükleme süresini görüntüleyen bir grafik yapabilirsiniz.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. Azure Ölçümleri Gezgini hakkında daha fazla bilgi edinmek için Azure Ölçümleri Gezgini'ni ziyaret edin.To learn more about Azure Metrics Explorer, visit Getting started with Azure Metrics Explorer.

    Application Insights Sunucu ölçümleri grafiği

Node.js izleme hakkında daha fazla bilgi edinmek için ek AppInsights Node.js belgelerinegöz atın.To learn more about monitoring Node.js, check out the additional AppInsights Node.js documentation.

Kaynakları temizlemeClean up resources

Sınama nız bittiğinde, kaynak grubunu ve ilgili tüm kaynakları silebilirsiniz.When you're done testing, you can delete the resource group and all related resources. Bunu yapmak için aşağıdaki adımları izleyin.To do so follow the steps below.

Not

Varolan bir kaynak grubu kullandıysanız, aşağıdaki talimatlar çalışmaz ve tek tek Application Insights kaynağını silmeniz gerekir.If you used an existing resource group the instructions below will not work and you will need to just delete the individual Application Insights resource. Bir kaynak grubunu her sildiğinizde, o grubun üyesi olan tüm alt kaynaklarının silineceğini unutmayın.Keep in mind anytime you delete a resource group all underyling resources that are members of that group will be deleted.

  1. Azure portalındaki sol menüden Kaynak gruplarını seçin ve ardından myResourceGroup'useçin.From the left-hand menu in the Azure portal, select Resource groups and then select myResourceGroup.
  2. Kaynak grubu sayfanızda Sil'i, metin kutusuna myResourceGroup'u girin ve sonra Sil'iseçin.On your resource group page, select Delete, enter myResourceGroup in the text box, and then select Delete.

Sonraki adımlarNext steps