Konfigurera JMX-måttConfiguring JMX metrics

Application Insights Java 3,0-agenten samlar in några av JMX-måtten som standard, men i många fall är detta inte tillräckligt.Application insights Java 3.0 agent collects some of the JMX metrics by default, but in many cases this is not enough. Det här dokumentet beskriver konfigurations alternativet JMX i information.This document describes the JMX configuration option in details.

Hur gör jag för att samla in ytterligare JMX-mått?How do I collect additional JMX metrics?

JMX Metrics-insamling kan konfigureras genom att lägga till ett "jmxMetrics" avsnitt i applicationinsights.jsi filen.JMX metrics collection can be configured by adding a "jmxMetrics" section to the applicationinsights.json file. Du kan ange namnet på måttet som du vill att det ska visas i Azure Portal i Application Insights-resursen.You can specify the name of the metric the way you want it to appear in Azure portal in application insights resource. Du måste definiera objekt namn och-attribut för varje mått som du vill samla in.You have to define the object name and attribute for each of the metrics you want collected.

Hur gör jag för att vet du vilka mått som är tillgängliga för konfiguration?How do I know what metrics are available to configure?

Du Nailed det – du måste känna till objekt namn och attribut, dessa egenskaper är olika för olika bibliotek, ramverk och program servrar och är ofta inte väl dokumenterade.You nailed it - you must know the object names and the attributes, those properties are different for various libraries, frameworks, and application servers, and are often not well documented. Om du vill hämta objekt namn och attribut måste du Visa MBean-trädet.To get the object names and attributes, you need to view the MBean tree. En MBean är ett hanterat Java-objekt som kan representera en enhet, ett program eller en resurs och har en uppsättning attribut.An MBean is a managed Java object, that can represent a device, an application, or a resource, and has a set of attributes.

Om du vill visa tillgängliga mått och bläddra igenom tillgängliga mått, rekommenderar vi att du använder Java-Mission.To view the available metrics and browse through the available metrics, we recommend using Java Mission Control.

Hur navigerar du i Java-uppdraget för att komma till rätt mått?How to navigate the Java Mission Control to get to the right metrics?

När du kör verktyget för Java-Mission har du ett urval av JVMs som är tillgängliga på den vänstra sidan. Klicka på den aktuella processen under fliken "JVM Browser". Vänta tills JMC läser in instrument panelen för processen och välj fliken "MBean Browser" längst ned (se nedan).When you run the Java Mission Control tool, you'll have a selection of JVMs available on the left side, click on the relevant process under the 'JVM Browser' tab. Wait until JMC loads the dashboard for the process, select 'MBean Browser' tab on the bottom (see below). JMC måste finnas i samma mapp som JVM och din process/app måste vara igång.The JMC must be located in the same folder as the JVM and your process/app must be up and running.

Skärm bild av JMC MBean-webbläsare

Hur kommer du till de mått som jag vill ha och de nödvändiga attributen?How to get to the metrics I want, and the necessary attributes?

MBean-webbläsaren öppnar MBean-trädet med listan över kategorier som kan expanderas.The MBean browser opens the MBean tree with the list of categories that can be expanded. Om du väljer en kategori till vänster öppnas listan med attribut till höger.Selecting a category on the left opens the list of attributes on the right. Nedan visas ett exempel på ett mått, dess objekt namn och attribut.Below is an example of a metric, its object name, and the attributes. Attributen kan vara kapslade, som i exemplet nedan.The attributes may be nested, as in the example below.

Skärm bild av JMC MBean-träd

Konfigurations exempelConfiguration example

Från valet som du ser i bilden ovan kan du konfigurera några mått.From the selection as shown in the image above, lets configure a few metrics. Det första är ett exempel på ett kapslat mått – LastGcInfo som har flera egenskaper och vi vill samla in GcThreadCount .The first one is an example of a nested metric - LastGcInfo that has several properties, and we want to capture the GcThreadCount.

"jmxMetrics": [
      {
        "name": "Demo - GC Thread Count",
        "objectName": "java.lang:type=GarbageCollector,name=PS MarkSweep",
        "attribute": "LastGcInfo.GcThreadCount"
      },
      {
        "name": "Demo - GC Collection Count",
        "objectName": "java.lang:type=GarbageCollector,name=PS MarkSweep",
        "attribute": "CollectionCount"
      },
      {
        "name": "Demo - Thread Count",
        "objectName": "java.lang:type=Threading",
        "attribute": "ThreadCount"
      }
],

Typer av insamlade mått och tillgängliga konfigurations alternativ?Types of collected metrics and available configuration options?

Vi stöder numeriska och booleska JMX-mått, medan andra typer inte stöds och kommer att ignoreras.We support numeric and boolean JMX metrics, while other types aren't supported and will be ignored.

Jokertecken och aggregerade attribut stöds för närvarande inte, det är anledningen till att varje attribut objekt namn/attribut-paret måste konfigureras separat.Currently, the wildcards and aggregated attributes aren't supported, that's why every attribute 'object name'/'attribute' pair must be configured separately.

Var hittar jag JMX-måtten i Application Insights?Where do I find the JMX Metrics in application insights?

När ditt program körs och JMX-måtten samlas in kan du visa dem genom att gå till Azure Portal och navigera till Application Insights-resursen.As your application is running and the JMX metrics are collected, you can view them by going to Azure portal and navigate to your application insights resource. Under fliken mått väljer du den nedrullningsbara List rutan som visas nedan för att visa måtten.Under Metrics tab, select the dropdown as shown below to view the metrics.

Skärm bild av mått i portalen