+Tutorial de inicio rápido basado en tu rol
+
+
+{{< /blocks/cover >}}
+
+{{% blocks/lead color="white" %}}
+
+OpenTelemetry es un conjunto de API, SDK y herramientas. Úsalo para
+instrumentar, generar, recopilar y exportar datos de telemetría (métricas, logs
+y trazas) para que te ayuden a analizar el rendimiento y comportamiento de tu
+aplicación.
+
+> OpenTelemetry está actualmente disponible para
+> [varios lenguajes de programación](docs/languages) y puede usarse en entornos
+> de producción.
+
+{{% /blocks/lead %}}
+
+{{% blocks/section color="dark" type="row" %}}
+
+{{% blocks/feature icon="fas fa-chart-line" title="Trazas, métricas y logs"%}}
+
+Genera y recopila datos de telemetría desde tus servicios y aplicaciones y
+reenvía los datos a una amplia variedad de herramientas de análisis.
+{{% /blocks/feature %}}
+
+{{% blocks/feature icon="fas fa-magic" title="Instrumentación fácil de desplegar"%}}
+
+OpenTelemetry se integra con librerías y frameworks populares, tales como
+[Spring](https://spring.io),
+[ASP.NET Core](https://docs.microsoft.com/aspnet/core),
+[Express](https://expressjs.com), [Quarkus](https://quarkus.io) y muchos más.
+Instalar e integrar OpenTelemetry puede ser tan sencillo como añadir unas pocas
+líneas de código.
+
+{{% /blocks/feature %}}
+
+{{% blocks/feature icon="fab fa-github" title="Código abierto, Independiente de proveedores" %}}
+
+100% gratuito y de código abierto, OpenTelemetry es usado y respaldado por
+[empresas líderes](/ecosystem/vendors/) en el sector de la observabilidad.
+
+{{% /blocks/feature %}}
+
+{{% /blocks/section %}}
+
+{{% blocks/section color="secondary" type="cncf" %}}
+
+**OpenTelemetry es un proyecto [CNCF][] [en incubación][]**.Se formó a partir +de la fusión de los proyectos OpenTracing y OpenCensus. + +[![CNCF logo][]][cncf] + +[cncf]: https://cncf.io +[cncf logo]: /img/logos/cncf-white.svg +[en incubación]: https://www.cncf.io/projects/ + +{{% /blocks/section %}} diff --git a/content/es/docs/what-is-opentelemetry.md b/content/es/docs/what-is-opentelemetry.md new file mode 100644 index 000000000000..10f5e4da8768 --- /dev/null +++ b/content/es/docs/what-is-opentelemetry.md @@ -0,0 +1,132 @@ +--- +title: ¿Qué es OpenTelemetry? +description: Qué es y qué no es OpenTelemetry, una breve explicación +weight: 150 +default_lang_commit: 13c2d415e935fac3014344e67c6c61556779fd6f +cSpell:ignore: microservicios extensibilidad +--- + +OpenTelemetry es: + +- Un framework de + [observabilidad](/docs/concepts/observability-primer/#what-is-observability) y + un conjunto de herramientas diseñado para crear y gestionar datos de + telemetría tales como [trazas](/docs/concepts/signals/traces/), + [métricas](/docs/concepts/signals/metrics/) y + [logs](/docs/concepts/signals/logs/). +- Independiente de proveedores y herramientas, lo que significa que puede usarse + con una amplia variedad de backends de observabilidad, incluyendo + [Jaeger](https://www.jaegertracing.io/) y + [Prometheus](https://prometheus.io/), así como soluciones comerciales. +- No es un backend de observabilidad como Jaeger, Prometheus, o productos + comerciales de terceros. +- Enfocado en la generación, recopilación, gestión y exportación de telemetría. + Uno de los objetivos principales de OpenTelemetry es que puedas instrumentar + fácilmente tus aplicaciones o sistemas, sin importar el lenguaje de + programación, infraestructura o entorno de ejecución. El almacenamiento y + visualización de la telemetría se deja intencionadamente a otras herramientas. + +## ¿Qué es la observabilidad? + +[Observabilidad](/docs/concepts/observability-primer/#what-is-observability) es +la capacidad para comprender el estado interno de un sistema a través del +análisis de sus resultados. En el contexto del software, esto significa ser +capaces de comprender el estado interno de un sistema a través del análisis de +sus datos de telemetría, que incluyen trazas, métricas y logs. + +Para que un sistema sea observable, debe ser +[instrumentado](/docs/concepts/instrumentation), esto es, su código debe emitir +[trazas](/docs/concepts/signals/traces/), +[métricas](/docs/concepts/signals/metrics/) o +[logs](/docs/concepts/signals/logs/). Los datos instrumentados tienen que ser +enviados luego a un backend de observabilidad. + +## ¿Por qué OpenTelemetry? + +Con el auge de la computación en la nube, las arquitecturas de microservicios y +requisitos comerciales cada vez más complejos, la necesidad de +[observabilidad](/docs/concepts/observability-primer/#what-is-observability) del +software y la infraestructura es mayor que nunca. + +OpenTelemetry satisface la necesidad de observabilidad siguiendo dos principios +fundamentales: + +1. Eres dueño de los datos que generas. No hay ningún tipo de dependencia del + proveedor. +2. Solo tienes que aprender un único conjunto de API y convenciones. + +Ambos principios combinados otorgan a los equipos y organizaciones la +flexibilidad que necesitan en el mundo informático de hoy en día. + +Si quieres aprender más, echa un vistazo a +[la misión, la visión y los valores](/community/mission/) de OpenTelemetry. + +## Main OpenTelemetry components + +OpenTelemetry consta de los siguientes componentes principales: + +- Una [especificación](/docs/specs/otel) para todos los componentes. +- Un [protocolo](/docs/specs/otlp/) estándar que define el formato de los datos + de telemetría. +- Una [convención semántica](/docs/specs/semconv/) que define un sistema de + nomenclatura estándar para tipos de datos de telemetría comunes. +- APIs que describen cómo se generan los datos de telemetría. +- [SDKs para cada lenguaje](/docs/languages) que implementan las + especificaciones, las APIs, y que exportan datos de telemetría. +- Un [ecosistema de librerías](/ecosystem/registry) que implementan + instrumentación para librerías y frameworks populares. +- Componentes de instrumentación automática que generan datos de telemetría sin + requerir cambios en el código. +- El [OpenTelemetry Collector](/docs/collector), un proxy que recibe, procesa y + exporta datos de telemetría. +- Numerosas herramientas, como el + [OpenTelemetry Operator para Kubernetes](/docs/kubernetes/operator/), + [OpenTelemetry Helm Charts](/docs/kubernetes/helm/) y + [recursos para la comunidad para FaaS](/docs/faas/). + +OpenTelemetry es utilizado por una amplia variedad de +[librerías, servicios y aplicaciones](/ecosystem/integrations/) que integran +OpenTelemetry y proporcionan observabilidad por defecto. + +OpenTelemetry cuenta con el respaldo de numerosos +[proveedores](/ecosystem/vendors/), muchos de los cuales brindan soporte +comercial para OpenTelemetry y contribuyen directamente al proyecto. + +## Extensibilidad + +OpenTelemetry está diseñado para ser extensible. Algunos ejemplos de cómo se +puede extender incluyen: + +- Agregar un receptor al OpenTelemetry Collector para admitir datos de + telemetría desde una fuente de datos personalizada. +- Cargar librerías de instrumentación personalizadas en un SDK. +- Crear una [distribución](/docs/concepts/distributions/) de un SDK o Collector + adaptada a un caso de uso específico. +- Crear un nuevo exportador para un backend personalizado que aún no admite el + protocolo OpenTelemetry (OTLP). +- Crear un propagador personalizado para un formato de propagación de contexto + que no es estándar. + +Aunque la mayoría de los usuarios tal vez no necesiten extender OpenTelemetry, +el proyecto está diseñado para hacerlo posible en casi todos los niveles. + +## Historia + +OpenTelemetry es un proyecto de +[Cloud Native Computing Foundation (CNCF)](https://www.cncf.io) que es el +resultado de una fusión entre dos proyectos anteriores, +[OpenTracing](https://opentracing.io) y [OpenCensus](https://opencensus.io). +Ambos proyectos fueron creados para resolver el mismo problema: la falta de un +estándar sobre cómo instrumentar código y enviar datos de telemetría a un +backend de Observabilidad. Como ninguno de los dos proyectos anteriores pudo +resolver por completo el problema de forma independiente, se fusionaron para +formar OpenTelemetry y combinar así sus fortalezas a la vez que ofrecían una +solución única. + +Si usas OpenTracing u OpenCensus, aprende cómo migrar a OpenTelemetry en la +[guía de migración](/docs/migration/). + +## Pasos siguientes + +- [Tutorial de inicio rápido](/docs/getting-started/): ¡lánzate de inmediato! +- Conoce los [conceptos fundamentales de OpenTelemetry](/docs/concepts/). diff --git a/content/ja/announcements/_index.md b/content/ja/announcements/_index.md new file mode 100644 index 000000000000..c30a14ef1e14 --- /dev/null +++ b/content/ja/announcements/_index.md @@ -0,0 +1,6 @@ +--- +title: お知らせ +cascade: + type: docs +default_lang_commit: 48eac183a4dd74946d5a45fa436cfc6052f30532 +--- diff --git a/content/ja/announcements/otel-localized.md b/content/ja/announcements/otel-localized.md new file mode 100644 index 000000000000..bee28db0effd --- /dev/null +++ b/content/ja/announcements/otel-localized.md @@ -0,0 +1,10 @@ +--- +title: OpenTelemetryのウェブサイトが国際化に対応しました！ +date: 2024-08-21 +expiryDate: 2024-09-30 +weight: -240821 # top +default_lang_commit: 48eac183a4dd74946d5a45fa436cfc6052f30532 +--- + + {{% param title %}} +[詳細はこちら](/blog/2024/docs-localized/) diff --git a/content/ja/blog/2024/_index.md b/content/ja/blog/2024/_index.md new file mode 100644 index 000000000000..830390104ca3 --- /dev/null +++ b/content/ja/blog/2024/_index.md @@ -0,0 +1,6 @@ +--- +title: 2024 +weight: -2024 +outputs: [HTML, RSS] +default_lang_commit: 48eac183a4dd74946d5a45fa436cfc6052f30532 +--- diff --git a/content/ja/blog/2024/docs-localized.md b/content/ja/blog/2024/docs-localized.md new file mode 100644 index 000000000000..ef5605d05716 --- /dev/null +++ b/content/ja/blog/2024/docs-localized.md @@ -0,0 +1,28 @@ +--- +title: OpenTelemetryのウェブサイトが多言語化されました！ +linkTitle: 多言語サイト +date: 2024-08-21 +author: >- + [Severin Neumann](https://github.com/svrnm) (Cisco) +issue: 4863 +sig: Comms +default_lang_commit: 48eac183a4dd74946d5a45fa436cfc6052f30532 +--- + +OpenTelemetry のウェブサイトが多言語で利用可能になったことをお知らせします！ +ローカライゼーションチームはすでに、ウェブサイトのページを[中国語](/zh)、[日本語](/ja)、[ポルトガル語](/pt)、[スペイン語](/es)に翻訳し始めています。 + +OpenTelemetryプロジェクトは、世界中の貢献者とユーザーを得るまでに成長しました。 +ウェブサイトを多言語で利用できるようにすることは、母国語に関係なく、誰もがプロジェクトに貢献できるようにするための重要なステップです。 +また、この取り組みによって、エンドユーザーが多言語のドキュメントにアクセスできるようになり、OpenTelemetryをより簡単に学び、理解できるようになることを嬉しく思います。 + +希望の言語でウェブサイトにアクセスするには、ページ右上の言語セレクターから選択してください。 + +ぜひこの取り組みに貢献してください。 +ローカライゼーションに貢献する仲間は、Slackチャンネル [#otel-docs-localization](https://cloud-native.slack.com/archives/C076RUAGP37) にいます。 +すでにサポートされている言語に堪能な方は、翻訳やレビューを手伝ってください。 +あなたの言語がまだサポートされておらず、翻訳を手伝いたい場合は、[issueを作成してください](
以 Java 语言实现特定的 OpenTelemetry。
+aliases: [/java, /java/metrics, /java/tracing]
+cascade:
+ vers:
+ instrumentation: 2.7.0
+ otel: 1.41.0
+ semconv: 1.26.0
+weight: 18
+default_lang_commit: 20c51c53
+---
+
+{{% docs/languages/index-intro java /%}}
+
+### 仓库
+
+OpenTelemetry Java 由以下仓库组成：
+
+- [opentelemetry-java](https://github.com/open-telemetry/opentelemetry-java)：
+ 用于手动插桩的组件，包括 API 和 SDK，也包括扩展和 OpenTracing shim。
+- [opentelemetry-java-docs][]：手动插桩样例。
+- [opentelemetry-java-instrumentation](https://github.com/open-telemetry/opentelemetry-java-instrumentation)：
+ 建立在 opentelemetry-java 之上，并提供一个 Java agent JAR，可以附加到任何 Java 8+ 应用程序，并动态注入字节码，从许多流行的库和框架中捕获遥测数据。
+- [opentelemetry-java-contrib](https://github.com/open-telemetry/opentelemetry-java-contrib)：
+ 提供有用的库和独立的基于 OpenTelemetry 的实用程序，这些实用程序不属于 OpenTelemetry Java 或 Java Instrumentation 项目的明确范围。
+ 例如，JMX 指标收集。
+- [semantic-conventions-java](https://github.com/open-telemetry/semantic-conventions-java)：
+ [OpenTelemetry 语义约定](/docs/specs/semconv/)的 Java 实现。例如 `ResourceAttributes.SERVICE_NAME`。
+- [opentelemetry-proto-java](https://github.com/open-telemetry/opentelemetry-proto-java)：
+ [OpenTelemetry 协议 (OTLP)](/docs/specs/otlp/) 的 Java 绑定。
+
+### 组件
+
+查看[组件]以获取已发布组件的完整列表。
+
+### 发行版
+
+已经发布的[发行版][]可以在 [maven 中央仓库][]上找到。
+我们强烈推荐使用我们的 BOM 来保持各种组件的版本同步。
+
+#### Maven
+
+```xml
+
-
+
{{- .title | markdownify -}}
@@ -99,6 +107,11 @@
{{ if $deprecated -}}
deprecated
{{ end -}}
+ {{ if .cncfProjectLevel -}}
+
+ 
{{ .cncfProjectLevel }}
+
+ {{ end -}}
{{ if $deprecated -}}
deprecated
{{ end -}}
+ {{ if .cncfProjectLevel -}}
+
+ {{ .cncfProjectLevel }}
+
+ {{ end -}}
@@ -183,9 +196,9 @@
Quick Install
Quick Install
{{- end -}} {{ with .urls.repo -}} {{ $icon := cond ( hasPrefix . "https://github.com/" ) "fa-brands fa-github" "fab fa-git-alt" -}} + {{ $repoHref := printf "href=%q" . | safeHTMLAttr -}} Repository {{- end -}} {{ with .urls.demo -}} diff --git a/layouts/shortcodes/docs/languages/exporters/prometheus-setup.md b/layouts/shortcodes/docs/languages/exporters/prometheus-setup.md index 26ddaea71d8a..5c0ae214afdc 100644 --- a/layouts/shortcodes/docs/languages/exporters/prometheus-setup.md +++ b/layouts/shortcodes/docs/languages/exporters/prometheus-setup.md @@ -2,10 +2,9 @@ To send your metric data to [Prometheus](https://prometheus.io/), you can either [enable Prometheus' OTLP Receiver](https://prometheus.io/docs/prometheus/latest/feature_flags/#otlp-receiver) -and use the [OTLP exporter](#otlp) or you can use the -[`PrometheusHttpServer`](https://javadoc.io/doc/io.opentelemetry/opentelemetry-exporter-prometheus/latest/io/opentelemetry/exporter/prometheus/PrometheusHttpServer.html), -a `MetricReader`, that starts an HTTP server that will collect metrics and -serialize to Prometheus text format on request. +and use the [OTLP exporter](#otlp) or you can use the Prometheus exporter, a +`MetricReader` that starts an HTTP server that collects metrics and serialize to +Prometheus text format on request. ### Backend Setup {#prometheus-setup} diff --git a/layouts/shortcodes/docs/languages/libraries-intro.md b/layouts/shortcodes/docs/languages/libraries-intro.md index b31bc3107d8f..00a40302dbe3 100644 --- a/layouts/shortcodes/docs/languages/libraries-intro.md +++ b/layouts/shortcodes/docs/languages/libraries-intro.md @@ -1,7 +1,12 @@ -{{ $lang := .Get 0 -}} {{ $howMany := .Get 1 | default 10 -}} -{{ $integrations := where (where $.Site.Data.ecosystem.integrations ".components" "intersect" (slice $lang)) ".native" "eq" true -}} +{{ $langIndex := .Get 0 }} +{{ $lang := index $.Site.Data.instrumentation $langIndex -}} +{{ $integrations := where (slice ) ".language" $langIndex -}} + +{{ $integrations := slice }} {{ range $entry := $.Site.Data.registry }} +{{ if and (and (eq $entry.language $langIndex) (eq $entry.isNative true)) (eq $entry.registryType "instrumentation") }} +{{ $integrations = $integrations | append $entry }} {{ end }} {{ end }} When you develop an app, you might use third-party libraries and frameworks to accelerate your work. If you then instrument your app using OpenTelemetry, you @@ -29,20 +34,20 @@ Go to the documentation for that library to learn more. {{ range first $howMany (sort $integrations "name") -}} -- [{{ .name }}]({{ .docsUrl }}) +- [{{ .title }}]({{ .urls.docs }}) {{- end }} {{ if eq (len $integrations) 0 -}}Help wanted!
-As of today, we don't know about any {{ $lang }} library that has OpenTelemetry +As of today, we don't know about any {{ $lang.name }} library that has OpenTelemetry natively integrated. If you know about such a library, let us know.
-If you know a {{ $lang }} library that has OpenTelemetry
+If you know a {{ $lang.name }} library that has OpenTelemetry
natively integrated,
let us know.
diff --git a/layouts/shortcodes/ecosystem/integrations-table.md b/layouts/shortcodes/ecosystem/integrations-table.md
index 8da425d350e8..9b63ad695d0b 100644
--- a/layouts/shortcodes/ecosystem/integrations-table.md
+++ b/layouts/shortcodes/ecosystem/integrations-table.md
@@ -1,10 +1,20 @@
-
-{{ $data := sort (sort $.Site.Data.ecosystem.integrations "name") "oss" "desc" -}}
-Name[^1] | OSS | Components | Learn more
+
+{{ $integrations := slice -}}
+{{ range $entry := $.Site.Data.registry -}}
+ {{ if or (and (eq ($.Get 0) "native libraries") (eq $entry.isNative true) (eq $entry.registryType "instrumentation")) (and (eq ($.Get 0) "application integrations") (eq $entry.registryType "application integration")) -}}
+ {{ $entry = merge $entry (dict "oss" (ne .license "Commercial")) -}}
+ {{ $integrations = $integrations | append $entry -}}
+ {{ end -}}
+{{ end -}}
+
+{{ $languages := merge $.Site.Data.instrumentation (dict "collector" (dict "name" "collector") "lua" (dict "name" "Lua")) -}}
+
+Name[^1] | OSS | Component | Learn more
------------ | --- | ---------- | ----------
-{{- range $data }}
-{{ $cncfTag := cond (not (eq .cncf false)) (printf "![\"CNCF](\"/img/cncf-icon-color.svg\" "\\"CNCF"){kind=icon}
" (humanize .cncf) (humanize .cncf)) "" -}}
-[{{ .name }}]({{ .url }}){{ $cncfTag }} | {{- cond .oss "Yes" "No" }} | {{ delimit (sort .components) ", " }} | [{{ replace .docsUrl "https://" "" }}]({{ .docsUrl }})
+{{- range sort (sort $integrations ".title") ".oss" "desc" }}
+{{ $lang := cond (eq .language "collector") (dict "name" "Collector") (index $.Site.Data.instrumentation .language) -}}
+{{ $cncfTag := cond (isset . "cncfProjectLevel") (printf "" (humanize .cncfProjectLevel) (humanize .cncfProjectLevel)) "" -}}
+[{{ .title }}]({{ .urls.website }}){{ $cncfTag }} | {{- cond (eq .license "Commercial") "No" "Yes" }} | {{ $lang.name }} | [{{ replace .urls.docs "https://" "" }}]({{ .urls.docs }})
{{- end }}
[^1]: Listed alphabetically
diff --git a/layouts/shortcodes/ecosystem/registry/search-form.html b/layouts/shortcodes/ecosystem/registry/search-form.html
index f751e7c24753..4e2fc00028c1 100644
--- a/layouts/shortcodes/ecosystem/registry/search-form.html
+++ b/layouts/shortcodes/ecosystem/registry/search-form.html
@@ -106,5 +106,5 @@