Glosario

Definiciones y convenciones para términos de telemetría tal como se usan en OpenTelemetry.

Este glosario define términos y conceptos que son nuevos para el proyecto OpenTelemetry y aclara los usos específicos de OpenTelemetry para términos comunes en el campo de la observabilidad.

También comentamos sobre la ortografía y la capitalización cuando es útil. Por ejemplo, ver OpenTelemetry y OTel.

Términos

Agregación

El proceso de combinar múltiples mediciones en estadísticas exactas o estimadas sobre las mediciones que tuvieron lugar durante un intervalo de tiempo, durante la ejecución de un programa. Usado por la Métrica Fuente de datos.

API

Interfaz de Programación de Aplicaciones (Application Programming Interface). En el proyecto OpenTelemetry, se utiliza para definir cómo se generan los datos de telemetría por cada Fuente de datos.

Aplicación

Uno o más Servicios diseñados para usuarios finales u otras aplicaciones.

Aplicación cliente

Un componente de una Aplicación que no se ejecuta dentro de una infraestructura privada y que es típicamente utilizada directamente por los usuarios finales. Ejemplos de aplicaciones cliente son aplicaciones de navegador, aplicaciones móviles y aplicaciones que se ejecutan en dispositivos IoT.

APM

Monitoreo de Rendimiento de Aplicaciones (Application Performance Monitoring) se trata de monitorear aplicaciones de software, su rendimiento (velocidad, confiabilidad, disponibilidad, etc.) para detectar problemas, generar alertas y proporcionar herramientas para encontrar la causa raíz.

Atributo

Término de OpenTelemetry para Metadatos. Añade información clave-valor a la entidad que produce telemetría. Se utiliza en Señales y Recursos. Ver especificación de atributos.

Backend de observabilidad

El componente de una plataforma de observabilidad que es responsable de recibir, procesar, almacenar y consultar datos de telemetría. Ejemplos incluyen herramientas de código abierto herramientas de código abierto como Jaeger y Prometheus, así como ofertas comerciales. OpenTelemetry no es un backend de observabilidad.

Baggage

Un mecanismo para propagar Metadatos para ayudar a establecer una relación causal entre eventos y servicios. Ver especificación de baggage.

Biblioteca

Una colección de comportamiento específica de un lenguaje invocada por una interfaz.

Biblioteca cliente

Ver Biblioteca instrumentada.

Biblioteca de instrumentación

Se refiere a la Biblioteca que proporciona la instrumentación para una Biblioteca instrumentada. Biblioteca instrumentada y Biblioteca de instrumentación pueden ser la misma Biblioteca si tiene instrumentación OpenTelemetry incorporada. Ver la especificación de la biblioteca.

Biblioteca instrumentada

Se refiere a la Biblioteca para la cual se recopilan las señales de telemetría (Trazas, Métricas, Logs). Ver Biblioteca instrumentada.

Campo

Un término utilizado específicamente por Registros de Log. Metadatos pueden ser añadidos a través de campos definidos, incluyendo Atributos y Recursos. Otros campos también pueden ser considerados Metadatos, incluyendo información de severidad y traza. Ver la especificación de campos.

Cardinalidad

El número de valores únicos para un Atributo o conjunto de atributos. Alta cardinalidad significa muchos valores únicos, lo que puede afectar el rendimiento y los requisitos de almacenamiento de los backends de telemetría. Por ejemplo, un atributo user_id tendría alta cardinalidad, mientras que un atributo status_code con valores como “200”, “404”, “500” tendría baja cardinalidad.

Collector

El OpenTelemetry Collector, o Collector para abreviar, es una implementación independiente de proveedores de cómo recibir, procesar y exportar datos de telemetría. Un binario que puede ser desplegado como un agente o gateway.

Ortografía: Cuando se refiere al OpenTelemetry Collector, siempre capitalizar Collector. Use just “Collector” si se está usando Collector como un adjetivo — por ejemplo, “Collector configuration”.

Contrib

Varias Bibliotecas de instrumentación y el Collector ofrecen un conjunto de capacidades básicas, así como un repositorio dedicado para capacidades no incluidas en el núcleo, incluyendo Exporters de proveedores.

Convenciones semánticas

Define nombres y valores estándar de Metadatos para proporcionar datos de telemetría independientes del proveedor.

DAG

Directed Acyclic Graph.

Dimensión

Un término utilizado específicamente por Métricas. Ver Atributo.

Distribución

Una distribución es un contenedor alrededor de un repositorio OpenTelemetry superior con algunas personalizaciones. Ver Distribuciones.

Un enlace de span es un enlace entre spans causalmente relacionados. Para más detalles, ver Enlaces entre spans y Especificar Enlaces.

Especificación

Describe los requisitos y expectativas cruzados de todos los implementaciones. Ver Especificación.

Estado

El resultado de la operación. Normalmente se utiliza para indicar si ocurrió un error. Ver Estado.

Evento

Un Evento es un Registro de Log con un nombre de evento y una estructura bien conocida. Por ejemplo, los eventos de navegador en OpenTelemetry siguen una convención de nomenclatura particular y llevan datos particulares en una estructura común.

Exporter

Proporciona funcionalidad para emitir telemetría a consumidores. Los Exporters pueden ser push- o pull-based.

Frontend de observabilidad

El componente de una plataforma de observabilidad que proporciona interfaces de usuario para visualizar y analizar datos de telemetría. A menudo es parte de un backend de observabilidad, particularmente cuando se consideran ofertas comerciales.

Fuente de datos

Ver Señal

gRPC

Un framework universal de RPC de código abierto de alto rendimiento. Ver gRPC.

HTTP

Abreviatura para Hypertext Transfer Protocol.

Instrumentación automática

Se refiere a métodos de recopilación de telemetría que no requieren que el usuario final modifique el código fuente de la aplicación. Los métodos varían según el lenguaje de programación, e incluyen ejemplos como inyección de bytecode o monkey patching.

JSON

Abreviatura para JavaScript Object Notation.

Label

Un término utilizado específicamente por Métricas. Ver Metadatos.

Lenguaje

Lenguaje de programación.

Log

A veces se utiliza para referirse a una colección de Registros de Log. Puede ser ambiguo ya que a veces se utiliza Log para referirse a un solo Registro de Log. Donde la ambigüedad es posible, se utilizan cuantificadores adicionales, por ejemplo, Registro de Log. Ver Log.

Metadatos

Un par clave-valor, por ejemplo foo="bar", añadido a una entidad que produce telemetría. OpenTelemetry llama a estos pares Atributos. Además, Métricas tienen Dimensiones y Etiquetas, mientras que Logs tienen Campos.

Métrica

Registra un punto de datos, ya sea mediciones sin procesar o agregación predefinida, como una serie de tiempo con Metadatos. Ver Métrica.

Muestreo

Un mecanismo para controlar la cantidad de datos exportados. Más comúnmente utilizado con la Traza Fuente de datos. Ver Muestreo.

OC

Abreviatura para OpenCensus.

OpAMP

Abreviatura para el Open Agent Management Protocol.

Ortografía: Escribe OpAMP, no OPAMP ni opamp en descripciones o instrucciones.

OpenCensus

Precursor a OpenTelemetry. Para más detalles, ver Historia.

OpenTelemetry

Formado a través de un merger de los proyectos OpenTracing y OpenCensus, OpenTelemetry — el tema de este sitio web — es una colección de APIs, SDKs, y herramientas que puedes usar para instrumentar, generar, recopilar, y exportar datos de telemetría como métricas, logs, y trazas.

Ortografía: OpenTelemetry siempre debe ser una sola palabra sin guión y capitalizada como se muestra.

OpenTracing

Precursor a OpenTelemetry. Para más detalles, ver Historia.

OT

Abreviatura para OpenTracing.

OTel

Abreviatura para OpenTelemetry.

Ortografía: Escribe OTel, no OTEL ni otel en descripciones o instrucciones.

OTelCol

Abreviatura para OpenTelemetry Collector.

OTEP

Abreviatura para OpenTelemetry Enhancement Proposal.

Ortografía: Escribe “OTEPs” como forma plural. No escribas OTep ni otep en descriptions.

OTLP

Abreviatura para OpenTelemetry Protocol.

Propagación de contexto

Permite que todas las Fuentes de datos compartan un mecanismo de contexto subyacente para almacenar estado y acceder a datos durante la vida útil de una Transacción. Ver especificación de propagación de contexto.

Propagadores

Usado para serializar y deserializar partes específicas de datos de telemetría como contexto de span y Baggage en Spans. Ver Propagadores.

Proto

Tipos de interfaz independientes del lenguaje. Ver opentelemetry-proto.

Receptor

El término utilizado por el Collector para definir cómo se reciben los datos de telemetría. Los receptores pueden ser push- o pull-based. Ver Receptor.

Recurso

Captura información sobre la entidad que produce telemetría como Atributos. Por ejemplo, un proceso que produce telemetría que se está ejecutando en un contenedor en Kubernetes tiene un nombre de proceso, un nombre de pod, un espacio de nombres y posiblemente un nombre de despliegue. Todos estos atributos pueden ser incluidos en el Recurso.

Registro de Log

Un registro de datos con una marca de tiempo y una severidad. También puede tener un ID de Traza y un ID de Span cuando está correlacionado con una traza. Ver Registro de Log.

REST

Abreviatura para Representational State Transfer.

RPC

Abreviatura para Remote Procedure Call.

SDK

Abreviatura para Software Development Kit. Se refiere a un SDK de telemetría que denota una Biblioteca que implementa la API de OpenTelemetry.

Servicio

Un componente de una Aplicación. Múltiples instancias de un Servicio son típicamente desplegadas para alta disponibilidad y escalabilidad. Un Servicio puede ser desplegado en múltiples ubicaciones.

Señal

Uno de Trazas, Métricas o Logs. Ver Señales.

Solicitud

Ver Trazas distribuídas.

Span

Representa una sola operación dentro de una Traza. Ver Span.

Tag

Ver Metadatos.

Tracer

Responsable de crear Spans. Ver Tracer.

Transacción

Ver Trazas distribuídas.

Traza

Un DAG de Spans, donde los bordes entre Spans están definidos como relación padre-hijo. Ver Trazas.

Trazas distribuídas

Rastrea el progreso de una sola Solicitud, llamada Traza, a medida que es manejada por Servicios que forman parte de una Aplicación. Una Traza distribuída atraviesa límites de proceso, red y seguridad.

Ver Trazas distribuídas.

zPages

Una alternativa en proceso a los exportadores externos. Cuando se incluyen, recopilan y agregan información de trazas y métricas en segundo plano; estos datos se sirven en páginas web cuando se solicitan. Ver zPages.