配置 Beyla 服务发现

executable_name、open_port、service_name 和 service_namespace 是顶级属性，用于简化 Beyla 配置，以便对单个服务或一组相关服务进行代码注入。

在某些场景下，Beyla 将对多种服务进行代码注入；例如，作为 Kubernetes DaemonSet 对节点上的所有服务进行代码注入。discovery YAML 部分允许您在 Beyla 可以注入的服务中指定更高的区分度。

例如，它允许按服务类型覆盖服务名称和命名空间。

YAML	环境变量	类型	默认值
`services`	N/A	对象列表	（未设置）

本节允许为不同的服务指定不同的选择条件，并覆盖其部分元数据，例如报告的名称或命名空间。

有关本节的更多详细信息，请参阅本文档的服务发现部分。

YAML	环境变量	类型	默认值
`exclude_services`	N/A	对象列表	（未设置）

本节允许指定排除无需进行代码注入的服务的选择标准。其定义格式与本文档的服务发现部分中所述相同。

此选项有助于避免对通常在可观测性环境中找到的服务进行代码注入。例如，使用此选项排除对 Prometheus 的代码注入。

YAML	环境变量	类型	默认值
`default_exclude_services`	N/A	对象列表	路径：`(?:^\|\/)(beyla$\|alloy$\|otelcol[^\/]*$)`

禁用 Beyla 本身（自注入）以及 Grafana Alloy 和 OpenTelemetry Collector 的代码注入。设为空以允许 Beyla 对自身以及这些其他组件进行代码注入。注意：要启用此类自注入，仍然需要将它们包含在 services 部分中。

YAML	环境变量	类型	默认值
`skip_go_specific_tracers`	`BEYLA_SKIP_GO_SPECIFIC_TRACERS`	布尔值	false

禁用 ebpf tracer 在检查要进行代码注入的可执行文件时对 Go 特性的检测。tracer 将回退到使用通用代码注入，这通常效率较低。

YAML	环境变量	类型	默认值
`exclude_otel_instrumented_services`	`BEYLA_EXCLUDE_OTEL_INSTRUMENTED_SERVICES`	布尔值	true

禁用 Beyla 对已通过 OpenTelemetry 进行代码注入的服务的代码注入。由于 Beyla 通常部署用于监控 Kubernetes 集群中的所有服务，监控已进行代码注入的服务可能会导致重复的遥测数据，除非代码注入选择（或排除）标准经过精心设计。为了避免不必要的配置开销，Beyla 会监控 OpenTelemetry SDK 调用以发布指标和追踪，并自动关闭对发布自身遥测数据的服务的代码注入。如果您应用程序生成的遥测数据与 Beyla 生成的指标和追踪不冲突，请关闭此选项。

服务发现部分

允许选择多组服务的 YAML 文件示例

discovery:
  services:
    - exe_path: (worker)|(backend)|(frontend)
      namespace: MyApplication
    - exe_path: loadgen
      namespace: testing
      name: "TestLoadGenerator"

上述 YAML 示例将选择两组可执行文件。第一组将由可执行路径包含 worker、backend 或 frontend 文本的任何进程组成。对于每个服务，Beyla 将从可执行文件名称中获取服务名称属性。与此组匹配的所有进程报告的服务命名空间将是 MyApplication。

上述 YAML 示例中的第二组将选择可执行路径包含 regexp 的任何可执行文件，但不是从可执行文件名称中获取服务名称，而是将服务名称覆盖为 TestLoadGenerator。

本节的其余部分描述了 services 列表中的每个条目接受的属性。

每个 services 条目都是一个映射，其中的属性可以根据两个目的进行分组

覆盖报告的服务名称和命名空间：name 和 namespace 属性。
选择要进行代码注入的进程：其余属性，在本文档中称为选择器。

YAML	环境变量	类型	默认值
`name`	–	string	（参见描述）

已废弃

为匹配的已注入服务定义名称。它将用于在导出的指标/追踪中填充 service.name OTEL 属性和 service_name Prometheus 属性。

此选项已废弃，因为同一个 services 条目中的多个匹配项会导致多个服务共享同一个名称。请参阅覆盖服务名称和命名空间部分，以启用从多种元数据源自动配置服务名称和命名空间。

如果属性未设置，则会默认采用以下任何属性，优先级如下

如果 Kubernetes 已启用
1. 运行已注入进程的 Deployment 名称（如果存在）。
2. 运行已注入进程的 ReplicaSet/DaemonSet/StatefulSet 名称（如果存在）。
3. 运行已注入进程的 Pod 名称。
如果 Kubernetes 未启用
1. 进程可执行文件的名称。

如果多个进程匹配下面描述的服务选择标准，则所有实例的指标和追踪可能共享相同的服务名称；例如，当多个已注入进程在同一个 Deployment 下运行，或具有相同的可执行文件名称时。在这种情况下，报告的 instance 属性将允许区分服务的不同实例。

YAML	环境变量	类型	默认值
`namespace`	–	string	（空或 K8s 命名空间）

已废弃.

为匹配的已注入服务定义命名空间。如果未设置此属性，则如果 Kubernetes 可用，它将默认为运行已注入进程的 Kubernetes 命名空间；如果 Kubernetes 不可用，则为空。

此选项已废弃。请参阅覆盖服务名称和命名空间部分，以启用从多种元数据源自动配置服务名称和命名空间。

需要注意的是，此命名空间不是 Kubernetes 命名空间的选择器。它的值将用于设置标准遥测属性的值。例如，OpenTelemetry service.namespace 属性。

YAML	环境变量	类型	默认值
`open_ports`	–	string	（未设置）

根据进程开放（监听）的端口选择要进行代码注入的进程。此属性接受以逗号分隔的端口列表（例如，80）和端口范围（例如，8000-8999）。如果可执行文件匹配列表中的任一端口，则被视为匹配选择标准。

例如，指定以下属性

open_port: 80,443,8000-8999

将使 Beyla 选择任何打开端口 80、443 或 8000 到 8999 之间（包括）任何端口的可执行文件。