Documentación de Oracle Cloud Infrastructure

Atributos de rastreo y período para el agente Java de APM

Los atributos de rastreo (rango raíz) y de intervalo del explorador de rastreo se definen mediante el etiquetado de un período, que permiten la supervisión efectiva de los distintos niveles de una aplicación.

Los atributos son pares clave-valor asociados al período para proporcionar información adicional y contexto sobre la operación realizada en el período. Un rastreo tiene algunos atributos de solo rastreo, así como todos los atributos de período del período raíz.

En el explorador de rastreo, puede utilizar atributos para consultar y filtrar rastreos y períodos. Hay dos tipos de atributos: Dimensiones (atributos de cadena) y Métricas (atributos numéricos) que están disponibles en el panel Atributos del explorador de rastreo.

En esta sección se proporciona una lista completa de los atributos listos para usar aplicables al agente Java de APM. La siguiente tabla incluye:

  • Nombre: nombre del atributo.
  • Descripción: breve descripción del atributo.
  • Rastreo/intervalo: disponibilidad del atributo. Un atributo puede estar disponible para rastreos, períodos o ambos.
  • Tipo: tipo de atributo: Dimensión o Métrica.
Nombre Descripción Rastreo/intervalo Tipo
ApmVersion Versión del agente de la aplicación Application Performance Monitoring. Atributo de rastreo y período Dimensión
Appserver Indicador para indicar si se ha detectado un servidor de aplicaciones. Cuando el Tipo de Servidor de Aplicaciones es java-jmx o java-no-jmx, esta dimensión se define en false. Atributo de rastreo y período Dimensión
AppserverDisplayPort El número de puerto del servidor. El valor por defecto es el puerto HTTPS más bajo, si está disponible, o el puerto HTTP más bajo. Atributo de rastreo y período Dimensión
AppserverId Hash de recursos significativos del servidor para aplicaciones, que indica si hay algún cambio de recursos en el servidor para aplicaciones con el tiempo. Atributo de rastreo y período Dimensión
AppserverName Nombre del servidor del aplicativo. Atributo de rastreo y período Dimensión
AppserverPorts Los números de puerto del servidor para aplicaciones. Normalmente, solo hay un número de puerto para el servidor de Oracle WebLogic y varios para el servidor de Apache Tomcat. Si hay varios números de puerto, los valores están separados por comas. Atributo de rastreo y período Dimensión
AppserverType El tipo de servidor de aplicaciones. Por ejemplo: Weblogic o Tomcat. Atributo de rastreo y período Dimensión
AppserverVersion La versión del software del servidor. Atributo de rastreo y período Dimensión
ClassMethod Nombre de clase y nombre de método donde se produjo la observación de intervalo. Atributo de rastreo y período Dimensión
ClientIp

IP del cliente que ha llamado al servlet a través de HTTP.

Por defecto, el agente comprobará la cabecera de solicitud X-FORWARDED-FOR para esta información.

Si no está disponible, llamará al método ServletRequest.getRemoteAddr.

El comportamiento por defecto se puede actualizar mediante el archivo ProbeConfig.acml del agente Java de APM. (Consulte los parámetros capture_client_ip y client_ip_header.)

Esta información se utiliza para GeoMap. Según las IP de cliente que se capturen, la configuración de la asignación de IP geográfica puede ayudar a proporcionar resultados más precisos.

Atributo de rastreo y período Dimensión
Component Componente que ha generado el período a partir del estándar https://opentracing.io/specification/conventions/, con valores como JDBC, SERVLET y BROWSER. Atributo de rastreo y período Dimensión
ContextRoot La raíz de contexto de la aplicación web supervisada. Atributo de rastreo y período Dimensión
DbConnUrl URL de conexión JDBC utilizada para conectarse a la base de datos. Atributo de rastreo y período Dimensión
DbOracleConnectionId ID de conexión única de Oracle Net generado por el controlador JDBC de Oracle para cada conexión JDBC a la base de datos Oracle. Este atributo está soportado en los clientes JDBC de Oracle 21 y posteriores. Atributo de rastreo y período Dimensión
DbErrorSqlState El código SQLState devuelto por SQLException.getSQLState en escenarios de error. Atributo de rastreo y período Dimensión
DbErrorVendorCode Número que identifica el error que ha provocado que se devuelva la instancia SQLException. Atributo de rastreo y período Métrica
DbOracleSessionId ID de sesión de Oracle de la sentencia ejecutada. Atributo de rastreo y período Dimensión
DbOracleSqlId ID de SQL de Oracle calculado a partir de la sentencia SQL ejecutada. Atributo de rastreo y período Dimensión
DbOracleSqlId1 En las ejecuciones de sentencias por lotes, el ID de Oracle SQL se calcula a partir de la primera sentencia SQL ejecutada. Atributo de rastreo y período Dimensión
DbOracleSqlId2 En ejecuciones de sentencias por lotes, el ID de SQL de Oracle se calcula a partir de la segunda sentencia SQL ejecutada. Atributo de rastreo y período Dimensión
DbStatement Texto SQL normalizado ejecutado por la sentencia JDBC. Atributo de rastreo y período Dimensión
DbStatement1 En ejecuciones de sentencias por lotes, el texto SQL normalizado de la primera sentencia JDBC ejecutada. Atributo de rastreo y período Dimensión
DbStatement2 En ejecuciones de sentencias por lotes, el texto SQL normalizado de la segunda sentencia JDBC ejecutada. Atributo de rastreo y período Dimensión
DbStatementAdditionalFetchCount Número de idas y vueltas a la base de datos para recuperar filas de juego de resultados adicionales no devueltas al ejecutar la sentencia inicial. Atributo de rastreo y período Métrica
DbStatementAdditionalFetchTime Tiempo (en milisegundos) empleado en recuperar filas de juegos de resultados adicionales de la base de datos que no se devolvieron al ejecutar la sentencia inicial. Atributo de rastreo y período Métrica
DbStatementExecTime Tiempo (en milisegundos) dedicado a la ejecución de la sentencia inicial y a devolver las filas iniciales. Atributo de rastreo y período Métrica
DbType Tipo de la base de datos. Actualmente solo están soportadas las bases de datos de tipo 'sql'. Atributo de rastreo y período Dimensión
DbUser El usuario de conexión JDBC subyacente. Atributo de rastreo y período Dimensión
DeploymentInfo Información de despliegue sobre la aplicación web supervisada. Esto se puede mostrar en dos formatos, según si el tipo de despliegue está disponible:

<Deployment Name>; <Deployment File Name>

<Deployment Name>; <Deployment File Name>; <Deployment Type>

 Atributo de rastreo y período Dimensión
DisplayName Nombre mostrado del servidor del aplicativo. Atributo de rastreo y período Dimensión
ECID ID de contexto de ejecución de Oracle. Atributo de período Dimensión
Error Propiedad span que marca un período como "con fallos" con el valor booleano true, en caso de error. Esto indica que la aplicación consideró que la operación representada por el período falló. El valor booleano por defecto es false (sin error). Atributo de rastreo y período Dimensión
ErrorObject Descripción del error en lenguaje natural. Atributo de rastreo y período Dimensión
GenAIChatHistory El historial o contexto de conversaciones de interacciones anteriores con el modelo de IA generativa Atributo de período Dimensión
GenAICompartmentId Identificador único del compartimento en el que se procesa la solicitud GenAI. Atributo de período Dimensión
GenAIEmbeddingsPerSentence Tamaño de la incrustación de vectores generada por frase. Específico del modelo utilizado Atributo de período Dimensión
GenAIEmbedResponseId Identificador único para la respuesta de embebido Atributo de período Dimensión
GenAIEmbedSentenceCount Número de frases procesadas para la generación de incrustaciones Atributo de período Dimensión
GenAIEmbedTruncate Estrategia para truncar entradas que superan los límites del modelo (por ejemplo, NONE, START) Atributo de período Dimensión
GenAIFinishReason Motivo por el que el modelo dejó de generar la respuesta (por ejemplo, límite máximo de token, secuencia de detención) Atributo de período Dimensión
GenAIFrequencyPenalty Penaliza la repetición de palabras en función de la frecuencia de la aparición de palabras Atributo de período Dimensión
GenAIInputSentences Las frases o fragmentos de texto reales enviados para incrustarlos Atributo de período Dimensión
GenAIIsEcho Indicador booleano que indica si la petición de datos se debe repetir en la respuesta Atributo de período Dimensión
GenAIMaxTokens Número máximo de tokens que el modelo puede generar en su respuesta Atributo de período Dimensión
GenAIModelName Nombre del modelo de IA generativa que se está utilizando para la solicitud (por ejemplo, cohere.command) Atributo de período Dimensión
GenAIModelVersion Versión específica del modelo de IA generativa que se está utilizando Atributo de período Dimensión
GenAINumGenerations Número de respuestas alternativas generadas para la misma solicitud Atributo de período Dimensión
GenAIOpcRequestId ID único para rastrear la solicitud Atributo de período Dimensión
GenAIPresencePenalty Penaliza las palabras después de la primera ocurrencia, no tiene en cuenta la frecuencia de ocurrencia Atributo de período Dimensión
GenAIPrompt La petición de datos con formato final enviada al modelo, incluidas las instrucciones del sistema, el preámbulo, la entrada del usuario, los documentos, la información de la herramienta, etc. Atributo de período Dimensión
GenAIPromptLength Recuento total de caracteres de la petición de datos completa Atributo de período Dimensión
GenAIQuery Consulta de entrada del usuario enviada al modelo de IA generativa Atributo de período Dimensión
GenAIQueryLength Recuento de caracteres de la consulta de entrada del usuario Atributo de período Dimensión
GenAIResponse La respuesta completa generada por el modelo de IA generativa Atributo de período Dimensión
GenAIResponseLength Recuento de caracteres de la respuesta del modelo de IA generativa Atributo de período Dimensión
GenAIResponseTimeCreated Registro de hora en el que se generó la respuesta de IA generativa Atributo de período Dimensión
GenAISearchQueriesOnly Si es true, solo devuelve las consultas de búsqueda relevantes, no las respuestas completas Atributo de período Dimensión
GenAISeed Valor inicial aleatorio utilizado para los resultados de generación reproducibles Atributo de período Dimensión
GenAIStatusCode Código de estado HTTP devuelto por el punto final de IA generativa Atributo de período Dimensión
GenAIStopSequences Lista de secuencias personalizadas especificadas por el usuario que disparan el modelo para dejar de generar texto Atributo de período Dimensión
GenAITemperature Controla la aleatoriedad en las palabras seleccionadas para la respuesta, la temperatura más baja es más determinista Atributo de período Dimensión
GenAITopK Limita las opciones de tokens del modelo a los tokens K más probables en función de sus probabilidades previstas Atributo de período Dimensión
GenAITopP El modelo selecciona su siguiente token del juego de candidatos más probables cuya probabilidad acumulada se suma al umbral de p superior Atributo de período Dimensión
GenAITotalInputLength Recuento total de caracteres de todas las oraciones de entrada o fragmentos de texto combinados para la generación de embebido Atributo de período Dimensión
GenAIUserPreamble Instrucciones personalizadas o contexto proporcionado antes de la consulta principal Atributo de período Dimensión
HostAddress La dirección IPv4 se resuelve a partir del nombre del host. Atributo de rastreo y período Dimensión
Hostname Nombre del host. Atributo de rastreo y período Dimensión
HostnameCanonical Nombre canónico (FQDN) del host. Atributo de rastreo y período Dimensión
HostNames La lista de nombres de host en las interfaces de red del host. Atributo de rastreo y período Dimensión
HttpClientType Tipo de cliente HTTP que se está supervisando, por ejemplo, Apache HttpClient y HttpURLConnection. Atributo de rastreo y período Dimensión
HttpMethod Método HTTP utilizado en la solicitud, por ejemplo, GET, POST y DELETE. Atributo de rastreo y período Dimensión
HttpRequestContentSize Longitud de contenido de la solicitud si se ha definido Content-Length como parte de la cabecera de solicitud. Atributo de rastreo y período Dimensión
HttpResponseContentSize Longitud de contenido de la respuesta si se ha definido Content-Length como parte de la cabecera de respuesta. Atributo de rastreo y período Dimensión
HttpStatusCode Código de estado HTTP de la respuesta, por ejemplo, 200, 404 o 500. Atributo de rastreo y período Dimensión
HttpStatusDetails Descripción del código de estado de respuesta HTTP. Atributo de rastreo y período Dimensión
HttpUrl URL de HTTP relacionada con el período. Atributo de rastreo y período Dimensión
HttpUrlFragment Fragmento de URL de HTTP relacionado con el período. Atributo de rastreo y período Dimensión
HttpUrlHost Nombre de host de URL de HTTP relacionado con el período. Atributo de rastreo y período Dimensión
HttpUrlPath Ruta de URL de HTTP relacionada con el período. Atributo de rastreo y período Dimensión
HttpUrlQuery Consulta de URL de HTTP relacionada con el período. Atributo de rastreo y período Dimensión
Kind Campo relacionado con la definición de rastreo abierto (https://opentracing.io/specification/conventions/) span.kind0. El agente del explorador puede informar valores como CLIENT o INTERNAL, y el agente Java y otros rastreadores pueden informar valores como SERVER para servlets y CLIENT para HttpClient y JDBC. Atributo de rastreo y período Dimensión
NonSampledCount Número de períodos raíz anteriores no muestreados que tienen el mismo nombre de operación. Atributo de rastreo y período Métrica
OciAvailabilityDomain Dominio de disponibilidad de Oracle Cloud Infrastructure en el que se está ejecutando el recurso informático. Atributo de rastreo y período Dimensión
OciCompartmentId OCID del compartimento en el que reside el recurso informático. Atributo de rastreo y período Dimensión
NonSampledCount Número de períodos raíz anteriores no muestreados que tienen el mismo nombre de operación. Atributo de rastreo y período Métrica
OciAvailabilityDomain Dominio de disponibilidad de Oracle Cloud Infrastructure en el que se está ejecutando el recurso informático. Atributo de rastreo y período Dimensión
OciComputeShape La unidad de la instancia de computación. Atributo de rastreo y período Dimensión
OciDisplayName Nombre mostrado de la instancia informática o del nodo de de Kubernetes. Atributo de rastreo y período Dimensión
OciFaultDomain Nombre del dominio de fallos de Oracle Cloud Infrastructure en el que se está ejecutando el recurso informático. Atributo de rastreo y período Dimensión
OciInstanceId OCID de la instancia informática. Atributo de rastreo y período Dimensión
OciRegion Región de Oracle Cloud Infrastructure que contiene el dominio de disponibilidad en el cual se está ejecutando el recurso informático. Atributo de rastreo y período Dimensión
OpcRequestIdRequest El valor de cabecera opc-request-id definido como parte de la solicitud enviada a Oracle Cloud Infrastructure. Atributo de rastreo y período Dimensión
OpcRequestIdResponse El valor de cabecera opc-request-id definido como parte de la respuesta enviada desde Oracle Cloud Infrastructure. Atributo de rastreo y período Dimensión
OperationName Nombre del período. Atributo de rastreo y período Dimensión
OsAvailableProcessors Número de procesadores disponibles en Java Virtual Machine (JVM). Atributo de rastreo y período Métrica
OsFamily Familia del sistema operativo derivada del agente del usuario. Por ejemplo, Linux. Atributo de rastreo y período Dimensión
OsName Nombre del sistema operativo. Atributo de rastreo y período Dimensión
OsVersion La versión del sistema operativo. Atributo de rastreo y período Dimensión
ProcessId Identificador de proceso del servidor. Atributo de rastreo y período Métrica
RequestPayload Cuerpo de carga útil de solicitud capturado como parte de la solicitud. La carga útil de la solicitud se puede filtrar para mostrar solo información útil mediante una combinación de xpath, jsonpath o regex. Para obtener más información, consulte el archivo ProbeConfig.acml. Atributo de rastreo y período Dimensión
ResponsePayload Cuerpo de carga útil de respuesta capturado como parte de la respuesta. La carga útil de respuesta se puede filtrar para mostrar solo información útil mediante una combinación de xpath, jsonpath o regex. Para obtener más información, consulte el archivo ProbeConfig.acml. Atributo de rastreo y período Dimensión
ServletContainerSpecification Versión de la especificación de servlet en la que se basa la aplicación representada por este ServletContext.

Atributo de rastreo y período Dimensión
ServletSpecification Versión de la API de servlet que soporta este contenedor de servlet. Atributo de rastreo y período Dimensión
ServiceInstanceId Identificador de observador del agente. Atributo de rastreo y período Dimensión
ServiceName Nombre que ha asignado al servicio. Atributo de rastreo y período Dimensión
SessionId Identificador único de la sesión o el explorador. Atributo de rastreo y período Dimensión
SoaTaskAssigneeUsers Lista de nombres de usuario de los usuarios a los que se ha asignado esta tarea.

Para ver esta dimensión, debe definir capture_username=true en el archivo ProbeConfig.acml.

Este atributo está presente al utilizar Oracle SOA Human Workflow.

 Atributo de período Dimensión
SoaTaskCompletionDuration Tiempo en milisegundos desde que se inicia la tarea hasta que se completa.

Este atributo está presente al utilizar Oracle SOA Human Workflow.

 Atributo de período Dimensión
SoaTaskName Nombre de la tarea.

Este atributo está presente al utilizar Oracle SOA Human Workflow.

 Atributo de período Dimensión
SoaTaskNumber Número de tarea que se ve en la columna Number de la lista de trabajo de BPM.

Este atributo está presente al utilizar Oracle SOA Human Workflow.

 Atributo de período Dimensión
SoaTaskOutcome El resultado de la tarea cuando se completa.

Este atributo está presente al utilizar Oracle SOA Human Workflow.

 Atributo de período Dimensión
SoaTaskRequester Nombre de usuario del solicitante de la tarea.

Para ver esta dimensión, debe definir capture_username=true en el archivo ProbeConfig.acml.

Este atributo está presente al utilizar Oracle SOA Human Workflow.

 Atributo de período Dimensión
SoaTaskState Estado de la tarea.

Este atributo está presente al utilizar Oracle SOA Human Workflow.

 Atributo de período Dimensión
SoaTaskSubstate Subestado de la tarea, si está disponible.

Este atributo está presente al utilizar Oracle SOA Human Workflow.

 Atributo de período Dimensión
SoaWorkflowNumber Número de flujo de trabajo.

Este atributo está presente al utilizar Oracle SOA Human Workflow.

 Atributo de período Dimensión
SpanID Identificador único para cada período. Atributo de período Dimensión
StartTime La hora de inicio del período. Atributo de período Métrica
Subcomponent Subcomponente que generó el período. Atributo de período Dimensión
ThreadAllocatedMemory La aproximación de la cantidad total de memoria en bytes asignada en memoria de pila para el período de servlet asociado. Esta información se obtiene de ThreadMXBean y se captura por defecto.

El comportamiento por defecto se puede desactivar mediante el archivo ProbeConfig.acml del agente Java de APM. (Consulte el parámetro tag_thread_allocated_memory).

Atributo de período Dimensión
ThreadCpuTime Tiempo total de CPU para el período de servlet asociado en milisegundos. Esta información se obtiene de ThreadMXBean y se captura por defecto.

El comportamiento por defecto se puede desactivar mediante el archivo ProbeConfig.acml del agente Java de APM. (Consulte el parámetro tag_thread_cpu_time).

Atributo de período Dimensión
ThreadId ID del thread en el que se inició el período. Atributo de período Métrica
ThreadIdEnd ID del thread en el que finalizó el período. Atributo de período Métrica
ThreadName Nombre del thread en el que se inició el período. Atributo de período Dimensión
ThreadNameEnd Nombre del thread en el que finalizó el período. Atributo de período Dimensión
UserName El nombre de usuario del usuario final que utiliza el sistema o un identificador que identifica de forma única al usuario.

Para obtener información sobre las opciones de configuración y captura del nombre de usuario, consulte Modify or Disable Default Probe Settings.

Atributo de rastreo y período Dimensión
VmName Nombre de la máquina virtual. Atributo de rastreo y período Dimensión
VmVendor Proveedor de la máquina virtual. Atributo de rastreo y período Dimensión
VmVersion Versión de la máquina virtual. Atributo de rastreo y período Dimensión
WorkingDirectory El directorio de trabajo del servidor para aplicaciones. Atributo de rastreo y período Dimensión