|
| 1 | +--- |
| 2 | +title: Distribuciones |
| 3 | +description: >- |
| 4 | + Una distribución, que no debe confundirse con un fork, es una versión |
| 5 | + personalizada de un componente de OpenTelemetry. |
| 6 | +weight: 190 |
| 7 | +default_lang_commit: 4966f752eb35f97c095ed1c813972c2ab38f0b1a |
| 8 | +--- |
| 9 | + |
| 10 | +Los proyectos de OpenTelemetry consisten en múltiples |
| 11 | +[componentes](../components) que soportan múltiples [señales](../signals). La |
| 12 | +implementación de referencia de OpenTelemetry está disponible como: |
| 13 | + |
| 14 | +- [Bibliotecas de instrumentación específicas por lenguaje](../instrumentation) |
| 15 | +- Un archivo [binario de Collector](/docs/concepts/components/#collector) |
| 16 | + |
| 17 | +Cualquier implementación de referencia puede ser personalizada como una |
| 18 | +distribución. |
| 19 | + |
| 20 | +## ¿Qué es una distribución? |
| 21 | + |
| 22 | +Una distribución es una versión personalizada de un componente de OpenTelemetry. |
| 23 | +Una distribución es un envoltorio alrededor de un repositorio upstream de |
| 24 | +OpenTelemetry con algunas personalizaciones. Las distribuciones no deben |
| 25 | +confundirse con _forks_. |
| 26 | + |
| 27 | +Las personalizaciones en una distribución pueden incluir: |
| 28 | + |
| 29 | +- Scripts para facilitar el uso o personalizar el uso para un backend o |
| 30 | + proveedor específico. |
| 31 | +- Cambios en la configuración predeterminada requeridos para un backend, |
| 32 | + proveedor o usuario final. |
| 33 | +- Opciones de empaquetado adicionales que pueden ser específicas de un proveedor |
| 34 | + o usuario final. |
| 35 | +- Cobertura adicional de pruebas, rendimiento y seguridad más allá de lo que |
| 36 | + ofrece OpenTelemetry. |
| 37 | +- Capacidades adicionales más allá de lo que ofrece OpenTelemetry. |
| 38 | +- Menos capacidades de las que ofrece OpenTelemetry. |
| 39 | + |
| 40 | +Las distribuciones en general caen en las siguientes categorías: |
| 41 | + |
| 42 | +- **"Pura":** Estas distribuciones proporcionan la misma funcionalidad que el |
| 43 | + _upstream_ y son 100% compatibles. Las personalizaciones generalmente mejoran |
| 44 | + la facilidad de uso o el empaquetado. Estas personalizaciones pueden ser |
| 45 | + específicas de un backend, proveedor o usuario final. |
| 46 | +- **"Plus":** Estas distribuciones proporcionan funcionalidades adicionales |
| 47 | + sobre el upstream a través de componentes adicionales. Ejemplos incluyen |
| 48 | + bibliotecas de instrumentación o exportadores de proveedores que no han sido |
| 49 | + integrados al proyecto de OpenTelemetry. |
| 50 | +- **"Minus":** Estas distribuciones proporcionan un subconjunto de funcionalidad |
| 51 | + del upstream. Ejemplos de esto incluyen la eliminación de bibliotecas de |
| 52 | + instrumentación o receptores, procesadores, exportadores o extensiones que se |
| 53 | + encuentran en el proyecto de OpenTelemetry Collector. Estas distribuciones |
| 54 | + pueden ser proporcionadas para aumentar las consideraciones de soporte y |
| 55 | + seguridad. |
| 56 | + |
| 57 | +## ¿Quién puede crear una distribución? |
| 58 | + |
| 59 | +Cualquiera puede crear una distribución. Hoy en día, varios |
| 60 | +[proveedores](/ecosystem/vendors/) ofrecen |
| 61 | +[distribuciones](/ecosystem/distributions/). Además, los usuarios finales pueden |
| 62 | +considerar crear una distribución si desean utilizar componentes en el |
| 63 | +[Registro](/ecosystem/registry/) que no han sido integrados al proyecto de |
| 64 | +OpenTelemetry. |
| 65 | + |
| 66 | +## ¿Contribución o distribución? |
| 67 | + |
| 68 | +Antes de seguir leyendo y aprender cómo crear tu propia distribución, pregúntate |
| 69 | +si tus aportes sobre un componente de OpenTelemetry serían beneficiosas para |
| 70 | +todos y, por lo tanto, deberían incluirse en las implementaciones de referencia: |
| 71 | + |
| 72 | +- ¿Pueden generalizarse tus scripts para "facilitar el uso"? |
| 73 | +- ¿Pueden tus cambios en la configuración predeterminada ser la mejor opción |
| 74 | + para todos? |
| 75 | +- ¿Son realmente específicas tus opciones de empaquetado adicionales? |
| 76 | +- ¿Podrían tus coberturas adicionales de pruebas, rendimiento y seguridad |
| 77 | + funcionar también con la implementación de referencia? |
| 78 | +- ¿Has consultado con la comunidad si tus capacidades adicionales podrían formar |
| 79 | + parte del estándar? |
| 80 | + |
| 81 | +## Creando tu propia distribución |
| 82 | + |
| 83 | +### Collector |
| 84 | + |
| 85 | +Una guía sobre cómo crear tu propia distribución está disponible en este |
| 86 | +artículo: |
| 87 | +["Building your own OpenTelemetry Collector distribution"](https://medium.com/p/42337e994b63) |
| 88 | + |
| 89 | +Si estás creando tu propia distribución, el |
| 90 | +[OpenTelemetry Collector Builder](https://github.com/open-telemetry/opentelemetry-collector/tree/main/cmd/builder) |
| 91 | +podría ser un buen punto de partida. |
| 92 | + |
| 93 | +### Bibliotecas de instrumentación específicas por lenguaje |
| 94 | + |
| 95 | +Existen mecanismos de extensibilidad específicos por lenguaje para personalizar |
| 96 | +las bibliotecas de instrumentación: |
| 97 | + |
| 98 | +- [Agente de Java](/docs/zero-code/java/agent/extensions) |
| 99 | + |
| 100 | +## Sigue las pautas |
| 101 | + |
| 102 | +Al usar material del proyecto OpenTelemetry, como el logotipo y el nombre para |
| 103 | +tu distribución, asegúrate de estar alineado con las [Pautas de Marketing de |
| 104 | +OpenTelemetry para Organizaciones Contribuyentes][guidelines]. |
| 105 | + |
| 106 | +El proyecto OpenTelemetry no certifica distribuciones en este momento. En el |
| 107 | +futuro, OpenTelemetry podría certificar distribuciones y socios de manera |
| 108 | +similar al proyecto Kubernetes. Al evaluar una distribución, asegúrate de que |
| 109 | +usar la distribución no resulte en un bloqueo con el proveedor. |
| 110 | + |
| 111 | +> Cualquier soporte para una distribución proviene de los autores de la |
| 112 | +> distribución y no de los autores de OpenTelemetry. |
| 113 | +
|
| 114 | +[guidelines]: |
| 115 | + https://github.com/open-telemetry/community/blob/main/marketing-guidelines.md |
0 commit comments