Konfigurera JMX-mått

Application Insights Java 3.x samlar in några av JMX-måtten (Java Management Extensions) som standard, men i många fall räcker det inte. Det här dokumentet beskriver JMX-konfigurationsalternativet i information.

Hur gör jag för att samla in extra JMX-mått?

JMX-måttsamlingen kan konfigureras genom att lägga till ett "jmxMetrics" avsnitt i filen applicationinsights.json. Ange ett namn på måttet som du vill att det ska visas i Azure Portal i application insights-resursen. Objektnamn och attribut krävs för vart och ett av de mått som du vill samla in. Du kan använda * i objektnamn för jokertecken i globformat (information).

Hur gör jag för att vet du vilka mått som är tillgängliga för konfiguration?

Du spikade det – du måste känna till objektnamnen och attributen, dessa egenskaper skiljer sig åt för olika bibliotek, ramverk och programservrar och är ofta inte väldokumenterade. Som tur är är det enkelt att hitta exakt vilka JMX-mått som stöds för din specifika miljö.

Om du vill visa tillgängliga mått anger du självdiagnostiknivån till i applicationinsights.json konfigurationsfilen, till DEBUG exempel:

{
  "selfDiagnostics": {
    "level": "DEBUG"
  }
}

Tillgängliga JMX-mått, med objektnamn och attributnamn, visas i Application Insights-loggfilen.

Loggfilens utdata ser ut ungefär som i de här exemplen. I vissa fall kan det vara omfattande.

Du kan också använda ett kommandoradsverktyg för att kontrollera tillgängliga JMX-mått.

Konfigurationsexempel

Om du vet vilka mått som är tillgängliga kan du konfigurera agenten så att den samlar in dem. Den första är ett exempel på ett kapslat mått – LastGcInfo som har flera egenskaper och vi vill samla in 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"
      }
],

Var hittar jag JMX-måtten i application insights?

Du kan visa JMX-måtten som samlas in medan programmet körs genom att gå till application insights-resursen i Azure Portal. Under fliken Mått väljer du listrutan så som du ser för att visa måtten.