2.90. Observability 服务
Camel Observability 服务
2.90.1. 什么是内部 复制链接链接已复制到粘贴板!
有关用法和配置详情,请参阅上述链接。
2.90.2. Maven 协调 复制链接链接已复制到粘贴板!
在 code.quarkus.redhat.com 上使用此扩展创建新项目
或者将协调添加到现有项目中:
<dependency>
<groupId>org.apache.camel.quarkus</groupId>
<artifactId>camel-quarkus-observability-services</artifactId>
</dependency>
<dependency>
<groupId>org.apache.camel.quarkus</groupId>
<artifactId>camel-quarkus-observability-services</artifactId>
</dependency>
2.90.3. 使用方法 复制链接链接已复制到粘贴板!
此扩展提供了一组建议组件和配置,以简化云环境上的可观察性等操作。虽然扩展主要针对云,但它可用于任何其他环境。
通过在应用程序中添加 camel-quarkus-observability-services 扩展,每个可观察组件(如下所述)将配置为使用其单独的默认设置。不需要额外的配置。
默认情况下,HTTP 端点将在上下文路径 /observe/<service> 下公开。有关此问题的更多详细信息,如下所述。
如果您需要自定义此扩展提供的任何组件,您可以在 application.properties 中指定任何相关的配置选项,因为它在使用各个组件扩展时通常会完成。
2.90.4. 组件 复制链接链接已复制到粘贴板!
此扩展会自动提供以下 Camel Quarkus 组件扩展:
- Camel Quarkus MicroProfile Health - 用于健康检查
- Camel Quarkus Management - for JMX
- Camel Quarkus Micrometer - 用于 Camel Micrometer 指标
- Camel Quarkus OpenTelemetry - 用于追踪 Camel 消息(events/spans)
- Quarkus Micrometer Registry Prometheus - 以 Prometheus 格式导出指标
2.90.4.1. 已知端点列表 复制链接链接已复制到粘贴板!
此扩展存在将公开以下端点:
| 端点 | 描述 |
|---|---|
|
| 应用程序中的所有健康检查程序累积 |
|
| 存活度探测端点 |
|
| 就绪度探测端点 |
|
| 应用程序已启动探测端点 |
|
| 从 Micrometer Prometheus registry 公开的指标 |
您可以将端点配置为通常在每个扩展配置中正常工作。
2.90.5. OpenTelemetry 配置 复制链接链接已复制到粘贴板!
此扩展存在将提供所需的检测来启用 OpenTelemetry 指标集合。Camel Quarkus OpenTelemetry 扩展会检测应用程序,并定期尝试将 trace 导出到配置的收集器。默认情况下禁用此设置,以防止应用程序在没有遥测服务器可用时导出 trace。
要启用检测,您需要将以下配置添加到 application.properties 中。
quarkus.otel.sdk.disabled=false
quarkus.otel.sdk.disabled=false
要配置 OpenTelemetry 的任何方面,您可以在 application.properties 中添加以下配置。例如,要自定义应导出 trace 的服务器端点(默认为 http://localhost:4317)。
quarkus.otel.exporter.otlp.traces.endpoint=http://my-otel-collector.svc:4317
quarkus.otel.exporter.otlp.traces.endpoint=http://my-otel-collector.svc:4317
完整的配置选项集合记录在 Camel Quarkus OpenTelemetry 和 Quarkus OpenTelemetry 文档中。
Quarkus trace 导出默认为端口 4317 上的 gRPC 协议。
2.90.6. JMX 配置 复制链接链接已复制到粘贴板!
此扩展存在意味着存在 camel-quarkus-management 扩展。这会公开 Camel JMX MBeans,以提供对正在运行的应用程序的深入了解和管理。
如果要禁用 Camel JMX 检测,您可以将以下配置添加到 application.properties 中。
camel.main.jmxEnabled=false
camel.main.jmxEnabled=false
完整的配置选项集合记录在 Camel Quarkus 管理文档中。