[zh] Update languages/_includes/ files (#7552)

Author: windsonsea

content/zh/docs/languages/_includes/exporters/jaeger.md

@@ -6,7 +6,8 @@ default_lang_commit: 2f850a610b5f7da5730265b32c25c9226dc09e5f
 
 ### 后端设置 {#jaeger-backend-setup}
 
-[Jaeger](https://www.jaegertracing.io/) 原生支持 OTLP，用于接收链路（trace）数据。你可以通过运行一个 Docker 容器来启动 Jaeger，其 UI 默认在端口 16686 上可访问，并在端口 4317 和 4318 上启用 OTLP：
+[Jaeger](https://www.jaegertracing.io/) 原生支持 OTLP，用于接收链路数据。
+你可以通过运行一个 Docker 容器来启动 Jaeger，其 UI 默认在端口 16686 上可访问，并在端口 4317 和 4318 上启用 OTLP：
 
 ```shell
 docker run --rm \
@@ -20,4 +21,4 @@ docker run --rm \
 
 ### 使用方法 {#jaeger-usage}
 
-现在，按照说明设置 [OTLP exporters](#otlp-dependencies)。
+现在，按照说明设置 [OTLP 导出器](#otlp-dependencies)。

content/zh/docs/languages/_includes/exporters/outro.md

@@ -2,11 +2,13 @@
 default_lang_commit: 2f850a610b5f7da5730265b32c25c9226dc09e5f
 ---
 
-## 自定义导出器（Exporter）{#custom-exporters}
+## 自定义导出器 {#custom-exporters}
 
 最后，你还可以编写自己的导出器。有关更多信息，请参见
 [API 文档中的 SpanExporter 接口]({{ $1 }}).
 
-## 批量处理 Span 和日志记录{#batching-span-and-log-records}
+## 批量处理 Span 和日志记录 {#batching-span-and-log-records}
 
-OpenTelemetry SDK 提供了一组默认的 span 和日志记录处理器，允许你选择按单条（simple）或按批量（batch）方式导出一个或多个 span。推荐使用批量处理，但如果你不想批量处理 span 或日志记录，可以使用 simple 处理器，方法如下：
+OpenTelemetry SDK 提供了一组默认的 Span 和日志记录处理器，
+允许你选择按单条（simple）或按批量（batch）方式导出一个或多个 Span。
+推荐使用批量处理，但如果你不想批量处理 Span 或日志记录，可以使用 simple 处理器，方法如下：

content/zh/docs/languages/_includes/exporters/prometheus-setup.md

@@ -4,18 +4,17 @@ default_lang_commit: 2f850a610b5f7da5730265b32c25c9226dc09e5f
 
 ## Prometheus
 
-要将你的指标（metrics）数据发送到 [Prometheus](https://prometheus.io/)，
-你可以选择
-[启用 Prometheus 的 OTLP 接收器](https://prometheus.io/docs/prometheus/2.55/feature_flags/#otlp-receiver)
-并且使用 [OTLP exporter](#otlp)，或者使用 Prometheus exporter，这是一种 `MetricReader`，
+要将你的指标数据发送到 [Prometheus](https://prometheus.io/)，
+你可以选择[启用 Prometheus 的 OTLP 接收器](https://prometheus.io/docs/prometheus/2.55/feature_flags/#otlp-receiver)并且使用
+[OTLP 导出器](#otlp)，或者使用 Prometheus 导出器，这是一种 `MetricReader`，
 他启动一个 HTTP 服务器，根据请求收集指标并将数据序列化为 Prometheus 文本格式。
 
 ### 后端设置 {#prometheus-setup}
 
 {{% alert title=注意 %}}
 
-如果你已经设置了 Prometheus 或兼容 Prometheus 的后端，可以跳过本节，直接为你的应用设置 [Prometheus](#prometheus-dependencies) 或者
-[OTLP](#otlp-dependencies) exporter 依赖。
+如果你已经设置了 Prometheus 或兼容 Prometheus 的后端，可以跳过本节，直接为你的应用设置
+[Prometheus](#prometheus-dependencies) 或者 [OTLP](#otlp-dependencies) 导出器依赖。
 
 {{% /alert %}}
 
@@ -39,9 +38,10 @@ docker run --rm -v ${PWD}/prometheus.yml:/prometheus/prometheus.yml -p 9090:9090
 
 {{% alert title=注意 %}}
 
-当使用 Prometheus 的 OTLP 接收器（Reciever）时，确保在应用中设置 OTLP 端点为
+当使用 Prometheus 的 OTLP 接收器时，确保在应用中设置 OTLP 端点为
 `http://localhost:9090/api/v1/otlp`。
 
-并非所有的 Docker 环境都支持 `host.docker.internal`。在某些情况下，你可能需要将 `host.docker.internal` 替换为 `localhost` 或你机器的 IP 地址。
+并非所有的 Docker 环境都支持 `host.docker.internal`。在某些情况下，你可能需要将
+`host.docker.internal` 替换为 `localhost` 或你机器的 IP 地址。
 
 {{% /alert %}}

content/zh/docs/languages/_includes/exporters/zipkin-setup.md

@@ -8,7 +8,8 @@ default_lang_commit: 2f850a610b5f7da5730265b32c25c9226dc09e5f
 
 {{% alert title=提示 %}}
 
-如果你已经设置了 Zipkin 或兼容 Zipkin 的后端，可以跳过本节并直接为你的应用设置 [Zipkin exporter 依赖](#zipkin-dependencies)。
+如果你已经设置了 Zipkin 或兼容 Zipkin 的后端，可以跳过本节并直接为你的应用设置
+[Zipkin 导出器依赖](#zipkin-dependencies)。
 
 {{% /alert %}}
 

content/zh/docs/languages/_includes/index-intro.md

@@ -3,18 +3,18 @@ default_lang_commit: 2f850a610b5f7da5730265b32c25c9226dc09e5f
 ---
 
 这是 OpenTelemetry {{ $name }} 的文档。 OpenTelemetry 是一个可观测性框架，这个框架提供了
-API、SDK 以及一系列工具，用于辅助生成以及收集应用程序的遥测数据，比如指标（metrics）、日志（logs）
-和链路追踪（trace），通过本文档，你会了解如何开始使用 OpenTelemetry {{ $name }}。
+API、SDK 以及一系列工具，用于辅助生成以及收集应用的遥测数据，比如链路、指标、日志。
+通过本文档，你将了解如何开始使用 OpenTelemetry {{ $name }}。
 
-## 状态以及版本发布{#status-and-releases}
+## 状态以及版本发布 {#status-and-releases}
 
 OpenTelemetry {{ $name }} 的当前主要功能组件状态如下：
 
-| 链路追踪（Traces）  | 指标（Metrics）      | 日志（Logs）      |
+| 链路                | 指标                 | 日志              |
 | ------------------- | -------------------- | ----------------- |
 | {{ $tracesStatus }} | {{ $metricsStatus }} | {{ $logsStatus }} |
 
-我们可以在 [Releases] 中找到所有已发布的版本，包括 [latest release][]。 {{ $.Inner }}
+我们可以在 [Releases] 中找到所有已发布的版本，包括[最新发布的版本][latest release]。 {{ $.Inner }}
 
 [latest release]: <https://github.com/open-telemetry/opentelemetry-{{ $lang }}/releases/latest>
 [Releases]: <https://github.com/open-telemetry/opentelemetry-{{ $lang }}/releases>

content/zh/docs/languages/_includes/instrumentation-intro.md

@@ -2,12 +2,13 @@
 default_lang_commit: 2f850a610b5f7da5730265b32c25c9226dc09e5f
 ---
 
-[插桩（Instrumentation）](/docs/concepts/instrumentation/) 是指向应用中添加可观测性代码的行为。
+[插桩](/docs/concepts/instrumentation/)是指向应用中添加可观测性代码的行为。
 
-如果你正在对一个应用进行插桩，需要使用适合你语言的 OpenTelemetry SDK。然后，你可以使用 SDK 初始化 OpenTelemetry，并使用 API 对代码进行插桩。这将从你的应用及其安装的任何带有插桩的库中导出遥测数据。
+如果你正在对一个应用进行插桩，需要使用适合你语言的 OpenTelemetry SDK。然后，你可以使用
+SDK 初始化 OpenTelemetry，并使用 API 对代码进行插桩。这将从你的应用及其安装的任何带有插桩的库中导出遥测数据。
 
-如果你正在对一个库进行插桩，只需安装适合你语言的 OpenTelemetry API 包。你的库不会自行导出遥测数据。只有当该库作为使用 OpenTelemetry SDK 的应用的一部分时，它才会导出遥测数据。有关如何对库进行插桩的更多信息，请参见
-[Libraries](/docs/concepts/instrumentation/libraries/)。
+如果你正在对一个库进行插桩，只需安装适合你语言的 OpenTelemetry API 包。你的库不会自行导出遥测数据。
+只有当该库作为使用 OpenTelemetry SDK 的应用的一部分时，它才会导出遥测数据。
+有关如何对库进行插桩的更多信息，请参见[插桩库](/docs/concepts/instrumentation/libraries/)。
 
-有关 OpenTelemetry API 和 SDK 的更多信息，请参见
-[specification](/docs/specs/otel/)。
+有关 OpenTelemetry API 和 SDK 的更多信息，请参见[规范](/docs/specs/otel/)。

content/zh/docs/languages/_includes/libraries-intro.md

@@ -0,0 +1,20 @@
+---
+default_lang_commit: 788277e362bc602b72a90aa9191f9c05c403458e
+---
+
+当你开发应用时，可能会使用第三方库和框架来加快开发进度。如果你随后使用 OpenTelemetry
+对应用进行插桩，你可能希望避免额外花时间为所用的第三方库和框架手动添加链路、日志和指标。
+
+许多库和框架已经原生支持 OpenTelemetry，或者通过 OpenTelemetry
+的[插桩](/docs/concepts/instrumentation/libraries/)获得支持，
+因此它们能够生成可导出到可观测性后端的遥测数据。
+
+如果你正在为使用第三方库或框架的应用或服务进行插桩，
+请按照以下说明学习如何为你的依赖项使用原生插桩库和插桩库。
+
+## 使用原生插桩库 {#use-natively-instrumented-libraries}
+
+如果某个库默认就支持 OpenTelemetry，你只需在应用中添加并配置 OpenTelemetry SDK，
+就可以获取该库发出的链路、指标和日志。
+
+该库可能需要一些额外的插桩配置。请查阅该库的文档以了解更多信息。

content/zh/docs/languages/_includes/native-lib-alert.md

@@ -0,0 +1,26 @@
+---
+default_lang_commit: 788277e362bc602b72a90aa9191f9c05c403458e
+---
+
+{{ if $noIntegrations }}
+
+{{% alert title="需要帮助！" color=secondary %}}
+
+截至目前，我们还不知道有任何 {{ $name }} 库已原生集成 OpenTelemetry。
+如果你知道这样的库，[请告诉我们][let us know]。
+
+{{% /alert %}}
+
+{{ end }}
+
+{{ if not $noIntegrations }}
+
+{{% alert color=info %}}
+
+如果你知道某个 {{ $name }} 库已原生集成了 OpenTelemetry，[请告诉我们][let us know]。
+
+{{% /alert %}}
+
+{{ end }}
+
+[let us know]: https://github.com/open-telemetry/opentelemetry.io/issues/new/choose

content/zh/docs/languages/_includes/propagation.md

@@ -0,0 +1,21 @@
+---
+default_lang_commit: 788277e362bc602b72a90aa9191f9c05c403458e
+---
+
+通过上下文传播，[信号](/docs/concepts/signals/)可以彼此关联，而不受其生成位置的限制。尽管上下文传播并不限于链路跟踪，
+但它允许[链路](/docs/concepts/signals/traces/)在跨越进程和网络边界的任意分布式服务之间构建系统的因果关系信息。
+
+在绝大多数用例中，原生支持 OpenTelemetry 的库或[插桩库](../libraries/)会自动为你在服务之间传播跟踪上下文。
+只有在极少数情况下，你才需要手动传播上下文。
+
+{{ if $lang }}
+
+要了解更多，请参阅[上下文传播](/docs/concepts/context-propagation)。
+
+{{ end }}
+
+{{ if not $lang }}
+
+要理解上下文传播，你需要先理解两个独立的概念：上下文和传播。
+
+{{ end }}

content/zh/docs/languages/_includes/span-status-preamble.md

@@ -2,7 +2,10 @@
 default_lang_commit: 2f850a610b5f7da5730265b32c25c9226dc09e5f
 ---
 
-可以在一个 [Span](/docs/concepts/signals/traces/#spans) 上设置一个 [Status](/docs/concepts/signals/traces/#span-status)，通常用于指明某个 Span 没有成功完成 —— 即标记为 `Error`。默认情况下，所有的 Span 状态都是 `Unset`，意味着该操作完成但未明确表示是否出错。
+可以在一个 [Span](/docs/concepts/signals/traces/#spans) 上设置一个
+[Status](/docs/concepts/signals/traces/#span-status)，通常用于指明某个
+Span 没有成功完成 —— 即标记为 `Error`。默认情况下，所有的 Span 状态都是
+`Unset`，意味着该操作完成但未明确表示是否出错。
 如果你想显式地标记某个操作是成功的，而不是依赖默认的 `Unset`，就可以使用 `Ok` 状态。
 
 状态可以在 Span 结束前的任何时候设置。