Skip to content

Commit 57d9d3b

Browse files
authored
adding [es] docs/concepts/distributions (#5321)
1 parent dc9c579 commit 57d9d3b

File tree

1 file changed

+115
-0
lines changed

1 file changed

+115
-0
lines changed
+115
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,115 @@
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

Comments
 (0)