Objeto de traza de APM
Los siguientes objetos están directamente relacionados con la API apmtrace.
Cada propiedad, excepto span_count y error_count, corresponde a una columna de la tabla otel_traces del origen de datos de telemetría.
La mayoría de las propiedades corresponden a la columna con el mismo nombre (por ejemplo, la propiedad span_name corresponde a la columna SpanName).
Cuando los nombres difieren, las columnas del origen de datos se especifican en las tablas siguientes.
Para consultar la lista de columnas, consulte Columnas de datos de telemetría compatibles.
Traza de APM
El objeto de traza de APM representa una traza (la ruta que sigue una solicitud a través de sus aplicaciones y servicios). Una traza consta de uno o más spans; cada span representa una única operación.
El objeto de traza de APM se basa en el span raíz de la traza (el span que inicia la traza y no tiene un span principal).
Todas las propiedades contienen datos del span raíz, excepto span_count y error_count, que se calculan a partir de todos los spans de la traza.
El objeto de traza de APM tiene las siguientes propiedades:
| Propiedad | Tipo | Descripción |
|---|---|---|
| timestamp | integer | Hora Unix (en nanosegundos) en la que se inició el span raíz. Comportamiento de la propiedad: - solo lectura |
| traceid | string | ID de la traza, compartido por todos los spans que pertenecen a la traza. Comportamiento de la propiedad: - solo lectura |
| spanid | string | ID del span raíz. Comportamiento de la propiedad: - solo lectura |
| trace_state | string | Datos adicionales, si los hay, que las herramientas de trazado adjuntan a la traza (consulte W3C Trace Context). Comportamiento de la propiedad: - solo lectura |
| span_name | string | Nombre de la operación que representa el span raíz (por ejemplo, POST /zabbix.php).Comportamiento de la propiedad: - solo lectura |
| span_kind | string | Rol del span raíz. Valores posibles: Unspecified: el tipo de span no está especificado;Internal: operación realizada dentro de una aplicación;Server: gestión de una solicitud entrante;Client: solicitud saliente;Producer: creación de una operación asíncrona (por ejemplo, el envío de un mensaje);Consumer: procesamiento de una operación asíncrona.Comportamiento de la propiedad: - solo lectura |
| service_name | string | Nombre del servicio que produjo el span raíz (por ejemplo, zabbix-nginx), obtenido del atributo de recurso service.name de OpenTelemetry.Comportamiento de la propiedad: - solo lectura |
| resource_attributes | object | Atributos de recurso clave-valor del span raíz (por ejemplo, host.name: eabf8c2a5ddc).Comportamiento de la propiedad: - solo lectura |
| scope_name | string | Nombre del ámbito de instrumentación que produjo el span raíz. Comportamiento de la propiedad: - solo lectura |
| scope_version | string | Versión del ámbito de instrumentación. Comportamiento de la propiedad: - solo lectura |
| span_attributes | object | Atributos del span clave-valor del span raíz (por ejemplo, http.method: POST).Comportamiento de la propiedad: - solo lectura |
| duration | integer | Nanosegundos de duración de la traza. Comportamiento de la propiedad: - solo lectura |
| status_code | string | Estado de la operación que representa el span raíz. Valores posibles: Unset: no se ha asignado ningún estado explícito al span raíz;Ok: la operación se completó correctamente;Error: la operación se completó con un error.Comportamiento de la propiedad: - solo lectura |
| status_message | string | Información adicional, si la hay, sobre el estado del span raíz. Comportamiento de la propiedad: - solo lectura |
| events | array | Matriz de objetos event del span raíz, es decir, momentos relevantes durante la operación (por ejemplo, excepciones). Comportamiento de la propiedad: - solo lectura |
| links | array | Matriz de objetos link del span raíz, que apuntan a spans relacionados en la misma traza o en otra. Comportamiento de la propiedad: - solo lectura |
| span_count | integer | Número total de spans de la traza. Comportamiento de la propiedad: - solo lectura |
| error_count | integer | Número de spans de la traza cuyo status_code está establecido en Error.Comportamiento de la propiedad: - solo lectura |
Evento
El objeto de evento tiene las siguientes propiedades.
| Property | Type | Description |
|---|---|---|
| timestamp | integer | Hora Unix (en nanosegundos) en la que ocurrió el evento. Columna de origen de datos: Events.Timestamp |
| name | string | Nombre del evento. Columna de origen de datos: Events.Name |
| attributes | object | Atributos clave-valor con información adicional, si la hay, sobre el evento. Columna de origen de datos: Events.Attributes |
Enlace
El objeto de enlace tiene las siguientes propiedades.
| Property | Type | Description |
|---|---|---|
| traceid | string | ID del trace que contiene el span enlazado. Columna de origen de datos: Links.TraceId |
| spanid | string | ID del span enlazado. Junto con traceid, identifica de forma única el span enlazado.Columna de origen de datos: Links.SpanId |
| trace_state | string | Estado del trace, si existe, del span enlazado (consulte W3C Trace Context). Columna de origen de datos: Links.TraceState |
| attributes | object | Atributos clave-valor con información adicional sobre el enlace. Columna de origen de datos: Links.Attributes |