Conceptos de mapeos de OpenTelemetry

Mapeos de componentes

Un OtelComponentMapping describe cómo se crea (o actualiza) un componente de topología a partir de datos de OpenTelemetry.

Ejemplos típicos de componentes creados a partir de OpenTelemetry incluyen (estos son parte del StackPack predeterminado de OpenTelemetry):

  • Servicios (derivados de service.name / service.namespace)

  • Instancias de servicio (derivadas de service.instance.id)

  • Bases de datos

  • Hosts y recursos de Kubernetes (nodos, espacios de nombres, pods)

  • Funciones y tareas en entornos sin servidor o por lotes

Mapeos de relaciones

Un OtelRelationMapping describe cómo se crea una relación entre dos componentes a partir de datos de OpenTelemetry.

Ejemplos comunes de relaciones incluyen (estos son parte del StackPack predeterminado de OpenTelemetry):

  • Llamadas de servicio síncronas (líder → seguidor)

  • Flujos de mensajería asíncronos (productor → consumidor, consumidor → par, productor → par)

  • Conexiones de servicio a base de datos

  • Instancia de servicio proporcionada por servicio

  • Relaciones de ejecución (servicio o función ejecuta tarea, host o función)

Expresiones y el Lenguaje de Expresión Común (CEL)

Los mapeos de topología dependen del Lenguaje de Expresión Común (CEL) para seleccionar telemetría, extraer valores y construir campos de componente y relación.

No necesitas experiencia previa en CEL para comenzar: la mayoría de las expresiones son simples comprobaciones booleanas, búsquedas de atributos o construcciones de cadenas. Se pueden introducir expresiones más avanzadas de forma incremental según sea necesario.

Para más información sobre cómo aprovechar CEL en los mapeos de topología, consulta la página schemas.