#使用 Ceph RGW Exporter 监控 Ceph RGW

#安装 Operator

1. 转到 Administrator。

2. 在左侧导航栏中，单击 Marketplace > OperatorHub。

3. 找到 Alauda Storage Exporter，然后单击 Install。选择 alpha channel，将其安装到 rook-ceph 命名空间（Rook-Ceph 运行所在的命名空间），并将升级审批设置为 Manual。有关安装对话框的详细说明，请参阅 Operator。

   或者，也可以在集群的 control plane node 上从命令行应用 Subscription。rook-ceph 命名空间中已包含由 Rook-Ceph 创建的 OperatorGroup，因此无需创建新的资源。

   cat << EOF | kubectl apply -f -
   apiVersion: operators.coreos.com/v1alpha1
   kind: Subscription
   metadata:
     name: ceph-rgw-exporter
     namespace: rook-ceph
   spec:
     channel: alpha
     installPlanApproval: Manual
     name: ceph-rgw-exporter
     source: platform
     sourceNamespace: cpaas-system
   EOF

   审批生成的 InstallPlan：

   ip=$(kubectl -n rook-ceph get subscription ceph-rgw-exporter -o jsonpath='{.status.installPlanRef.name}')
   kubectl -n rook-ceph patch installplan $ip --type=merge -p '{"spec":{"approved":true}}'

4. 验证 Operator 正在运行。

   kubectl -n rook-ceph get csv | grep ceph-rgw-exporter
   kubectl -n rook-ceph get deploy ceph-rgw-exporter-operator

   预期输出：

   ceph-rgw-exporter.v1.0.3   Alauda Build of Ceph RGW Exporter   1.0.3   Succeeded
   NAME                         READY   UP-TO-DATE   AVAILABLE   AGE
   ceph-rgw-exporter-operator   1/1     1            1           3m

#验证自动发现的 exporter

Operator 启动后约一分钟内，每个 CephObjectStore 都会有一个 exporter。

1. 列出 exporter。

   kubectl -n rook-ceph get cephrgwexporters

   预期输出（此示例中的 ceph-cluster-object 是对象存储名称）：

   NAME                               PHASE     READY   ENDPOINT                                                      AGE
   rgw-exporter-ceph-cluster-object   Running   1       http://rook-ceph-rgw-ceph-cluster-object.rook-ceph.svc:7480   2m

   exporter Pod 启动期间，PHASE 为 Pending；Pod 就绪后为 Running；如果无法解析所引用的 CephObjectStoreUser 或其 Secret，则为 Failed。详细信息会记录在 status.conditions 中。

2. 确认已为 exporter 配置的只读 RGW 用户。

   kubectl -n rook-ceph get cephobjectstoreuser rgw-exporter-user-ceph-cluster-object -o jsonpath='{.spec.capabilities}{"\n"}{.status.phase}{"\n"}'

   预期输出：

   {"bucket":"read","metadata":"read","usage":"read","user":"read"}
   Ready

3. 确认子资源。

   kubectl -n rook-ceph get deploy,svc,servicemonitor -l app.kubernetes.io/name=ceph-rgw-exporter

#验证指标

1. 将 exporter Service 转发到本地端口，并请求指标端点。

   kubectl -n rook-ceph port-forward svc/rgw-exporter-ceph-cluster-object 9242:9242 &
   curl -s http://localhost:9242/-/ready
   curl -s http://localhost:9242/metrics | grep -v '^#' | head

   预期输出：

   ok
   radosgw_usage_ops_total{bucket="bucket_root",category="list_buckets",owner="anonymous",store="ceph-cluster-object"} 142126
   radosgw_usage_scrape_duration_seconds 0.271208467
   radosgw_usage_user_quota_enabled{store="ceph-cluster-object",user="rgw-exporter-user-ceph-cluster-object"} 0
   radosgw_usage_user_total_bytes{store="ceph-cluster-object",user="rgw-exporter-user-ceph-cluster-object"} 0
   ...

   只有对象存储中至少存在一个存储桶后，存储桶指标（radosgw_usage_bucket_*）才会显示。

2. 如果已安装监控插件，ServiceMonitor 会被自动发现：它带有 prometheus: kube-prometheus 标签，平台使用该标签选择抓取目标，并且默认每隔 300s 抓取 http-metrics 端口。经过一个抓取间隔后，在平台的监控面板中或通过 PromQL 查询 radosgw_usage_scrape_duration_seconds，以确认数据已被摄取。有关如何使用自定义指标，请参阅 Management of Metrics。