Distribuciones

Los proyectos de OpenTelemetry consisten en múltiples componentes que soportan múltiples señales. La implementación de referencia de OpenTelemetry está disponible como:

• Bibliotecas de instrumentación específicas por lenguaje
• Un archivo binario de Collector

Cualquier implementación de referencia puede ser personalizada como una distribución.

¿Qué es una distribución?

Una distribución es una versión personalizada de un componente de OpenTelemetry. Una distribución es un envoltorio alrededor de un repositorio upstream de OpenTelemetry con algunas personalizaciones. Las distribuciones no deben confundirse con forks.

Las personalizaciones en una distribución pueden incluir:

• Scripts para facilitar el uso o personalizar el uso para un backend o proveedor específico.
• Cambios en la configuración predeterminada requeridos para un backend, proveedor o usuario final.
• Opciones de empaquetado adicionales que pueden ser específicas de un proveedor o usuario final.
• Cobertura adicional de pruebas, rendimiento y seguridad más allá de lo que ofrece OpenTelemetry.
• Capacidades adicionales más allá de lo que ofrece OpenTelemetry.
• Menos capacidades de las que ofrece OpenTelemetry.

Las distribuciones en general caen en las siguientes categorías:

• “Pura”: Estas distribuciones proporcionan la misma funcionalidad que el upstream y son 100% compatibles. Las personalizaciones generalmente mejoran la facilidad de uso o el empaquetado. Estas personalizaciones pueden ser específicas de un backend, proveedor o usuario final.
• “Plus”: Estas distribuciones proporcionan funcionalidades adicionales sobre el upstream a través de componentes adicionales. Ejemplos incluyen bibliotecas de instrumentación o exportadores de proveedores que no han sido integrados al proyecto de OpenTelemetry.
• “Minus”: Estas distribuciones proporcionan un subconjunto de funcionalidad del upstream. Ejemplos de esto incluyen la eliminación de bibliotecas de instrumentación o receptores, procesadores, exportadores o extensiones que se encuentran en el proyecto de OpenTelemetry Collector. Estas distribuciones pueden ser proporcionadas para aumentar las consideraciones de soporte y seguridad.

¿Quién puede crear una distribución?

Cualquiera puede crear una distribución. Hoy en día, varios proveedores ofrecen distribuciones. Además, los usuarios finales pueden considerar crear una distribución si desean utilizar componentes en el Registro que no han sido integrados al proyecto de OpenTelemetry.

¿Contribución o distribución?

Antes de seguir leyendo y aprender cómo crear tu propia distribución, pregúntate si tus aportes sobre un componente de OpenTelemetry serían beneficiosas para todos y, por lo tanto, deberían incluirse en las implementaciones de referencia:

• ¿Pueden generalizarse tus scripts para “facilitar el uso”?
• ¿Pueden tus cambios en la configuración predeterminada ser la mejor opción para todos?
• ¿Son realmente específicas tus opciones de empaquetado adicionales?
• ¿Podrían tus coberturas adicionales de pruebas, rendimiento y seguridad funcionar también con la implementación de referencia?
• ¿Has consultado con la comunidad si tus capacidades adicionales podrían formar parte del estándar?

Creando tu propia distribución

Collector

Una guía sobre cómo crear tu propia distribución está disponible en este artículo: “Building your own OpenTelemetry Collector distribution”

Si estás creando tu propia distribución, el OpenTelemetry Collector Builder podría ser un buen punto de partida.

Bibliotecas de instrumentación específicas por lenguaje

Existen mecanismos de extensibilidad específicos por lenguaje para personalizar las bibliotecas de instrumentación:

• Agente de Java

Sigue las pautas

Al usar material del proyecto OpenTelemetry, como el logotipo y el nombre para tu distribución, asegúrate de estar alineado con las Pautas de Marketing de OpenTelemetry para Organizaciones Contribuyentes.

El proyecto OpenTelemetry no certifica distribuciones en este momento. En el futuro, OpenTelemetry podría certificar distribuciones y socios de manera similar al proyecto Kubernetes. Al evaluar una distribución, asegúrate de que usar la distribución no resulte en un bloqueo con el proveedor.

Cualquier soporte para una distribución proviene de los autores de la distribución y no de los autores de OpenTelemetry.