JMX-metrische gegevens configureren

Application Insights Java 3.x verzamelt standaard enkele metrische gegevens van Java Management Extensions (JMX), maar in veel gevallen is dit niet voldoende. In dit document wordt de configuratieoptie JMX in detail beschreven.

Hoe kan ik extra JMX-metrische gegevens verzamelen?

Verzameling met metrische gegevens van JMX kan worden geconfigureerd door een "jmxMetrics" sectie toe te voegen aan het applicationinsights.json-bestand. Voer een naam in voor de metrische waarde die u wilt weergeven in De Azure-portal in de Application Insights-resource. Objectnaam en kenmerk zijn vereist voor elk van de metrische gegevens die u wilt verzamelen. U kunt objectnamen gebruiken * voor jokertekens in glob-stijl (details).

Hoe kan ik weten welke metrische gegevens beschikbaar zijn om te configureren?

U hebt het genageld: u moet de objectnamen en de kenmerken kennen, deze eigenschappen verschillen voor verschillende bibliotheken, frameworks en toepassingsservers en zijn vaak niet goed gedocumenteerd. Gelukkig is het gemakkelijk om precies te vinden welke metrische gegevens van JMX worden ondersteund voor uw specifieke omgeving.

Als u de beschikbare metrische gegevens wilt weergeven, stelt u het niveau DEBUG voor zelfdiagnose in op het applicationinsights.json configuratiebestand, bijvoorbeeld:

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

Beschikbare JMX-metrische gegevens, met objectnamen en kenmerknamen, worden weergegeven in uw Application Insights-logboekbestand.

Uitvoer van logboekbestanden ziet er ongeveer als volgt uit. In sommige gevallen kan het uitgebreid zijn.

U kunt ook een opdrachtregelprogramma gebruiken om de beschikbare metrische gegevens van JMX te controleren.

Configuratievoorbeeld

Als u weet welke metrische gegevens beschikbaar zijn, kunt u de agent configureren om ze te verzamelen. De eerste is een voorbeeld van een geneste metriek, LastGcInfo die verschillende eigenschappen heeft en we willen de 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"
      }
],

Waar vind ik de metrische gegevens van JMX in Application Insights?

U kunt de metrische gegevens van JMX bekijken die worden verzameld terwijl uw toepassing wordt uitgevoerd door te navigeren naar uw Application Insights-resource in Azure Portal. Selecteer op het tabblad Metrische gegevens de vervolgkeuzelijst zoals wordt weergegeven om de metrische gegevens weer te geven.