OpenTelemetry 协议 (OTLP) 导出器

为度量配置 OpenTelemetry 协议 (OTLP) 导出器

启用和配置OpenTelemetry 协议 (OTLP)度量导出器，在GraphOS 路由器或Apollo 路由器核心中。

有关通用度量配置的信息，请参阅路由器度量配置。

使用 OTLP 协议，您可以将度量数据导出到任何兼容 OTLP 的接收器，包括

OTLP 配置

路由器可以配置为使用 OTLP 从 HTTP 或 gRPC 导出度量数据。

使用 OTLP 和 gRPC 的示例路由器配置：

router.yaml

1
telemetry:
2
  exporters:
3
    metrics:
4
      otlp:
5
        # Enable the OpenTelemetry exporter
6
        enabled: true
7
  
8
        # Optional endpoint, either 'default' or a URL (Defaults to http://127.0.0.1:4317 for gRPC and http://127.0.0.1:4318 for HTTP)
9
        endpoint: default
10
  
11
        # Optional protocol
12
        protocol: grpc
13
  
14
        # Optional gRPC configuration
15
        grpc:
16
          metadata:
17
            foo: bar
18
  
19
        # Optional batch_processor configuration
20
        batch_processor:
21
          scheduled_delay: 100ms
22
          max_concurrent_exports: 1000
23
          max_export_batch_size: 10000
24
          max_export_timeout: 100s
25
          max_queue_size: 10000

`已启用`

启用 OTLP 导出器的标志。

设置为 true 以启用 OTLP 导出器。默认为 false。

`端点`

OTLP 站点地址。

默认为

http://127.0.0.1:4317用于 gRPC
http://127.0.0.1:4318用于 HTTP

`grpc`

指定协议（gRPC）的特定设置，用于设置自定义 SSL 证书、域名和元数据。

1
telemetry:
2
  exporters:
3
    tracing:
4
      otlp:
5
        grpc:
6
          domain_name: "<my-domain>"
7
          key: "<key>"
8
          ca: "<certificate-authority>"
9
          cert: "<certificate>"
10
          metadata:
11
            key1: value1
12
            key2: value2

💡 提示

使用变量展开功能在 YAML 配置文件中引用环境变量和文件路径。使用 env. 和 file. 前缀，例如 ${file.ca.txt}。

查看 gRPC 认证了解更多信息。

gRPC 配置参考

属性	描述
`domain_name`	可选的域名
`key`	可选的密钥
`ca`	可选的证书颁发机构
`cert`	可选的证书
`metadata`	发送请求时要发送的标题映射

`http`

为设置自定义头部而特定的 HTTP 协议设置。

1
http:
2
  headers:
3
    key1: value1
4
    key2: value2

HTTP 配置参考

属性	描述
`headers`	发送请求时要发送的标题映射

`batch_processor`

所有导出器都支持使用 batch_processor 配置批量跨度处理器。

如果在您的日志中看到以下任何消息，则必须调整您的 batch_processor 配置：

OpenTelemetry 跟踪错误：无法将跨度发送到批量跨度处理器，因为通道已满
OpenTelemetry 指标错误：无法将跨度发送到批量跨度处理器，因为通道已满

具体的设置取决于您发送数据到您的应用程序性能监控（APM）的可用带宽以及您的 APM 的带宽配置。预计您将随着时间的推移调整这些设置，因为您的应用程序发生变化。

以下是一个使用 OTLP 和 batch_processor 的示例配置：

1
telemetry:
2
  exporters:
3
    metrics:
4
      otlp: 
5
        batch_processor: 
6
          max_export_batch_size: 512
7
          max_concurrent_exports: 1
8
          max_export_timeout: 30s 
9
          max_queue_size: 2048
10
          scheduled_delay: 5s

`batch_processor` 配置参考

属性	默认值	描述
`scheduled_delay`	5s	从收到第一个跨度到发送批次的秒数延迟。
`max_concurrent_exports`	1	重叠导出请求的最大数量。
`max_export_batch_size`	512	批处理中包含的跨度数量。可能受最大消息大小限制。
`max_export_timeout`	30s	发送跨度之前的超时时间（秒），发送前丢弃数据。
`max_queue_size`	2048	在丢弃跨度数据之前可以缓冲的最大跨度数量。

OTLP配置参考

属性	值	默认值	描述
`已启用`		`false`	启用OTLP导出器。
`protocol`	`grpc`\|`http`	`grpc`	要使用的协议。
`端点`		`http://127.0.0.1:4317`适用于gRPC和`http://127.0.0.1:4318`适用于HTTP	发送跨度所需的目标端点。
`grpc`			针对gRPC协议的特殊配置。
`http`			针对HTTP协议的特殊配置。
`temporality`	`delta`\|`cumulative`		请查阅您的APM文档了解应将此设置为什么。

New Relic

Prometheus