Documentación de Oracle Cloud Infrastructure

Definir dimensión de recurso

Después de desplegar el agente Java de APM, puede definir la dimensión de recurso de 2 formas diferentes:

Definición de recursos simplificada

La dimensión de recurso simplificado se puede definir con propiedades de par clave/valor.

La clave de la propiedad debe empezar por com.oracle.apm.agent.resource.tag.

En la siguiente tabla se muestran diferentes formas de definir la dimensión de recurso de forma simplificada:

Tipo y descripción de propiedades Soportadas por Propiedad Ejemplo

AgentConfig.properties

Actualice el archivo AgentConfig.properties ubicado en el directorio oracle-apm-agent/config/<version>.

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

Propiedades del sistema

Actualiza las propiedades del sistema.

 Agente de APM y rastreador de 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}

Variables de entorno

Actualiza las variables de entorno.

 Agente de APM y rastreador de APM com_oracle_apm_agent_resource.tag_<ResourceName>
Para Windows: 
set com_oracle_apm_agent_resource_tag_MyDepartment=Sales
set com.oracle.apm.agent.resource.tag.MyUser=${USERNAME}
Para Linux: 
export com_oracle_apm_agent_resource_tag_MyDepartment=Sales

Creador de rastreo

 Rastreador de 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();

El valor de la propiedad de recurso puede ser un texto estático y/o una variable delimitada por símbolos ${ y }.

Se acepta uno o varios de los siguientes valores como valor de dimensión de recurso:
  • Cualquier texto.
  • Clave de las propiedades del sistema Java encerradas por los símbolos ${ y }.
  • Clave de las variables de entorno encerradas por los símbolos ${ y }. Por ejemplo:
    ${USERNAME}

Definición completa de recursos

La dimensión de recurso del servidor de aplicaciones personalizado se puede definir para cumplir requisitos específicos.

Para definir una dimensión de recurso de servidor de aplicaciones personalizada, cree un nuevo archivo de configuración denominado ResourceCollection.acml en el directorio oracle-apm-agent/config/<version>.

El despliegue del agente de APM no crea el archivo ResourceCollection.acml y se debe crear manualmente.

El formato de ResourceCollection.acml es un formato ACML personalizado (subconjunto de YAML).

Etiqueta ACML Tipo de datos Necesario Descripción
RECURSO:   si Cabecera de recopilación de recursos.
<resource_entry_name>: string si Nombre de recurso de informe.
propiedad: <property key> string si Clave de propiedad de APM del recurso.

Clave de propiedad de este valor de recurso. También lo utilizan otros recursos para la resolución de variables.

tipo: <tipo de recurso> string si Tipo de esta propiedad.
escalar: <resource escalar> string si Tipo de valor de recurso.

Los valores soportados son cadena, larga o doble.
identidad: <resource as identity> booleano No El indicador indica si este recurso se utiliza para el cálculo de identidad del servidor de aplicaciones.

Cualquier recurso con un valor no nulo se utiliza para el cálculo de la dimensión appserverId.

Prioridad: <prioridad de recopilación> entero sin signo No Entero positivo para indicar la prioridad de recopilación de recursos. 0 (cero) es la prioridad más alta. El recurso personalizado siempre debe definir este valor en 0.
por defecto: <valor por defecto> string No Valor por defecto del recurso cuando ninguno de los orígenes especificados devuelve un valor no nulo.
source: No aplicable si Nodo de matriz de los orígenes de este recurso.

Se puede definir uno o varios elementos secundarios para esta matriz de origen. Cada elemento se evalúa en orden según se define y se utiliza el primero con un valor no nulo.

Si ninguna de las evaluaciones de elementos ha devuelto un valor no nulo, se ignora este recurso.
- tipo: mbean string No Recopilar metadatos de recursos del mbean de JMX. Se pueden definir varios para cada recurso.
mbean_name: <nombre de objeto de MBean> string No mbean_name es el valor ObjectName de mbean.
value_path: <ruta de selección de valor> string No

value_path es la ruta de selección delimitada por barras que comienza desde el mbean especificado.

El primer nodo de ruta es el atributo del mbean y, a continuación, el valor del atributo se evalúa con cada nodo de ruta sucesiva.

La evaluación admite lo siguiente:

  • Atributo MBean
  • ObjectName
  • Nombre de campo de objeto Java
  • nombre de método no-arg de objeto java
  • Clave de CompositeData
  • Clave de TubularData
  • Índice de matriz
  • Clave de mapa
  • Índice de recopilación
<análisis régex> string No

El valor de recurso seleccionado se puede procesar más utilizando etiquetas de análisis de expresión regular. Consulte Análisis de expresión regular para obtener más información.

tipo: propiedad string No Valor de recurso de propiedad del sistema o variable de entorno. Se pueden definir varios para cada recurso.
clave: <property key> string No Nombre de clave de la propiedad del sistema o la variable de entorno.
- escriba: value string No El valor estático. Se debe definir como máximo uno en cada recurso porque este valor nunca es nulo.
valor: <valor estático y/o variable> string No El valor puede ser uno o varios de los siguientes:
  • Cadena fija.
  • Propiedad del sistema.
  • Variable de elemento.
  • Propiedades del recurso.

Las claves de propiedades contienen los símbolos ${ y } que se resolverán en tiempo de ejecución en un valor de clave especificada. Si no se encuentra la clave de propiedad especificada, el valor de este recurso contendrá la clave sin resolver, incluidos los símbolos ${ y }.

<análisis régex> string No El valor de recurso seleccionado se puede procesar más utilizando etiquetas de análisis de expresión regular. Consulte Análisis de expresión regular para obtener más información.

Análisis de expresiones regulares

El análisis de expresiones regulares son etiquetas adicionales del nodo de origen para extraer un valor específico del valor de recurso con expresión regular. Para obtener detalles de la sintaxis, consulte lo siguiente:

Etiqueta Tipo base Descripción
regex: <regex:: string Expresión regular con respecto al valor de recurso con construcción de grupo.
<análisis régex> entero sin signo Número de grupo de expresiones regulares. El valor del grupo especificado es el valor de recurso final.