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 |
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> |
|
Variabili di ambiente Aggiornare le variabili di ambiente. |
Agente APM e tracciatore APM | com_oracle_apm_agent_resource.tag_<ResourceName> |
Per Windows:
Per Linux:
|
Trace Builder |
Tracer APM | com.oracle.apm.agent.resource.tag.<ResourceName> |
|
Il valore della proprietà della risorsa può essere un testo statico e/o una variabile racchiusa dai simboli ${
e }
.
- 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.
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: | sì | Intestazione raccolta risorse. | |
<resource_entry_name>: | stringa | sì | Nome risorsa di generazione report. |
proprietà: <property key> | stringa | sì | 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 | sì | Tipo di questa proprietà. |
scalare: <resource scalar> | stringa | sì | 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 | sì | 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 |
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
|
<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:
Le chiavi delle proprietà contengono i simboli |
<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. |