Merge branch 'main' into ptbr_translate_languages_go_instrumentation

.cspell/es-palabras.txt

@@ -1,2 +1,9 @@
 observabilidad
-telemetría
+telemetría
+inicialización
+configurarlo
+correlacionan
+microservicios
+extensibilidad
+correlacionarse
+deserializa

.cspell/pt-palavras.txt

@@ -1,5 +1,6 @@
 desserializa
+desserializar
 autoinstrumentação
 autoconsistentes
 serialização
-verbosidade
+verbosidade

.gitmodules

@@ -7,7 +7,7 @@
 [submodule "content-modules/opentelemetry-specification"]
 	path = content-modules/opentelemetry-specification
 	url = https://github.com/open-telemetry/opentelemetry-specification.git
-	spec-pin = v1.37.0
+	spec-pin = v1.38.0
 [submodule "content-modules/community"]
 	path = content-modules/community
 	url = https://github.com/open-telemetry/community
@@ -19,7 +19,7 @@
 [submodule "content-modules/semantic-conventions"]
 	path = content-modules/semantic-conventions
 	url = https://github.com/open-telemetry/semantic-conventions
-	semconv-pin = v1.27.0
+	semconv-pin = v1.28.0
 [submodule "content-modules/opamp-spec"]
 	path = content-modules/opamp-spec
 	url = https://github.com/open-telemetry/opamp-spec

.htmltest.yml

@@ -36,6 +36,7 @@ IgnoreURLs: # list of regexs of paths or URLs to be ignored
   - ^https://(www\.|eng\.)?uber\.com/(blog|flipr)/ # 406
   - ^https://kofo.dev
   - ^https://platform.openai.com
+  - ^https://openai.com
   - ^https://star-history.com
   - ^https://twitter.com
   - ^https://www.chathamhouse.org

content/en/blog/2024/prom-and-otel/index.md

@@ -130,7 +130,7 @@ endpoint. Note that
 The Prometheus exporter allows you to ship data in the Prometheus format, which
 is then scraped by a Prometheus server. It's used to report metrics via the
 Prometheus scrape HTTP endpoint. You can learn more by trying out this
-[example](https://github.com/open-telemetry/opentelemetry-go/tree/main/example/prometheus).
+[example](https://github.com/open-telemetry/opentelemetry-go-contrib/tree/main/examples/prometheus).
 However, the scraping won't really scale, as all the metrics are sent in a
 single scrape.
 

content/en/docs/collector/_index.md

@@ -3,7 +3,7 @@ title: Collector
 description: Vendor-agnostic way to receive, process and export telemetry data.
 aliases: [collector/about]
 cascade:
-  vers: 0.110.0
+  vers: 0.111.0
 weight: 270
 ---
 

content/en/docs/collector/custom-collector.md

@@ -164,6 +164,13 @@ processors:
 receivers:
   - gomod:
       go.opentelemetry.io/collector/receiver/otlpreceiver {{% version-from-registry collector-receiver-otlp %}}
+
+providers:
+  - gomod: go.opentelemetry.io/collector/confmap/provider/envprovider v1.16.0
+  - gomod: go.opentelemetry.io/collector/confmap/provider/fileprovider v1.16.0
+  - gomod: go.opentelemetry.io/collector/confmap/provider/httpprovider v0.110.0
+  - gomod: go.opentelemetry.io/collector/confmap/provider/httpsprovider v0.110.0
+  - gomod: go.opentelemetry.io/collector/confmap/provider/yamlprovider v0.110.0
 ```
 
 {{% alert color="primary" title="Tip" %}}

content/en/docs/concepts/signals/traces.md

@@ -26,8 +26,8 @@ verbose.
 {
   "name": "hello",
   "context": {
-    "trace_id": "0x5b8aa5a2d2c872e8321cf37308d69df2",
-    "span_id": "0x051581bf3cb55c13"
+    "trace_id": "5b8aa5a2d2c872e8321cf37308d69df2",
+    "span_id": "051581bf3cb55c13"
   },
   "parent_id": null,
   "start_time": "2022-04-29T18:52:58.114201Z",
@@ -57,10 +57,10 @@ Note that it has a `trace_id` field indicating the trace, but has no
 {
   "name": "hello-greetings",
   "context": {
-    "trace_id": "0x5b8aa5a2d2c872e8321cf37308d69df2",
-    "span_id": "0x5fb397be34d26b51"
+    "trace_id": "5b8aa5a2d2c872e8321cf37308d69df2",
+    "span_id": "5fb397be34d26b51"
   },
-  "parent_id": "0x051581bf3cb55c13",
+  "parent_id": "051581bf3cb55c13",
   "start_time": "2022-04-29T18:52:58.114304Z",
   "end_time": "2022-04-29T22:52:58.114561Z",
   "attributes": {
@@ -96,10 +96,10 @@ that matches the `span_id` of the `hello` span.
 {
   "name": "hello-salutations",
   "context": {
-    "trace_id": "0x5b8aa5a2d2c872e8321cf37308d69df2",
-    "span_id": "0x93564f51e1abe1c2"
+    "trace_id": "5b8aa5a2d2c872e8321cf37308d69df2",
+    "span_id": "93564f51e1abe1c2"
   },
-  "parent_id": "0x051581bf3cb55c13",
+  "parent_id": "051581bf3cb55c13",
   "start_time": "2022-04-29T18:52:58.114492Z",
   "end_time": "2022-04-29T18:52:58.114631Z",
   "attributes": {

content/en/docs/contributing/issues.md

@@ -29,7 +29,8 @@ One of the best ways to help make OTel docs better is to fix an existing issue.
    <!-- prettier-ignore -->
    > **NOTE**: we **_do not_ assign issues** to those who
    > have not already made contributions to the [OpenTelemetry
-   > organization][org].
+   > organization][org], unless part of a mentorship or onboarding
+   > process.
    {.mt-3}
 
    <!-- prettier-ignore -->

content/en/docs/languages/go/examples.md

@@ -1,6 +1,6 @@
 ---
 title: Examples
-redirect: https://github.com/open-telemetry/opentelemetry-go/tree/main/example
+redirect: https://github.com/open-telemetry/opentelemetry-go-contrib/tree/main/examples
 manualLinkTarget: _blank
 _build: { render: link }
 weight: 220

content/en/docs/languages/go/exporters.md

@@ -200,7 +200,7 @@ func newExporter(ctx context.Context) (metric.Reader, error) {
 ```
 
 To learn more on how to use the Prometheus exporter, try the
-[prometheus example](https://github.com/open-telemetry/opentelemetry-go/tree/main/example/prometheus)
+[prometheus example](https://github.com/open-telemetry/opentelemetry-go-contrib/tree/main/examples/prometheus)
 
 ### OTLP logs over HTTP (Experimental)
 

content/es/docs/concepts/context-propagation.md

@@ -0,0 +1,49 @@
+---
+title: Propagación de contexto
+weight: 10
+description: Aprende sobre el concepto que habilita el trazado distribuido.
+default_lang_commit: 4966f752eb35f97c095ed1c813972c2ab38f0b1a
+---
+
+Con la propagación de contexto, [Señales](/docs/concepts/signals) pueden
+correlacionarse entre sí, independientemente de dónde se generen. Aunque no está
+limitado a las trazas, la propagación de contexto permite que las
+[trazas](/docs/concepts/signals/traces) construyan información causal sobre un
+sistema a través de servicios que están distribuidos arbitrariamente a través de
+límites de procesos y redes.
+
+Para entender la propagación de contexto, necesitas comprender dos conceptos
+separados: contexto y propagación.
+
+## Contexto
+
+El contexto es un objeto que contiene la información para que el servicio emisor
+y receptor, o la
+[unidad de ejecución](/docs/specs/otel/glossary/#execution-unit), puedan
+correlacionar una señal con otra.
+
+Por ejemplo, si el servicio A llama al servicio B, entonces un span del servicio
+A cuyo ID está en el contexto será usado como el span padre para el próximo span
+creado en el servicio B. El ID de traza que está en el contexto también se usará
+para el siguiente span creado en el servicio B, lo que significa que el span es
+parte de la misma traza que el span del servicio A.
+
+## Propagación
+
+La propagación es el mecanismo que mueve el contexto entre servicios y procesos.
+Serializa o deserializa el objeto de contexto y proporciona la información
+relevante para ser propagada de un servicio a otro.
+
+La propagación generalmente es manejada por bibliotecas de instrumentación y es
+transparente para el usuario. En caso de que necesites propagar manualmente el
+contexto, puedes utilizar la
+[API de Propagadores](/docs/specs/otel/context/api-propagators/).
+
+OpenTelemetry mantiene varios propagadores oficiales. El propagador
+predeterminado utiliza los encabezados especificados por la especificación de
+[W3C TraceContext](https://www.w3.org/TR/trace-context/).
+
+## Especificación
+
+Para aprender más sobre la Propagación de Contexto, consulta la
+[especificación de Contexto](/docs/specs/otel/context/).

content/es/docs/concepts/distributions.md

@@ -0,0 +1,115 @@
+---
+title: Distribuciones
+description: >-
+  Una distribución, que no debe confundirse con un fork, es una versión
+  personalizada de un componente de OpenTelemetry.
+weight: 190
+default_lang_commit: 4966f752eb35f97c095ed1c813972c2ab38f0b1a
+---
+
+Los proyectos de OpenTelemetry consisten en múltiples
+[componentes](../components) que soportan múltiples [señales](../signals). La
+implementación de referencia de OpenTelemetry está disponible como:
+
+- [Bibliotecas de instrumentación específicas por lenguaje](../instrumentation)
+- Un archivo [binario de Collector](/docs/concepts/components/#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](/ecosystem/vendors/) ofrecen
+[distribuciones](/ecosystem/distributions/). Además, los usuarios finales pueden
+considerar crear una distribución si desean utilizar componentes en el
+[Registro](/ecosystem/registry/) 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"](https://medium.com/p/42337e994b63)
+
+Si estás creando tu propia distribución, el
+[OpenTelemetry Collector Builder](https://github.com/open-telemetry/opentelemetry-collector/tree/main/cmd/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](/docs/zero-code/java/agent/extensions)
+
+## 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][guidelines].
+
+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.
+
+[guidelines]:
+  https://github.com/open-telemetry/community/blob/main/marketing-guidelines.md