Skip to content

Commit 238bdef

Browse files
committed
[zh] Add docs/collector/
Signed-off-by: windsonsea <[email protected]>
1 parent b13d5dd commit 238bdef

File tree

2 files changed

+107
-0
lines changed

2 files changed

+107
-0
lines changed

content/zh/docs/collector/_index.md

Lines changed: 67 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,67 @@
1+
---
2+
title: Collector(收集器)
3+
description: 接收、处理和导出遥测数据不受厂商约束。
4+
aliases: [./about]
5+
cascade:
6+
vers: 0.128.0
7+
weight: 270
8+
default_lang_commit: b13d5dd3a9f288ab64d2af98c0b4ec1694499ef3
9+
---
10+
11+
![集成 Jaeger、OTLP 和 Prometheus 的 OpenTelemetry Collector 示意图](img/otel-collector.svg)
12+
13+
## 简介 {#introduction}
14+
15+
OpenTelemetry Collector 提供了一种与厂商无关的实现方式,用于接收、处理和导出遥测数据。
16+
它省去了运行、操作和维护多个代理/收集器的需要。这种方式具有更好的可扩展性,
17+
并支持开源可观测性数据格式(例如 Jaeger、Prometheus、Fluent Bit 等),可将数据发送到一个或多个开源或商业后端。
18+
19+
## 目标 {#objectives}
20+
21+
- **可用性**:合理的默认配置,支持主流协议,开箱即用地运行和采集数据。
22+
- **性能**:在不同负载和配置下都具有高度稳定性和高性能。
23+
- **可观测性**:作为可观测服务的典范。
24+
- **可扩展性**:可在不修改核心代码的前提下进行自定义。
25+
- **统一性**:统一代码库,既可作为代理也可作为收集器部署,支持链路、指标和日志。
26+
27+
## 何时使用 Collector {#when-to-use-a-collector}
28+
29+
对于大多数编程语言的特定插桩库来说,你已经拥有用于主流后端和 OTLP 的导出器。你可能会问:
30+
31+
> 在什么情况下应该使用 Collector 来发送数据,而不是让每个服务直接发送到后端?
32+
33+
在尝试或入门 OpenTelemetry 时,直接将数据发送到后端是快速获取价值的好方法。
34+
同样地,在开发或小规模环境中,即使不使用 Collector 也能获得不错的效果。
35+
36+
然而,通常我们建议你在服务旁边使用一个 Collector,因为它能让服务快速卸载数据,而
37+
Collector 可以处理如重试、批处理、加密甚至敏感数据过滤等额外操作。
38+
39+
实际上,[配置 Collector](quick-start) 比你想象的要简单:每种语言的默认
40+
OTLP 导出器都假定 Collector 在本地运行,因此只要你启动 Collector,它就会自动开始接收遥测数据。
41+
42+
## Collector 安全性 {#collector-security}
43+
44+
请遵循最佳实践,确保你的 Collector 被[安全托管][hosted][正确配置][configured]
45+
46+
## 状态 {#status}
47+
48+
**Collector** 的当前状态为:[混合][mixed],因为核心 Collector
49+
组件当前具有不同的[稳定性等级][stability levels]
50+
51+
**Collector 组件**的成熟度水平不同。每个组件的稳定性在其 `README.md` 文件中有说明。
52+
你可以在[组件镜像仓库][registry]中找到所有可用的 Collector 组件列表。
53+
54+
Collector 软件构件的支持在一段时间内有保障,具体取决于该构件的目标用户。
55+
这种支持至少包括关键 Bug 和安全问题的修复。
56+
更多细节参阅[支持策略](https://github.com/open-telemetry/opentelemetry-collector/blob/main/VERSIONING.md)
57+
58+
## 发行版与发布版本 {#releases}
59+
60+
有关 Collector 的[最新][latest release]发行版和发布信息,请参见[发行版页面](distributions/)
61+
62+
[configured]: /docs/security/config-best-practices/
63+
[hosted]: /docs/security/hosting-best-practices/
64+
[latest release]: https://github.com/open-telemetry/opentelemetry-collector-releases/releases/latest
65+
[mixed]: /docs/specs/otel/document-status/#mixed
66+
[registry]: /ecosystem/registry/?language=collector
67+
[stability levels]: https://github.com/open-telemetry/opentelemetry-collector#stability-levels
Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,40 @@
1+
---
2+
title: 发行版
3+
weight: 25
4+
default_lang_commit: b13d5dd3a9f288ab64d2af98c0b4ec1694499ef3
5+
---
6+
7+
OpenTelemetry 项目目前提供了 Collector 的预构建[发行版][distributions]
8+
每个发行版中包含的组件可以在该发行版的 `manifest.yaml` 文件中找到。
9+
10+
[distributions]: https://github.com/open-telemetry/opentelemetry-collector-releases/tree/main/distributions
11+
12+
{{% ecosystem/distributions-table filter="first-party-collector" %}}
13+
14+
## 自定义发行版 {#custom-distributions}
15+
16+
OpenTelemetry 项目提供的现有发行版可能无法满足你的需求。
17+
例如,你可能希望构建更小的二进制文件,或者需要实现自定义功能,
18+
[认证扩展](../building/authenticator-extension)
19+
[接收器](../building/receiver)、处理器、导出器或[连接器](../building/connector)
20+
你可以使用构建发行版的工具
21+
[ocb](../custom-collector)(OpenTelemetry Collector Builder)来自行构建发行版。
22+
23+
## 第三方发行版 {#third-party-distributions}
24+
25+
一些组织提供了具有额外功能或使用体验更佳的 Collector
26+
发行版。以下列出了由第三方维护的 Collector 发行版。
27+
28+
{{% ecosystem/distributions-table filter="third-party-collector" %}}
29+
30+
## 添加你的 Collector 发行版 {#how-to-add}
31+
32+
如需将你的 Collector 发行版列入上述列表,请[提交一个 PR][submit a PR]
33+
[发行版列表][distributions list] 中添加一个条目。该条目应包含以下内容:
34+
35+
- 指向你的发行版主页的链接
36+
- 指向说明如何使用该发行版的文档的链接
37+
- GitHub 账号或电子邮箱地址,作为联系方式,以便我们在有问题时与你联系
38+
39+
[submit a PR]: /docs/contributing/pull-requests/
40+
[distributions list]: https://github.com/open-telemetry/opentelemetry.io/tree/main/data/ecosystem/distributions.yaml

0 commit comments

Comments
 (0)