连接链接可观察性指南

步骤

1. 验证 OpenShift 集群中正确配置了用户工作负载监控，如下所示：

   kubectl get configmap cluster-monitoring-config -n openshift-monitoring -o jsonpath='{.data.config\.yaml}'|grep enableUserWorkload

   Copy to Clipboard Toggle word wrap

   预期的输出为 enableUserWorkload: true。

2. 安装连接链接、网关和 Grafana 组件指标和配置，如下所示：

   kubectl apply -k https://github.com/Kuadrant/kuadrant-operator/config/install/configure/observability?ref=v1.1.0

   Copy to Clipboard Toggle word wrap

3. 在 Kuadrant Operator 存储库的根目录中，将 OpenShift thanos-query 实例配置为 Grafana 中的数据源，如下所示：

   TOKEN="Bearer $(oc whoami -t)"
   HOST="$(kubectl -n openshift-monitoring get route thanos-querier -o jsonpath='https://{.status.ingress[].host}')"
   echo "TOKEN=$TOKEN" > config/observability/openshift/grafana/datasource.env
   echo "HOST=$HOST" >> config/observability/openshift/grafana/datasource.env
   kubectl apply -k config/observability/openshift/grafana

   Copy to Clipboard Toggle word wrap

4. 配置 Grafana 仪表板示例，如下所示：

   kubectl apply -k https://github.com/Kuadrant/kuadrant-operator/examples/dashboards?ref=v1.1.0

   Copy to Clipboard Toggle word wrap

步骤

1. 要为 Kuadrant 和任何网关启用可观察性，请在 Kuadrant 自定义资源的 observability 部分设置 enable: true，如下所示：

   apiVersion: kuadrant.io/v1beta1
   kind: Kuadrant
   metadata:
     name: kuadrant-sample
   spec:
     observability:
       enable: true

   Copy to Clipboard Toggle word wrap

   启用后，连接链接会为连接链接 Operator 命名空间中的组件创建 ServiceMonitor 和 PodMonitor。另外，还会在每个网关命名空间中创建一组监控器，用于从任何网关和对应的网关系统命名空间中提取指标，本例中为 istio-system 命名空间。

2. 检查创建的 monitor，如下所示：

   kubectl get servicemonitor,podmonitor -A -l kuadrant.io/observability=true

   Copy to Clipboard Toggle word wrap
   注意

   如果需要，您可以在创建 monitor 后对 monitor 进行更改。监控功能只会被创建或删除，且不会更新或恢复。如果您决定默认监控器不合适，您可以设置 enable: false 并创建自己的 ServiceMonitor 或 PodMonitor 定义，或者直接配置 Prometheus。

步骤

1. 通过配置 Telemetry 自定义资源在 OpenShift Service Mesh 中启用追踪，如下所示：

   apiVersion: telemetry.istio.io/v1alpha1
   kind: Telemetry
   metadata:
     name: mesh-default
     namespace: gateway-system
   spec:
     tracing:
     - providers:
       - name: tempo-otlp
       randomSamplingPercentage: 100

   Copy to Clipboard Toggle word wrap

2. 在 Istio 自定义资源中的 OpenShift Service Mesh 中配置追踪 扩展Provider，如下所示：

   apiVersion: operator.istio.io/v1alpha1
   kind: Istio
   metadata:
     name: default
   spec:
     namespace: gateway-system
     values:
       meshConfig:
         defaultConfig:
           tracing: {}
         enableTracing: true
         extensionProviders:
         - name: tempo-otlp
           opentelemetry:
             port: 4317
             service: tempo.tempo.svc.cluster.local

   Copy to Clipboard Toggle word wrap
   重要

   您必须在服务端口 名称或 appProtocol 字段中设置 OpenTelemetry 收集器协议，如 OpenShift Service Mesh 文档所述。例如，在使用 gRPC 时，端口名称应该以 grpc- 开头，或者 appProtocol 应该为 grpc。

3. 在 Authorino 自定义资源中启用请求追踪，并将身份验证和授权追踪发送到中央收集器，如下所示：

   apiVersion: operator.authorino.kuadrant.io/v1beta1
   kind: Authorino
   metadata:
     name: authorino
   spec:
     tracing:
       endpoint: rpc://tempo.tempo.svc.cluster.local:4317

   Copy to Clipboard Toggle word wrap

4. 在 Limitador 自定义资源中启用请求追踪，并将速率限制 trace 发送到中央收集器，如下所示：

   apiVersion: limitador.kuadrant.io/v1alpha1
   kind: Limitador
   metadata:
     name: limitador
   spec:
     tracing:
       endpoint: rpc://tempo.tempo.svc.cluster.local:4317

   Copy to Clipboard Toggle word wrap
   注意

   确保追踪收集器与 OpenShift Service Mesh 发送 trace 相同，以便稍后可以关联它们。

   应用更改后，将重新部署 Authorino 和 Limitador 组件，并启用了追踪。

   重要

   trace ID 目前没有传播到 OpenShift Service Mesh 中的 Wasm 模块。这意味着传递给 Limitador 的请求没有相关的父追踪 ID。但是，如果 trace 启动点不是 Service Mesh，则父追踪 ID 可用于限制并包含在 trace 中。这会影响到来自 Limitador 的 trace，以及来自 Authorino、网关以及请求路径中的任何其他组件。