Objeto span de APM

Los siguientes objetos están directamente relacionados con la API apmspan.

Cada propiedad corresponde a una columna de la tabla otel_traces del origen de datos de telemetría. Para consultar la lista de columnas, consulte Columnas de datos de telemetría compatibles.

Span de APM

El objeto de span de APM representa un span (una única operación dentro de un trace, como una solicitud HTTP, una consulta a una base de datos o una llamada a una función).

Los spans forman una jerarquía que comienza con el span raíz, que representa la primera operación de la solicitud. Cada uno de los demás spans es un span secundario del span durante el cual se inició su operación.

El objeto de span de APM tiene las siguientes propiedades:

Property Type Description
timestamp integer Hora Unix (en nanosegundos) en la que se inició el span.

Comportamiento de la propiedad:
- solo lectura
traceid string ID del trace al que pertenece el span.

Comportamiento de la propiedad:
- solo lectura
spanid string ID del span.

Comportamiento de la propiedad:
- solo lectura
parent_spanid string ID del span principal.
Vacío para el span raíz.

Comportamiento de la propiedad:
- solo lectura
trace_state string Datos adicionales, si los hay, que las herramientas de tracing adjuntan al trace (consulte W3C Trace Context).

Comportamiento de la propiedad:
- solo lectura
span_name string Nombre de la operación que representa el span (por ejemplo, mysqli_query).

Comportamiento de la propiedad:
- solo lectura
span_kind string Rol del span.

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 (por ejemplo, zabbix-frontend), 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 (por ejemplo, host.name: eabf8c2a5ddc).

Comportamiento de la propiedad:
- solo lectura
scope_name string Nombre del ámbito de instrumentación que produjo el span.

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 (por ejemplo, db.system: mysql).

Comportamiento de la propiedad:
- solo lectura
duration integer Duración del span en nanosegundos.

Comportamiento de la propiedad:
- solo lectura
status_code string Estado de la operación que representa el span.

Valores posibles:
Unset: no se ha asignado ningún estado explícito al span;
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.

Comportamiento de la propiedad:
- solo lectura
events array Matriz de objetos event del span, es decir, puntos relevantes en el tiempo durante la operación (por ejemplo, excepciones).

Comportamiento de la propiedad:
- solo lectura
links array Matriz de objetos link del span, que apuntan a spans relacionados en el mismo trace o en otro.

Comportamiento de la propiedad:
- solo lectura