Oracle Cloud Infrastructure-Dokumentation

Ressourcendimensionen definieren

Nachdem der APM-Java-Agent bereitgestellt wurde, können Sie die Ressourcendimension auf 2 verschiedene Arten definieren:

Vereinfachte Ressourcendefinition

Die vereinfachte Ressourcendimension kann mit Schlüssel/Wert-Paareigenschaften definiert werden.

Der Schlüssel der Eigenschaft muss mit com.oracle.apm.agent.resource.tag beginnen.

Die folgende Tabelle zeigt verschiedene Möglichkeiten zur vereinfachten Definition der Ressourcendimension:

Eigenschaftstyp und Beschreibung Unterstützt von Eigenschaft Beispiel

AgentConfig.properties

Datei AgentConfig.properties im Verzeichnis oracle-apm-agent/config/<version> aktualisieren.

APM-Agent com.oracle.apm.agent.resource.tag.<ResourceName> com.oracle.apm.agent.resource.tag.MyDepartment=Sales

Systemeigenschaften

Systemeigenschaften aktualisieren.

 APM-Agent und APM-Tracer com.oracle.apm.agent.resource.tag.<ResourceName>

-Dcom.oracle.apm.agent.resource.tag.MyDepartment=Sales

-Dcom.oracle.apm.agent.resource.tag.MyUser=${USERNAME}

-Dcom.oracle.apm.agent.resource.tag.MyAppVersion=${com.mycompany.myapp.version}

Umgebungsvariablen

Umgebungsvariablen aktualisieren.

 APM-Agent und APM-Tracer com_oracle_apm_agent_resource.tag_<ResourceName>
Windows: 
set com_oracle_apm_agent_resource_tag_MyDepartment=Sales
set com.oracle.apm.agent.resource.tag.MyUser=${USERNAME}
Linux: 
export com_oracle_apm_agent_resource_tag_MyDepartment=Sales

Trace-Builder

 APM-Tracer com.oracle.apm.agent.resource.tag.<ResourceName> 
new ApmTracer.Builder(...)
    ...
    .withProperty("com.oracle.apm.agent.resource.tag.MyDepartment", "Sales")
    .withProperty("com.oracle.apm.agent.resource.tag.MyUser", "${USERNAME}")
    ...
    .build();

Der Wert der Ressourceneigenschaft kann ein statischer Text und/oder eine Variable sein, die durch die Symbole ${ und } eingeschlossen ist.

Mindestens einer der folgenden Werte wird als Ressourcendimensionswert akzeptiert:
  • Beliebiger Text.
  • Schlüssel der Java-Systemeigenschaften, die durch die Symbole ${ und } eingeschlossen sind.
  • Schlüssel der Umgebungsvariablen, die von den Symbolen ${ und } eingeschlossen sind. Beispiel:
    ${USERNAME}

Umfassende Ressourcendefinition

Die Dimension der benutzerdefinierten Application Server-Ressource kann definiert werden, um bestimmte Anforderungen zu erfüllen.

Um eine benutzerdefinierte Application Server-Ressourcendimension zu definieren, erstellen Sie eine neue Konfigurationsdatei namens ResourceCollection.acml im Verzeichnis oracle-apm-agent/config/<version>.

Die Datei ResourceCollection.acml wird nicht vom APM Agent-Deployment erstellt und muss manuell erstellt werden.

Das Format von ResourceCollection.acml ist ein benutzerdefiniertes ACML-Format (Teilmenge von YAML).

ACML-Tag Datentyp Erforderlich Beschreibung
RESSOURCEN:   ja Header der Ressourcensammlung.
<resource_entry_name>: Zeichenfolge ja Berichtsressourcenname.
Eigenschaft: <property key> Zeichenfolge ja APM-Eigenschaftsschlüssel der Ressource.

Der Eigenschaftsschlüssel dieses Ressourcenwertes. Es wird auch von anderen Ressourcen zur Auflösung von Variablen verwendet.

Typ: <resource type> Zeichenfolge ja Typ dieser Eigenschaft.
skalar: <resource skalar> Zeichenfolge ja Ressourcenwerttyp.

Unterstützte Werte sind String, Long oder Double.
Identität: <Ressource als Identität> Booleanisch Nein Kennzeichen, das angibt, ob diese Ressource für die Identitätsberechnung des Anwendungsservers verwendet wird.

Jede Ressource mit einem Wert ungleich Null wird für die appserverId-Dimensionsberechnung verwendet.

Priorität: <collection priority> Unsigned Integer Nein Positive Ganzzahl zur Angabe der Priorität der Ressourcensammlung. 0 (null) ist die höchste Priorität. Bei einer benutzerdefinierten Ressource muss dieser Wert immer auf 0 gesetzt werden.
Standard: <default value> Zeichenfolge Nein Standardwert der Ressource, wenn keine der angegebenen Quellen einen Wert ungleich Null zurückgibt.
source: Nicht anwendbar ja Arrayknoten der Quellen dieser Ressource.

Für dieses Quellarray kann mindestens ein untergeordnetes Element definiert werden. Jedes Element wird in der definierten Reihenfolge ausgewertet, und das erste Element mit einem Wert ungleich Null wird verwendet.

Wenn keine der Elementbewertungen einen Wert ungleich Null zurückgibt, wird diese Ressource ignoriert.
- Typ: MBean Zeichenfolge Nein Erfassen Sie Ressourcenmetadaten aus JMX-MBean. Für jede Ressource können mehrere definiert werden.
mbean_name: <mBean-Objektname> Zeichenfolge Nein mbean_name ist die ObjectName von MBean.
value_path: <value select path> Zeichenfolge Nein

value_path ist der schrägstrichbegrenzte Auswahlpfad ab dem angegebenen MBean.

Der erste Pfadknoten ist das Attribut des MBeans. Anschließend wird der Wert des Attributs mit jedem nachfolgenden Pfadknoten ausgewertet.

Die Bewertung unterstützt Folgendes:

  • Attribut MBean
  • ObjectName
  • Name des Java Object-Feldes
  • java object noarg method name
  • Schlüssel von CompositeData
  • Schlüssel von TubularData
  • Index des Array
  • Schlüssel der Zuordnung
  • Index der Erfassung
<regex-Parsing> Zeichenfolge Nein

Der ausgewählte Ressourcenwert kann mit regex-Parsing-Tags weiter verarbeitet werden. Weitere Informationen finden Sie unter Regex-Parsing.

Typ: Eigenschaft Zeichenfolge Nein Ressourcenwert der Systemeigenschaft oder Umgebungsvariable. Für jede Ressource können mehrere definiert werden.
Schlüssel: <property key> Zeichenfolge Nein Der Schlüsselname der Systemeigenschaft oder der Umgebungsvariable.
- Typ: Wert Zeichenfolge Nein Der statische Wert. In jeder Ressource darf höchstens ein Wert definiert werden, da dieser Wert nie Null ist.
Wert: <statischer Wert und/oder Variable> Zeichenfolge Nein Folgende Werte sind möglich:
  • Feste Zeichenfolge.
  • Systemeigenschaft.
  • Umgebungsvariable.
  • Ressourceneigenschaft.

Die Eigenschaftsschlüssel enthalten die Symbole ${ und }, die zur Laufzeit in einen Wert des angegebenen Schlüssels aufgelöst werden. Wenn der angegebene Eigenschaftsschlüssel nicht gefunden wird, enthält der Wert dieser Ressource den nicht aufgelösten Schlüssel, einschließlich der Symbole ${ und }.

<regex-Parsing> Zeichenfolge Nein Der ausgewählte Ressourcenwert kann mit regex-Parsing-Tags weiter verarbeitet werden. Weitere Informationen finden Sie unter Regex-Parsing.

Regex-Parsing

Regex-Parsing sind zusätzliche Tags des Quellknotens, um bestimmten Wert des Ressourcenwerts mit regulärem Ausdruck zu extrahieren. Syntaxdetails finden Sie unten:

Tag Basisart Beschreibung
regex: <regex:: Zeichenfolge Ein regulärer Ausdruck für Ressourcenwerte mit Gruppenerstellung.
<regex-Parsing> Unsigned Integer Eine Gruppennummer des regulären Ausdrucks. Der Wert der angegebenen Gruppe ist der endgültige Ressourcenwert.