Definisci dimensione risorsa

Una volta distribuito l'agente Java APM, è possibile definire la dimensione risorsa in 2 modi diversi:

Definizione risorsa semplificata

La dimensione risorsa semplificata può essere definita con le proprietà della coppia chiave/valore.

La chiave della proprietà deve iniziare con com.oracle.apm.agent.resource.tag.

La tabella riportata di seguito mostra diversi modi per definire la dimensione risorsa in modo semplificato.

Tipo e descrizione proprietà Supportato da Proprietà Esempio

AgentConfig.properties

Aggiornare il file AgentConfig.properties situato nella directory oracle-apm-agent/config/<version>.

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

Proprietà di sistema

Aggiornare le proprietà di sistema.

Agente APM e tracciatore APM 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}

Variabili di ambiente

Aggiornare le variabili di ambiente.

Agente APM e tracciatore APM com_oracle_apm_agent_resource.tag_<ResourceName>
Per Windows:
set com_oracle_apm_agent_resource_tag_MyDepartment=Sales
set com.oracle.apm.agent.resource.tag.MyUser=${USERNAME}
Per Linux:
export com_oracle_apm_agent_resource_tag_MyDepartment=Sales

Trace Builder

Tracer APM 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();

Il valore della proprietà della risorsa può essere un testo statico e/o una variabile racchiusa dai simboli ${ e }.

Uno o più dei valori seguenti sono accettati come valore della dimensione risorsa:
  • Qualsiasi testo.
  • Chiave delle proprietà del sistema Java racchiusa dai simboli ${ e }.
  • Chiave delle variabili di ambiente racchiuse dai simboli ${ e }. Ad esempio:
    ${USERNAME}

Definizione completa risorsa

È possibile definire una dimensione risorsa di Application Server personalizzata per soddisfare requisiti specifici.

Per definire una dimensione risorsa Application Server personalizzata, creare un nuovo file di configurazione denominato ResourceCollection.acml nella directory oracle-apm-agent/config/<version>.

Il file ResourceCollection.acml non viene creato dalla distribuzione dell'agente APM e deve essere creato manualmente.

Il formato di ResourceCollection.acml è un formato ACML personalizzato (sottoinsieme di YAML).

Tag ACML Tipo di dati Richiesto descrizione;
RISORSE:   Intestazione raccolta risorse.
<resource_entry_name>: stringa Nome risorsa di generazione report.
proprietà: <property key> stringa Chiave della proprietà APM della risorsa.

Questa è la chiave di proprietà di questo valore della risorsa. Viene utilizzato anche da altre risorse per la risoluzione variabile.

tipo: <resource type> stringa Tipo di questa proprietà.
scalare: <resource scalar> stringa Tipo di valore della risorsa.

I valori supportati sono string, long o double.

identità: <resource as identity> boolean No Il flag indica se questa risorsa viene utilizzata per il calcolo dell'identità del server applicazioni.

Per il calcolo della dimensione appserverId viene utilizzata qualsiasi risorsa con valore non nullo.

priorità: <collection priority> numero intero senza segno No Numero intero positivo che indica la priorità di raccolta delle risorse. 0 (zero) è la priorità più alta. La risorsa personalizzata deve sempre impostare questo valore su 0.
valore predefinito: <valore predefinito> stringa No Valore predefinito della risorsa quando nessuna delle origini specificate restituisce un valore non nullo.
Origine: Non applicabile Nodo di array delle origini di questa risorsa.

È possibile definire uno o più elementi figlio per questo array di origine. Ogni elemento viene valutato secondo l'ordine definito e viene utilizzato il primo con valore non nullo.

Se nessuna valutazione dell'elemento ha restituito un valore non nullo, questa risorsa viene ignorata.
- tipo: mbean stringa No Raccoglie i metadati delle risorse dall'MBean JMX. È possibile definire più risorse per ogni risorsa.
mbean_name: <mbean object name> stringa No mbean_name è ObjectName di mbean.
value_path: <value percorso di selezione> stringa No

value_path è il percorso di selezione delimitato da barre che inizia dall'MBean specificato.

Il primo nodo di percorso è l'attributo dell'MBean, quindi il valore dell'attributo viene valutato con ogni nodo di percorso successivo.

La valutazione supporta quanto segue

  • Attributo MBean
  • ObjectName
  • Nome campo oggetto Java
  • nome del metodo no-arg dell'oggetto java
  • Chiave di CompositeData
  • Chiave di TubularData
  • Indice di array
  • Chiave della mappa
  • Indice di raccolta
<regex parsing> stringa No

Il valore risorsa selezionato può essere ulteriormente elaborato utilizzando tag di analisi espressioni regolari. Per ulteriori informazioni, vedere Analisi espressioni regolari.

tipo: proprietà stringa No Valore della risorsa della proprietà di sistema o della variabile di ambiente. È possibile definire più risorse per ogni risorsa.
chiave: <property key> stringa No Nome chiave della proprietà di sistema o della variabile di ambiente.
- type: value stringa No Il valore statico. È necessario definirne al massimo uno in ogni risorsa perché questo valore non è mai nullo.
valore: <static value and/or variable> stringa No Il valore può essere uno o più dei seguenti:
  • Stringa fissa.
  • Proprietà di sistema.
  • Variabile di ambiente.
  • Proprietà risorsa.

Le chiavi delle proprietà contengono i simboli ${ e } che verranno risolti in fase di esecuzione in un valore della chiave specificata. Se la chiave di proprietà specificata non viene trovata, il valore di questa risorsa conterrà la chiave non risolta, inclusi i simboli ${ e }.

<regex parsing> stringa No Il valore risorsa selezionato può essere ulteriormente elaborato utilizzando tag di analisi espressioni regolari. Per ulteriori informazioni, vedere Analisi espressioni regolari.

Analisi Regex

L'analisi delle espressioni regolari sono tag aggiuntive del nodo di origine per estrarre valore specifico della risorsa con espressione regolare. Per i dettagli sulla sintassi, vedere di seguito:

Tag Tipo base descrizione;
espressione regolare: <espressione regolare:: stringa Espressione regolare a fronte del valore della risorsa con costruzione di gruppo.
<regex parsing> numero intero senza segno Numero di gruppo di espressioni regolari. Il valore del gruppo specificato è il valore finale della risorsa.