Merge branch 'main' into drewby/genai_blog

open-telemetry · Dec 3, 2024 · 963ed7d · 963ed7d
2 parents 28a21f7 + 60c9c3e
commit 963ed7d
Show file tree

Hide file tree

Showing 21 changed files with 116 additions and 51 deletions.
diff --git a/.prettierignore b/.prettierignore
@@ -7,7 +7,8 @@
 !/layouts/shortcodes
 /layouts/shortcodes/*
 !/layouts/shortcodes/docs
-/layouts/shortcodes/pt
+!/layouts/shortcodes/es
+!/layouts/shortcodes/pt
 
 /content/ja
 /content/zh

diff --git a/content/en/community/end-user/slack-channel.md b/content/en/community/end-user/slack-channel.md
@@ -6,21 +6,17 @@ description: >-
 weight: 40
 ---
 
-Previously, we had a private channel to provide a space for end users to discuss
-adoption and implementation issues while allowing them to maintain a layer of
-privacy and to meet compliance concerns. Now that the project and community have
-grown, and with the transition of the End User WG to End User SIG, we believe
-that this private channel is no longer needed.
+Join our Slack channel to connect with other OpenTelemetry end users!
 
-As of April 2024, we will begin shifting all of our communications to the
-[`#otel-sig-end-user`](https://cloud-native.slack.com/archives/C01RT3MSWGZ)
-channel (previously named the `#otel-user-research` channel), and will be
-archiving the private channel by **April 30, 2024**.
+First, [request an invitation](https://slack.cncf.io/) to CNCF's Slack instance.
+Next, join
+[`#otel-sig-end-user`](https://cloud-native.slack.com/archives/C01RT3MSWGZ), and
+introduce yourself if you'd like.
 
-We encourage you to join us over at
-[`#otel-sig-end-user`](https://cloud-native.slack.com/archives/C01RT3MSWGZ) to
-learn about our new charter, what you can expect from us as an end user, and
-more. Note the following:
+We encourage questions and discussions about adoption and implementation. You
+can also hear about upcoming events and get a chance to contribute to the
+project by participating in surveys and user feedback sessions. Note the
+following:
 
 - Troubleshooting or tactical SDK specific questions are still best directed to
   individual SIG channels or the

diff --git a/content/en/docs/collector/internal-telemetry.md b/content/en/docs/collector/internal-telemetry.md
@@ -168,14 +168,14 @@ service:
             exporter:
               otlp:
                 protocol: grpc/protobuf
-                endpoint: localhost:14317
+                endpoint: http://localhost:14317
     traces:
       processors:
-        batch:
-          exporter:
-            otlp:
-              protocol: grpc/protobuf
-              endpoint: localhost:14317
+        - batch:
+            exporter:
+              otlp:
+                protocol: grpc/protobuf
+                endpoint: http://localhost:14317
 ```
 
 {{% alert title="Caution" color="warning" %}}

diff --git a/content/en/docs/concepts/signals/metrics.md b/content/en/docs/concepts/signals/metrics.md
@@ -69,6 +69,9 @@ The instrument kind is one of the following:
   size).
 - **Gauge**: Measures a current value at the time it is read. An example would
   be the fuel gauge in a vehicle. Gauges are asynchronous.
+- **Asynchronous Gauge**: Same as the **Gauge**, but is collected once for each
+  export. Could be used if you don't have access to the continuous changes, but
+  only to the aggregated value.
 - **Histogram**: A client-side aggregation of values, such as request latencies.
   A histogram is a good choice if you are interested in value statistics. For
   example: How many requests take fewer than 1s?

diff --git a/content/en/docs/languages/go/instrumentation.md b/content/en/docs/languages/go/instrumentation.md
@@ -302,7 +302,7 @@ OpenTelemetry Go currently supports the following instruments:
 - Histogram, a synchronous instrument that supports arbitrary values that are
   statistically meaningful, such as histograms, summaries, or percentile
 - Synchronous Gauge, a synchronous instrument that supports non-additive values,
-  such as room temperature.
+  such as room temperature
 - Asynchronous Gauge, an asynchronous instrument that supports non-additive
   values, such as room temperature
 - UpDownCounter, a synchronous instrument that supports increments and

diff --git a/content/en/docs/languages/php/_index.md b/content/en/docs/languages/php/_index.md
@@ -17,8 +17,13 @@ cSpell:ignore: mbstring opcache
 
 ## Requirements
 
-OpenTelemetry for PHP requires a minimum PHP version of 7.4, and
-auto-instrumentation requires version 8.0+.
+OpenTelemetry SDK for PHP aims to support all officially supported PHP versions
+according to
+[www.php.net/supported-versions](https://www.php.net/supported-versions.php),
+and support will be dropped for PHP versions within 12 months of that version
+going End of Life.
+
+Auto-instrumentation requires PHP version 8.0+.
 
 ### Dependencies
 

diff --git a/content/ja/docs/concepts/signals/metrics.md b/content/ja/docs/concepts/signals/metrics.md
@@ -2,7 +2,7 @@
 title: メトリクス
 weight: 2
 description: 実行時に取得された測定値
-default_lang_commit: 9b5e318
+default_lang_commit: eb19d1dd5ab2f66343ec76adbfb31f81024da3a1
 ---
 
 **メトリクス**とは、実行時に取得されるサービスの**測定値**のことです。
@@ -53,6 +53,8 @@ OpenTelemetryでは、計測は **メトリクス計装** によって行われ
 - **Asynchronous UpDownCounter（非同期アップダウンカウンター）**: **アップダウンカウンター**と同じですが、各エクスポートに対して一度だけ収集されます。
   連続的な変更にアクセスできず、集約された値（たとえば、現在のキューのサイズ）のみにアクセスできる場合に使用できます。
 - **Gauge（ゲージ）**: 読み取った時点での現在の値を測定します。たとえば、自動車の燃料計など。ゲージは非同期です。
+- **Asynchronous Gauge（非同期ゲージ）**: **ゲージ**と同じですが、各エクスポートに対して一度だけ収集されます。
+  連続的な変更にアクセスできず、集約された値 のみにアクセスできる場合に使用できます。
 - **Histogram（ヒストグラム）**: リクエストのレイテンシーなどの値をクライアント側で集約したもの。
   値の統計に興味がある場合は、ヒストグラムが良いでしょう。
   たとえば、どれくらいのリクエストが1秒未満か、といった疑問に答えてくれます。

diff --git a/content/pt/docs/concepts/signals/metrics.md b/content/pt/docs/concepts/signals/metrics.md
@@ -2,7 +2,7 @@
 title: Métricas
 weight: 2
 description: Uma medição capturada em tempo de execução.
-default_lang_commit: 3446c7ce49a17975b012c302bdd1c89d4902267c
+default_lang_commit: eb19d1dd5ab2f66343ec76adbfb31f81024da3a1
 ---
 
 Uma métrica é uma medição de um serviço capturada em tempo de execução. O
@@ -72,6 +72,9 @@ O tipo de instrumento deve ser um dos seguintes:
   tamanho da fila).
 - **Gauge**: Mede o valor atual no momento da leitura. Um exemplo seria um
   medidor de tanque de combustível de um veículo. Gauges são assíncronos.
+- **Asynchronous Gauge**: Assim como o **Gauge**, porém é coletado uma vez a
+  cada exportação. Pode ser usado em casos onde você não tenha acesso às
+  mudanças contínuas, mas apenas ao valor agregado.
 - **Histogram**: Uma agregação de valores, tal como latências de requisições. Um
   histograma é uma boa escolha se você está interessado em valores de
   estatísticas. Por exemplo: Quantas requisições estão levando menos de 1s?

diff --git a/content/zh/docs/concepts/signals/_index.md b/content/zh/docs/concepts/signals/_index.md
@@ -0,0 +1,27 @@
+---
+title: 信号
+description: 了解 OpenTelemetry 支持的遥测类别
+aliases:
+  - /docs/concepts/data-sources
+  - /docs/concepts/otel-concepts
+weight: 11
+default_lang_commit: e7c30e9
+---
+
+OpenTelemetry 的目的是收集、处理和导出 **[信号][]** 。
+信号是系统输出，描述了操作系统和平台上运行的应用程序的底层活动。
+信号可以是你希望在特定时间点测量的某项指标，如温度或内存使用率，
+也可以是贯穿分布式系统组件的事件，你希望对其进行跟踪。
+你可以将不同的信号组合在一起，从不同角度观察同一种技术的内部运作方式。
+
+目前，OpenTelemetry 支持以下类型的信号：
+
+- [追踪（Trace）](/docs/concepts/signals/traces)
+- [指标 (Metric)](/docs/concepts/signals/metrics)
+- [日志 (Log)](/docs/concepts/signals/logs)
+- [行李 (Baggage)](/docs/concepts/signals/baggage)
+
+**事件**是一种特定类型的日志，而
+[**profiles** 正在由 Profiling 工作组开发](https://github.com/open-telemetry/oteps/blob/main/text/profiles/0212-profiling-vision.md)。
+
+[信号]: /docs/specs/otel/glossary/#signals
diff --git a/data/ecosystem/vendors.yaml b/data/ecosystem/vendors.yaml
@@ -414,6 +414,12 @@
   contact: https://github.com/adnanrahic
   oss: true
   commercial: true
+- name: Alauda
+  nativeOTLP: true
+  url: https://www.alauda.io/community/143237
+  contact: [email protected]
+  oss: false
+  commercial: true
 - name: Alibaba Cloud
   nativeOTLP: true
   url: https://www.alibabacloud.com/help/en/arms/tracing-analysis/get-started-with-tracing-analysis

diff --git a/data/instrumentation.yaml b/data/instrumentation.yaml
@@ -61,8 +61,8 @@ rust:
   name: Rust
   status:
     traces: beta
-    metrics: alpha
-    logs: alpha
+    metrics: beta
+    logs: beta
 swift:
   name: Swift
   status:

diff --git a/data/registry-schema.json b/data/registry-schema.json
@@ -17,13 +17,13 @@
       "description": "The type of the entry",
       "enum": [
         "application integration",
-        "confmap provider",
         "core",
         "exporter",
         "extension",
         "instrumentation",
         "log-bridge",
         "processor",
+        "provider",
         "receiver",
         "resource-detector",
         "utilities"

diff --git a/data/registry/collector-confmap-provider-envprovider.yml b/data/registry/collector-confmap-provider-envprovider.yml
@@ -1,6 +1,6 @@
 # cSpell:ignore confmap, envprovider
 title: Collector Environment Variable Provider
-registryType: confmap provider
+registryType: provider
 language: collector
 tags:
   - go

diff --git a/data/registry/collector-confmap-provider-fileprovider.yml b/data/registry/collector-confmap-provider-fileprovider.yml
@@ -1,6 +1,6 @@
 # cSpell:ignore confmap, fileprovider
 title: Collector File Provider
-registryType: confmap provider
+registryType: provider
 language: collector
 tags:
   - go

diff --git a/data/registry/collector-confmap-provider-httpprovider.yml b/data/registry/collector-confmap-provider-httpprovider.yml
@@ -1,6 +1,6 @@
 # cSpell:ignore confmap, httpprovider
 title: Collector HTTP Provider
-registryType: confmap provider
+registryType: provider
 language: collector
 tags:
   - go

diff --git a/data/registry/collector-confmap-provider-httpsprovider.yml b/data/registry/collector-confmap-provider-httpsprovider.yml
@@ -1,6 +1,6 @@
 # cSpell:ignore confmap, httpsprovider
 title: Collector HTTPS Provider
-registryType: confmap provider
+registryType: provider
 language: collector
 tags:
   - go

diff --git a/data/registry/collector-confmap-provider-yamlprovider.yml b/data/registry/collector-confmap-provider-yamlprovider.yml
@@ -1,6 +1,6 @@
 # cSpell:ignore confmap, yamlprovider
 title: Collector YAML Provider
-registryType: confmap provider
+registryType: provider
 language: collector
 tags:
   - go

diff --git a/layouts/shortcodes/es/docs/languages/instrumentation-intro.md b/layouts/shortcodes/es/docs/languages/instrumentation-intro.md
@@ -1,13 +1,16 @@
-[Instrumentar](/docs/concepts/instrumentation/) consiste en añadir el código de observabilidad a una app.
+[Instrumentar](/docs/concepts/instrumentation/) consiste en añadir el código de
+observabilidad a una app.
 
-Si estás instrumentando una app, necesitas usar el SDK de OpenTelemetry para tu lenguaje.
-Luego debes usar el SDK para inicializar OpenTelemetry y la API para instrumentar tu código.
-Esto emitirá telemetría desde tu app, y de cualquier librería que hayas instalado que
-también esté instrumentada.
+Si estás instrumentando una app, necesitas usar el SDK de OpenTelemetry para tu
+lenguaje. Luego debes usar el SDK para inicializar OpenTelemetry y la API para
+instrumentar tu código. Esto emitirá telemetría desde tu app, y de cualquier
+librería que hayas instalado que también esté instrumentada.
 
-Si estás instrumentando una librería, tan solo instala el paquete de OpenTelemetry API para tu lenguaje.
-Tu librería no emitirá telemetría por si sola. Solo lo hará cuando sea parte de una app que use el SDK
-de OpenTelemetry. Para más información sobre instrumentación de librerías, consulta 
+Si estás instrumentando una librería, tan solo instala el paquete de
+OpenTelemetry API para tu lenguaje. Tu librería no emitirá telemetría por si
+sola. Solo lo hará cuando sea parte de una app que use el SDK de OpenTelemetry.
+Para más información sobre instrumentación de librerías, consulta
 [Librerías](/docs/concepts/instrumentation/libraries/).
 
-Para más información sobre la API y el SDK de OpenTelemetry, consulta la [especificación](/docs/specs/otel/).
+Para más información sobre la API y el SDK de OpenTelemetry, consulta la
+[especificación](/docs/specs/otel/).
diff --git a/layouts/shortcodes/pt/docs/languages/index-intro.md b/layouts/shortcodes/pt/docs/languages/index-intro.md
@@ -1,7 +1,6 @@
 {{/*
 default_lang_commit: 2e21274a01a24a62c67595591d8f4255bef640fc
-*/ -}}
-{{ $prettier_ignore := `
+*/ -}} {{ $prettier_ignore := `
 
 <!-- prettier-ignore -->
 ` -}}
@@ -13,15 +12,18 @@ default_lang_commit: 2e21274a01a24a62c67595591d8f4255bef640fc
 {{ $metricsStatus := partial "docs/get-signal-status.html" (dict "lang" $lang "signal" "metrics") -}}
 {{ $logsStatus := partial "docs/get-signal-status.html" (dict "lang" $lang "signal" "logs") -}}
 
-Esta é a documentação do OpenTelemetry para a linguagem {{ $name }}. O OpenTelemetry é um
-framework de observabilidade -- API, SDKs, e ferramentas que são desenvolvidas para auxiliar na
-geração e coleta de dados de telemetria de aplicações, como métricas, logs e rastros. Esta documentação foi criada para te auxiliar a entender como começar a utilizar o OpenTelemetry em {{ $name }}.
+Esta é a documentação do OpenTelemetry para a linguagem {{ $name }}. O
+OpenTelemetry é um framework de observabilidade -- API, SDKs, e ferramentas que
+são desenvolvidas para auxiliar na geração e coleta de dados de telemetria de
+aplicações, como métricas, logs e rastros. Esta documentação foi criada para te
+auxiliar a entender como começar a utilizar o OpenTelemetry em {{ $name }}.
 
 ## Estado e Lançamentos
 
-O estado atual dos principais componentes funcionais do OpenTelemetry para {{ $name }} é o seguinte:
+O estado atual dos principais componentes funcionais do OpenTelemetry para
+{{ $name }} é o seguinte:
 
-| Rastros              | Métricas              | Logs              |
+| Rastros             | Métricas             | Logs              |
 | ------------------- | -------------------- | ----------------- |
 | {{ $tracesStatus }} | {{ $metricsStatus }} | {{ $logsStatus }} |
 

diff --git a/layouts/shortcodes/pt/docs/languages/resources-intro.md b/layouts/shortcodes/pt/docs/languages/resources-intro.md
@@ -9,6 +9,15 @@ default_lang_commit: a1740fd934e595f1396f2eb82a58a80824369b09
   {{ $resourceHRef = "/docs/specs/otel/resource/sdk/" -}}
 {{ end -}}
 
-Um [recurso]({{ $resourceHRef }}) representa a entidade que está gerando telemetria como atributos do recurso. Por exemplo, um {{ $processWord }} que está gerando telemetria e que está sendo executado em um _container_ no Kubernetes tem o nome de um {{ $processWord }}, um nome de _pod_, um _namespace_ e possivelmente um nome de _deployment_. Todos esses quatro atributos podem ser incluídos em um recurso.
+Um [recurso]({{ $resourceHRef }}) representa a entidade que está gerando
+telemetria como atributos do recurso. Por exemplo, um {{ $processWord }} que
+está gerando telemetria e que está sendo executado em um _container_ no
+Kubernetes tem o nome de um {{ $processWord }}, um nome de _pod_, um _namespace_
+e possivelmente um nome de _deployment_. Todos esses quatro atributos podem ser
+incluídos em um recurso.
 
-No seu _backend_ de observabilidade, você pode usar as informações de um recurso para refinar a investigação de comportamentos relevantes. Por exemplo, se seus dados de rastros ou métricas indicarem latência no seu sistema, você pode restringir a investigação para um determinado _container_, _pod_ ou _deployment_ do Kubernetes.
+No seu _backend_ de observabilidade, você pode usar as informações de um recurso
+para refinar a investigação de comportamentos relevantes. Por exemplo, se seus
+dados de rastros ou métricas indicarem latência no seu sistema, você pode
+restringir a investigação para um determinado _container_, _pod_ ou _deployment_
+do Kubernetes.
diff --git a/static/refcache.json b/static/refcache.json
@@ -13159,6 +13159,10 @@
     "StatusCode": 206,
     "LastSeen": "2024-01-30T16:14:59.93877-05:00"
   },
+  "https://www.alauda.io/community/143237": {
+    "StatusCode": 200,
+    "LastSeen": "2024-11-28T11:47:57.828593+01:00"
+  },
   "https://www.alibabacloud.com/": {
     "StatusCode": 200,
     "LastSeen": "2024-01-18T19:36:43.889402-05:00"
@@ -14403,6 +14407,10 @@
     "StatusCode": 200,
     "LastSeen": "2024-01-18T19:56:36.773243-05:00"
   },
+  "https://www.php.net/supported-versions.php": {
+    "StatusCode": 200,
+    "LastSeen": "2024-11-28T12:19:39.104666932Z"
+  },
   "https://www.postgresql.org/docs/current/errcodes-appendix.html": {
     "StatusCode": 200,
     "LastSeen": "2024-10-09T10:19:27.445768+02:00"