From c818cba1e896240152da6c7f81d42014617449ad Mon Sep 17 00:00:00 2001 From: Miguel Luna <39376769+mlunadia@users.noreply.github.com> Date: Fri, 11 Oct 2024 21:05:45 +0100 Subject: [PATCH 1/8] [es] adding docs/concepts/components --- content/es/docs/concepts/components.md | 146 +++++++++++++++++++++++++ 1 file changed, 146 insertions(+) create mode 100644 content/es/docs/concepts/components.md diff --git a/content/es/docs/concepts/components.md b/content/es/docs/concepts/components.md new file mode 100644 index 000000000000..30258bd515a2 --- /dev/null +++ b/content/es/docs/concepts/components.md @@ -0,0 +1,146 @@ +--- +title: Componentes +description: Los principales componentes que forman OpenTelemetry +aliases: [data-collection] +weight: 20 +default_lang_commit: 9b7da35fd7abd77d867177902b36d95e5f322182 +--- + +OpenTelemetry actualmente está compuesto por varios componentes principales: + +- [Especificación](#especificación) +- [Collector](#collector) +- [Implementaciones de API y SDK específicas del lenguaje](#implementaciones-de-api-y-sdk-específicas-del-lenguaje) + - [Librerías de Instrumentación](#librerías-de-instrumentación) + - [Exportadores](#exportadores) + - [Instrumentación sin código](#instrumentación-sin-código) + - [Detectores de Recursos](#detectores-de-recursos) + - [Propagadores entre servicios](#propagadores-entre-servicios) + - [Muestreadores](#muestreadores) +- [Operador de Kubernetes](#operador-de-kubernetes) +- [Elementos de Función como Servicio](#elementos-de-función-como-servicio) + +OpenTelemetry te permite reemplazar la necesidad de SDKs y herramientas +específicas de proveedores para generar y exportar datos de telemetría. + +## Especificación + +Describe los requisitos y expectativas multilingües para todas las +implementaciones. Más allá de la definición de términos, la especificación +define lo siguiente: + +- **API:** Define tipos de datos y operaciones para generar y correlacionar + datos de trazas, métricas y logs. +- **SDK:** Define requisitos para una implementación específica del lenguaje de + la API. La configuración, procesamiento de datos y conceptos de exportación + también se definen aquí. +- **Datos:** Define el Protocolo de OpenTelemetry (OTLP) y convenciones + semánticas neutrales que un backend de telemetría puede soportar. + +Para más información, consulta las [especificaciones](/docs/specs/). + +## Collector + +El Collector de OpenTelemetry es un proxy neutral que puede recibir, procesar y +exportar datos de telemetría. Soporta recibir datos de telemetría en múltiples +formatos (por ejemplo, OTLP, Jaeger, Prometheus, así como muchas herramientas +comerciales/proprietarias) y enviar datos a uno o más backends. También permite +procesar y filtrar datos de telemetría antes de exportarlos. + +Para más información, consulta el [Collector](/docs/collector/). + +## Implementaciones de API y SDK específicas del lenguaje + +OpenTelemetry también cuenta con SDKs específicos para cada lenguaje que te +permiten usar la API de OpenTelemetry para generar datos de telemetría en el +lenguaje de tu elección y exportarlos a un backend preferido. Estos SDKs también +permiten incorporar librerías de instrumentación para librerías y frameworks +comunes, que puedes utilizar para conectar la instrumentación manual en tu +aplicación. + +Para más información, consulta +[Instrumentación](/docs/concepts/instrumentation/). + +### Librerías de Instrumentación + +OpenTelemetry soporta una amplia gama de componentes que generan datos de +telemetría relevantes desde librerías y frameworks populares para los lenguajes +soportados. Por ejemplo, las solicitudes HTTP entrantes y salientes desde una +librería HTTP generan datos sobre esas solicitudes. + +Un objetivo aspiracional de OpenTelemetry es que todas las librerías populares +estén diseñadas para ser observables por defecto, para que no se requieran +dependencias separadas. + +Para más información, consulta +[Instrumentación de librerías](/docs/concepts/instrumentation/libraries/). + +### Exportadores + +{{% docs/languages/exporters/intro %}} + +### Instrumentación sin código + +Si aplica, una implementación específica de OpenTelemetry en un lenguaje +proporciona una forma de instrumentar tu aplicación sin tocar el código fuente. +Aunque el mecanismo subyacente depende del lenguaje, la instrumentación sin +código añade las capacidades de API y SDK de OpenTelemetry a tu aplicación. +Adicionalmente, puede añadir un conjunto de librerías de instrumentación y +dependencias de exportador. + +Para más información, consulta +[Instrumentación sin código](/docs/concepts/instrumentation/zero-code/). + +### Detectores de Recursos + +Un [recurso](/docs/concepts/resources/) representa la entidad que produce +telemetría como atributos de tipo recurso. Por ejemplo, un proceso que produce +telemetría y que se está ejecutando en un contenedor en Kubernetes tiene el +nombre del Pod, un nombre del namespace y posiblemente un nombre del Deployment. +Puedes incluir todos estos atributos como tipo recurso. + +Las implementaciones específicas de OpenTelemetry para cada lenguaje +proporcionan detección de recursos desde la variable de entorno +`OTEL_RESOURCE_ATTRIBUTES` y para muchas entidades comunes, como el runtime del +proceso, servicio, host o sistema operativo. + +Para más información, consulta [Recursos](/docs/concepts/resources/). + +### Propagadores entre servicios + +La propagación es el mecanismo que transfiere datos entre servicios y procesos. +Aunque no está limitado a las trazas, la propagación permite que las trazas +construyan información causal sobre un sistema a través de servicios +distribuidos arbitrariamente entre fronteras de procesos y redes. + +Para la gran mayoría de los casos, la propagación de contexto ocurre a través de +librerías de instrumentación. Si es necesario, puedes utilizar propagadores tú +mismo para serializar y deserializar intereses compartidos, como el contexto de +un span y el [equipaje](/docs/concepts/signals/baggage/). + +### Muestreadores + +El muestreo es un proceso que restringe la cantidad de trazas generadas por un +sistema. Cada implementación específica de OpenTelemetry para un lenguaje ofrece +varios [muestreadores de cabecera](/docs/concepts/sampling/#head-sampling). + +Para más información, consulta [Muestreo](/docs/concepts/sampling). + +## Operador de Kubernetes + +El Operador de OpenTelemetry es una implementación de un Operador de Kubernetes. +El operador gestiona el Collector de OpenTelemetry y la auto-instrumentación de +las applicaciones usando OpenTelemetry. + +Para más información, consulta el [Operador K8s](/docs/kubernetes/operator/). + +## Elementos de Función como Servicio + +OpenTelemetry soporta varios métodos de monitoreo para Function-as-a-Service +proporcionados por diferentes proveedores de cloud. La comunidad de +OpenTelemetry actualmente proporciona capas Lambda preconstruidas capaces de +auto-instrumentar tu aplicación, así como la opción de una capa Lambda de +Collector independiente que puede usarse al instrumentar aplicaciones manual o +automáticamente. + +Para más información, consulta [Funciones como Servicio](/docs/faas/). From 716ac95b2327954f3bae452a483ea06426b15cd6 Mon Sep 17 00:00:00 2001 From: Miguel Luna <39376769+mlunadia@users.noreply.github.com> Date: Fri, 11 Oct 2024 21:18:59 +0100 Subject: [PATCH 2/8] minor spelling checks --- content/es/docs/concepts/components.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/es/docs/concepts/components.md b/content/es/docs/concepts/components.md index 30258bd515a2..e514b482d523 100644 --- a/content/es/docs/concepts/components.md +++ b/content/es/docs/concepts/components.md @@ -130,7 +130,7 @@ Para más información, consulta [Muestreo](/docs/concepts/sampling). El Operador de OpenTelemetry es una implementación de un Operador de Kubernetes. El operador gestiona el Collector de OpenTelemetry y la auto-instrumentación de -las applicaciones usando OpenTelemetry. +las aplicaciones usando OpenTelemetry. Para más información, consulta el [Operador K8s](/docs/kubernetes/operator/). @@ -138,7 +138,7 @@ Para más información, consulta el [Operador K8s](/docs/kubernetes/operator/). OpenTelemetry soporta varios métodos de monitoreo para Function-as-a-Service proporcionados por diferentes proveedores de cloud. La comunidad de -OpenTelemetry actualmente proporciona capas Lambda preconstruidas capaces de +OpenTelemetry actualmente proporciona capas Lambda prefabricadas capaces de auto-instrumentar tu aplicación, así como la opción de una capa Lambda de Collector independiente que puede usarse al instrumentar aplicaciones manual o automáticamente. From e9b2b32a3f393491b5ad0c7101b50c6c769c24d7 Mon Sep 17 00:00:00 2001 From: Miguel Luna <39376769+mlunadia@users.noreply.github.com> Date: Wed, 30 Oct 2024 22:53:25 +0000 Subject: [PATCH 3/8] Update content/es/docs/concepts/components.md Co-authored-by: Fabrizio Ferri-Benedetti --- content/es/docs/concepts/components.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/es/docs/concepts/components.md b/content/es/docs/concepts/components.md index e514b482d523..7cb4598d50a5 100644 --- a/content/es/docs/concepts/components.md +++ b/content/es/docs/concepts/components.md @@ -1,6 +1,6 @@ --- title: Componentes -description: Los principales componentes que forman OpenTelemetry +description: Componentes que forman OpenTelemetry aliases: [data-collection] weight: 20 default_lang_commit: 9b7da35fd7abd77d867177902b36d95e5f322182 From 452bd53bfc35d6b76943477e15f1ead1065d8aac Mon Sep 17 00:00:00 2001 From: Miguel Luna <39376769+mlunadia@users.noreply.github.com> Date: Wed, 30 Oct 2024 22:53:32 +0000 Subject: [PATCH 4/8] Update content/es/docs/concepts/components.md Co-authored-by: Fabrizio Ferri-Benedetti --- content/es/docs/concepts/components.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/es/docs/concepts/components.md b/content/es/docs/concepts/components.md index 7cb4598d50a5..b71ed60509c5 100644 --- a/content/es/docs/concepts/components.md +++ b/content/es/docs/concepts/components.md @@ -6,7 +6,7 @@ weight: 20 default_lang_commit: 9b7da35fd7abd77d867177902b36d95e5f322182 --- -OpenTelemetry actualmente está compuesto por varios componentes principales: +OpenTelemetry está compuesto por varios componentes principales: - [Especificación](#especificación) - [Collector](#collector) From 1cf9bdeb8e00fa54b962c94b35eee86182226bb7 Mon Sep 17 00:00:00 2001 From: Miguel Luna <39376769+mlunadia@users.noreply.github.com> Date: Wed, 30 Oct 2024 22:53:43 +0000 Subject: [PATCH 5/8] Update content/es/docs/concepts/components.md Co-authored-by: Fabrizio Ferri-Benedetti --- content/es/docs/concepts/components.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/es/docs/concepts/components.md b/content/es/docs/concepts/components.md index b71ed60509c5..893154b9eb12 100644 --- a/content/es/docs/concepts/components.md +++ b/content/es/docs/concepts/components.md @@ -25,7 +25,7 @@ específicas de proveedores para generar y exportar datos de telemetría. ## Especificación -Describe los requisitos y expectativas multilingües para todas las +Describe los requisitos y expectativas multilenguaje para todas las implementaciones. Más allá de la definición de términos, la especificación define lo siguiente: From e2b0c976464ba8940d631fcd6e4b077a96366730 Mon Sep 17 00:00:00 2001 From: Miguel Luna <39376769+mlunadia@users.noreply.github.com> Date: Wed, 30 Oct 2024 22:53:52 +0000 Subject: [PATCH 6/8] Update content/es/docs/concepts/components.md Co-authored-by: Fabrizio Ferri-Benedetti --- content/es/docs/concepts/components.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/es/docs/concepts/components.md b/content/es/docs/concepts/components.md index 893154b9eb12..5ea5f44bb50c 100644 --- a/content/es/docs/concepts/components.md +++ b/content/es/docs/concepts/components.md @@ -91,7 +91,7 @@ dependencias de exportador. Para más información, consulta [Instrumentación sin código](/docs/concepts/instrumentation/zero-code/). -### Detectores de Recursos +### Detectores de recursos Un [recurso](/docs/concepts/resources/) representa la entidad que produce telemetría como atributos de tipo recurso. Por ejemplo, un proceso que produce From cb3a08e377f284104785e15f300c58de36f34083 Mon Sep 17 00:00:00 2001 From: Miguel Luna <39376769+mlunadia@users.noreply.github.com> Date: Wed, 30 Oct 2024 22:53:58 +0000 Subject: [PATCH 7/8] Update content/es/docs/concepts/components.md Co-authored-by: Fabrizio Ferri-Benedetti --- content/es/docs/concepts/components.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/es/docs/concepts/components.md b/content/es/docs/concepts/components.md index 5ea5f44bb50c..fa59a2253211 100644 --- a/content/es/docs/concepts/components.md +++ b/content/es/docs/concepts/components.md @@ -137,8 +137,8 @@ Para más información, consulta el [Operador K8s](/docs/kubernetes/operator/). ## Elementos de Función como Servicio OpenTelemetry soporta varios métodos de monitoreo para Function-as-a-Service -proporcionados por diferentes proveedores de cloud. La comunidad de -OpenTelemetry actualmente proporciona capas Lambda prefabricadas capaces de +proporcionados por diferentes proveedores de servicios en la nube. La comunidad +de OpenTelemetry proporciona capas Lambda prefabricadas capaces de auto-instrumentar tu aplicación, así como la opción de una capa Lambda de Collector independiente que puede usarse al instrumentar aplicaciones manual o automáticamente. From 87f7c5b4d18c6c0979da0fb1cf4b370a5ca83b49 Mon Sep 17 00:00:00 2001 From: Fabrizio Ferri-Benedetti Date: Mon, 4 Nov 2024 08:07:32 +0100 Subject: [PATCH 8/8] Update content/es/docs/concepts/components.md --- content/es/docs/concepts/components.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/es/docs/concepts/components.md b/content/es/docs/concepts/components.md index fa59a2253211..be665264af10 100644 --- a/content/es/docs/concepts/components.md +++ b/content/es/docs/concepts/components.md @@ -61,7 +61,7 @@ aplicación. Para más información, consulta [Instrumentación](/docs/concepts/instrumentation/). -### Librerías de Instrumentación +### Librerías de instrumentación OpenTelemetry soporta una amplia gama de componentes que generan datos de telemetría relevantes desde librerías y frameworks populares para los lenguajes