5.26. OADP のトラブルシューティング

手順

1. ブラウザーを開き、Velero Web サイト上の "Install the CLI" に移動します。
2. macOS、GitHub、または Windows の適切な手順に従います。
3. 使用している OADP および OpenShift Container Platform のバージョンに適切な Velero バージョンをダウンロードします。

手順

1. YAML ファイルで cpu および memory リソース要求を設定します。

   nodeAgent.yaml ファイルの例

   apiVersion: oadp.openshift.io/v1alpha1
   kind: DataProtectionApplication
   metadata:
     name: ts-dpa
   spec:
     backupLocations:
     - velero:
         default: true
         objectStorage:
           bucket: oadp.....njph
           prefix: velero
         credential:
           key: cloud
           name: cloud-credentials-gcp
         provider: gcp
     configuration:
       velero:
         defaultPlugins:
         - gcp
         - openshift
         - csi
       nodeAgent:
         enable: true
         uploaderType: kopia
         podConfig:
           resourceAllocations: 

   1

   
             requests:
               cpu: 1000m
               memory: 16Gi 

   2

   Copy to Clipboard Toggle word wrap

   1

   ここに示されているリソース割り当ての例は、平均的な使用状況を想定したものです。

   2

   インフラストラクチャーや使用状況に応じて、このパラメーターを変更できます。

2. 次のコマンドを実行して DPA CR を作成します。

   $ oc create -f nodeAgent.yaml

   Copy to Clipboard Toggle word wrap

検証

1. 次のコマンドを使用して、nodeAgent Pod が実行されていることを確認します。

   $ oc get pods

   Copy to Clipboard Toggle word wrap

   出力例

   NAME                                                        READY   STATUS      RESTARTS   AGE
   node-agent-hbj9l                                            1/1     Running     0          97s
   node-agent-wmwgz                                            1/1     Running     0          95s
   node-agent-zvc7k                                            1/1     Running     0          98s
   openshift-adp-controller-manager-7f9db86d96-4lhgq           1/1     Running     0          137m
   velero-7b6c7fb8d7-ppc8m                                     1/1     Running     0          4m2s

   Copy to Clipboard Toggle word wrap

2. nodeAgent Pod のいずれかを記述して、リソース要求を確認します。

   $ oc describe pod node-agent-hbj9l | grep -C 5 Requests

   Copy to Clipboard Toggle word wrap

   出力例

         --log-format=text
       State:          Running
         Started:      Mon, 09 Jun 2025 16:22:15 +0530
       Ready:          True
       Restart Count:  0
       Requests:
         cpu:     1
         memory:  1Gi
       Environment:
         NODE_NAME:            (v1:spec.nodeName)
         VELERO_NAMESPACE:    openshift-adp (v1:metadata.namespace)

   Copy to Clipboard Toggle word wrap

手順

1. 次のコマンドを入力/実行して、クラスター内に kind: MutatingWebhookConfiguration の Mutating アドミッションプラグインがあるかどうかを確認します。

   $ oc get mutatingwebhookconfigurations

   Copy to Clipboard Toggle word wrap
2. 各 kind: MutatingWebhookConfiguration の YAML ファイルを調べて、問題が発生しているオブジェクトの作成をブロックするルールがないことを確認します。詳細は、Kubernetes の公式ドキュメント を参照してください。
3. バックアップ時に使用される type: Configuration.appconnect.ibm.com/v1beta1 の spec.version が、インストールされている Operator のサポート対象であることを確認してください。

手順

1. 次のコマンドを使用して、カスタムの BSL に適切なラベルを付けます。

   $ oc label backupstoragelocations.velero.io <bsl_name> app.kubernetes.io/component=bsl

   Copy to Clipboard Toggle word wrap

2. BSL にラベルを付けた後、DPA がリコンサイルされるまで待ちます。

   注記

   DPA 自体に軽微な変更を加えることで、強制的に調整を行うことができます。

手順

1. OpenShift または Velero コマンドラインインターフェイス (CLI) を使用して、BSL のリストを取得します。

   1. OpenShift CLI (oc) を使用して BSL のリストを取得します。

      $ oc get backupstoragelocations.velero.io -A

      Copy to Clipboard Toggle word wrap

   2. velero CLI を使用して BSL のリストを取得します。

      $ velero backup-location get -n <oadp_operator_namespace>

      Copy to Clipboard Toggle word wrap

2. 前のステップの BSL のリストを使用して、次のコマンドを実行し、各 BSL のマニフェストにエラーがないか調べます。

   $ oc get backupstoragelocations.velero.io -n <namespace> -o yaml

   Copy to Clipboard Toggle word wrap

   結果の例:

   apiVersion: v1
   items:
   - apiVersion: velero.io/v1
     kind: BackupStorageLocation
     metadata:
       creationTimestamp: "2023-11-03T19:49:04Z"
       generation: 9703
       name: example-dpa-1
       namespace: openshift-adp-operator
       ownerReferences:
       - apiVersion: oadp.openshift.io/v1alpha1
         blockOwnerDeletion: true
         controller: true
         kind: DataProtectionApplication
         name: example-dpa
         uid: 0beeeaff-0287-4f32-bcb1-2e3c921b6e82
       resourceVersion: "24273698"
       uid: ba37cd15-cf17-4f7d-bf03-8af8655cea83
     spec:
       config:
         enableSharedConfig: "true"
         region: us-west-2
       credential:
         key: credentials
         name: cloud-credentials
       default: true
       objectStorage:
         bucket: example-oadp-operator
         prefix: example
       provider: aws
     status:
       lastValidationTime: "2023-11-10T22:06:46Z"
       message: "BackupStorageLocation \"example-dpa-1\" is unavailable: rpc
         error: code = Unknown desc = WebIdentityErr: failed to retrieve credentials\ncaused
         by: AccessDenied: Not authorized to perform sts:AssumeRoleWithWebIdentity\n\tstatus
         code: 403, request id: d3f2e099-70a0-467b-997e-ff62345e3b54"
       phase: Unavailable
   kind: List
   metadata:
     resourceVersion: ""

   Copy to Clipboard Toggle word wrap

手順

1. DataProtectionApplication マニフェストの spec.snapshotLocations.velero.config.region キーの値を編集して、スナップショットの場所が PV と同じリージョンにあるようにします。
2. 新しい Backup CR を作成します。

手順

1. 次のコマンドを実行して、Backup CR の詳細を取得します。

   $ oc -n {namespace} exec deployment/velero -c velero -- ./velero \
     backup describe <backup>

   Copy to Clipboard Toggle word wrap

2. 次のコマンドを実行して、Backup CR を削除します。

   $ oc delete backups.velero.io <backup> -n openshift-adp

   Copy to Clipboard Toggle word wrap

   進行中の Backup CR によるオブジェクトストレージへのファイルアップロードは完了していないため、バックアップの場所をクリーンアップする必要はありません。

3. 新しい Backup CR を作成します。

4. 次のコマンドを実行して、Velero バックアップの詳細を表示します。

   $ velero backup describe <backup_name> --details

   Copy to Clipboard Toggle word wrap

手順

1. 次のコマンドを実行して Backup CR を削除します。

   $ oc delete backups.velero.io <backup> -n openshift-adp

   Copy to Clipboard Toggle word wrap
2. 必要に応じて、BackupStorageLocation リソースに保存されているデータをクリーンアップして、領域を解放します。

3. 次のコマンドを実行して、velero.io/csi-volumesnapshot-class=true ラベルを VolumeSnapshotClass オブジェクトに適用します。

   $ oc label volumesnapshotclass/<snapclass_name> velero.io/csi-volumesnapshot-class=true

   Copy to Clipboard Toggle word wrap
4. 新しい Backup CR を作成します。

手順

1. NFS データボリューム上に Restic の補足グループを作成します。
2. NFS ディレクトリーに setgid ビットを設定して、グループの所有権が継承されるようにします。

3. spec.configuration.nodeAgent.supplementalGroups パラメーターとグループ ID を DataProtectionApplication マニフェストに追加します。次に例を示します。

   apiVersion: oadp.openshift.io/v1alpha1
   kind: DataProtectionApplication
   # ...
   spec:
     configuration:
       nodeAgent:
         enable: true
         uploaderType: restic
         supplementalGroups:
         - <group_id> 

   1

   
   # ...

   Copy to Clipboard Toggle word wrap

   1

   補助グループ ID を指定します。

4. Restic Pod が再起動し、変更が適用されるまで待機します。

手順

1. DPA カスタムリソース (CR) で、Velero サーバーの restore-resource-priorities フィールドを確認または設定して、securitycontextconstraints がリソースのリストの pods の前に順番にリストされていることを確認します。

   $ oc get dpa -o yaml

   Copy to Clipboard Toggle word wrap

   DPA CR の例

   # ...
   configuration:
     restic:
       enable: true
     velero:
       args:
         restore-resource-priorities: 'securitycontextconstraints,customresourcedefinitions,namespaces,storageclasses,volumesnapshotclass.snapshot.storage.k8s.io,volumesnapshotcontents.snapshot.storage.k8s.io,volumesnapshots.snapshot.storage.k8s.io,datauploads.velero.io,persistentvolumes,persistentvolumeclaims,serviceaccounts,secrets,configmaps,limitranges,pods,replicasets.apps,clusterclasses.cluster.x-k8s.io,endpoints,services,-,clusterbootstraps.run.tanzu.vmware.com,clusters.cluster.x-k8s.io,clusterresourcesets.addons.cluster.x-k8s.io' 

   1

   
       defaultPlugins:
       - gcp
       - openshift

   Copy to Clipboard Toggle word wrap

   1

   既存のリストアリソース優先順位リストがある場合は、その既存のリストを完全なリストと組み合わせてください。

2. デプロイメントの警告が発生しないように、Fixing PodSecurity Admission warnings for deployments で説明されているように、アプリケーション Pod のセキュリティー標準が調整されていることを確認します。アプリケーションがセキュリティー標準に準拠していない場合は、SCC に関係なくエラーが発生する可能性があります。 

手順

1. 例に示すように、DPT CR のマニフェストファイルを作成します。

   apiVersion: oadp.openshift.io/v1alpha1
   kind: DataProtectionTest
   metadata:
     name: dpt-sample
     namespace: openshift-adp
   spec:
     backupLocationName: <bsl_name> 

   1

   
     csiVolumeSnapshotTestConfigs: 

   2

   
     - snapshotClassName: csi-gce-pd-vsc
       timeout: 90s
       volumeSnapshotSource:
         persistentVolumeClaimName: <pvc1_name> 

   3

   
         persistentVolumeClaimNamespace: <pvc_namespace> 

   4

   
     - snapshotClassName: csi-gce-pd-vsc
       timeout: 120s
       volumeSnapshotSource:
         persistentVolumeClaimName: <pvc2_name> 

   5

   
         persistentVolumeClaimNamespace: <pvc_namespace>
     forceRun: false 

   6

   
     uploadSpeedTestConfig: 

   7

   
       fileSize: 200MB
       timeout: 120s

   Copy to Clipboard Toggle word wrap

   1

   BSL の名前を指定します。

   2

   csiVolumeSnapshotTestConfigs のリストを指定します。この例では、2 つの PVC がテストされています。

   3

   最初の PVC の名前を指定します。

   4

   PVC の namespace を指定します。

   5

   2 番目の PVC の名前を指定します。

   6

   OADP コントローラーがテストの再実行をスキップするようにする場合は forceRun フラグを false に設定します。

   7

   fileSize と timeout のフィールドを設定して、uploadSpeedTestConfig オブジェクトを設定します。

2. 次のコマンドを実行して DPT CR を作成します。

   $ oc create -f <dpt_file_name> 

   1

   Copy to Clipboard Toggle word wrap

   1

   DPT マニフェストのファイル名を指定します。

検証

1. 次のコマンドを実行して、DPT CR のフェーズが Complete であることを確認します。

   $ oc get dpt dpt-sample

   Copy to Clipboard Toggle word wrap

   出力例は次のとおりです。

   NAME         PHASE      LASTTESTED   UPLOADSPEED(MBPS)   ENCRYPTION   VERSIONING   SNAPSHOTS    AGE
   dpt-sample   Complete   17m          546                 AES256       Enabled      2/2 passed   17m

   Copy to Clipboard Toggle word wrap

2. 次のコマンドを実行して、CSI スナップショットが準備され、データアップロードテストが成功したことを確認します。

   $ oc get dpt dpt-sample -o yaml

   Copy to Clipboard Toggle word wrap

   出力例は次のとおりです。

   apiVersion: oadp.openshift.io/v1alpha1
   kind: DataProtectionTest
   ....
   status:
     bucketMetadata: 

   1

   
       encryptionAlgorithm: AES256
       versioningStatus: Enabled
     lastTested: "202...:47:51Z"
     phase: Complete
     s3Vendor: AWS 

   2

   
     snapshotSummary: 2/2 passed 

   3

   
     snapshotTests:
     - persistentVolumeClaimName: mysql-data
       persistentVolumeClaimNamespace: ocp-mysql
       readyDuration: 24s
       status: Ready
     - persistentVolumeClaimName: mysql-data1
       persistentVolumeClaimNamespace: ocp-mysql
       readyDuration: 40s
       status: Ready
     uploadTest: 

   4

   
       duration: 3.071s
       speedMbps: 546
       success: true

   Copy to Clipboard Toggle word wrap

   1

   バケットのメタデータ情報。

   2

   S3 バケットベンダー。

   3

   CSI スナップショットテストの概要。

   4

   アップロードテストの詳細。

手順

1. 例に示すように、DPT CR のマニフェストファイルを作成します。

   apiVersion: oadp.openshift.io/v1alpha1
   kind: DataProtectionTest
   metadata:
     name: dpt-sample
     namespace: openshift-adp
   spec:
     backupLocationSpec: 

   1

   
       provider: aws
       default: true
       objectStorage:
         bucket: sample-bucket 

   2

   
         prefix: velero
       config:
         region: us-east-1 

   3

   
         profile: "default"
         insecureSkipTLSVerify: "true"
         s3Url: "https://s3.amazonaws.com/sample-bucket"
       credential: 

   4

   
         name: cloud-credentials
         key: cloud
     uploadSpeedTestConfig: 

   5

   
       fileSize: 50MB
       timeout: 120s
     csiVolumeSnapshotTestConfigs: 

   6

   
       - volumeSnapshotSource:
           persistentVolumeClaimName: mongo
           persistentVolumeClaimNamespace: mongo-persistent
         snapshotClassName: csi-snapclass
         timeout: 2m
     forceRun: true
     skipTLSVerify: true 

   7

   Copy to Clipboard Toggle word wrap

   1

   クラウドプロバイダーなどの詳細を指定して、BSL 仕様を設定します。

   2

   バケット名を指定します。この例では、バケット名は sample-bucket です。

   3

   クラウドプロバイダーのリージョンを指定します。

   4

   ストレージバケットのクラウド認証情報を指定します。

   5

   (オプション) fileSize と timeout フィールドを指定して、uploadSpeedTestConfig オブジェクトを設定します。

   6

   csiVolumeSnapshotTestConfigs オブジェクトを設定します。

   7

   DPT CR 実行中に TLS 証明書の検証をスキップするには、true に設定します。

2. 次のコマンドを実行して DPT CR を作成します。

   $ oc create -f <dpt_file_name> 

   1

   Copy to Clipboard Toggle word wrap

   1

   DPT マニフェストのファイル名を指定します。

検証

1. 次のコマンドを実行して、DPT CR のフェーズが Complete であることを確認します。

   $ oc get dpt dpt-sample

   Copy to Clipboard Toggle word wrap

   出力例は次のとおりです。

   NAME         PHASE      LASTTESTED   UPLOADSPEED(MBPS)   ENCRYPTION   VERSIONING   SNAPSHOTS    AGE
   dpt-sample   Complete   17m          546                 AES256       Enabled      2/2 passed   17m

   Copy to Clipboard Toggle word wrap

手順

1. DPT 実行の失敗を回避するには、Azure storageAccount オブジェクトに Storage Blob Data Contributor ロールを追加します。以下のコマンドを実行します。

   $ az role assignment create \
   --assignee "$AZURE_CLIENT_ID" \
   --role "Storage Blob Data Contributor" \
   --scope "/subscriptions/$AZURE_SUBSCRIPTION_ID/resourceGroups/$AZURE_RESOURCE_GROUP/providers/Microsoft.Storage/storageAccounts/$AZURE_STORAGE_ACCOUNT_ID"

   Copy to Clipboard Toggle word wrap

2. ターミナルで、Azure パラメーターをエクスポートし、次の例に示すようにパラメーターを含むシークレット認証情報ファイルを作成します。

   Azure で DPT CR を実行するには、シークレット認証情報ファイルで STORAGE_ACCOUNT_ID パラメーターを指定する必要があります。

   AZURE_SUBSCRIPTION_ID=<subscription-id>
   AZURE_TENANT_ID=<tenant-id>
   AZURE_CLIENT_ID=<client-id>
   AZURE_CLIENT_SECRET=<client-secret>
   AZURE_RESOURCE_GROUP=<resource-group>
   AZURE_STORAGE_ACCOUNT_ID=<storage-account>

   Copy to Clipboard Toggle word wrap

3. 次の例に示すように、Secret CR を作成します。

   $ oc create secret generic cloud-credentials-azure -n openshift-adp --from-file cloud=<credentials_file_path>

   Copy to Clipboard Toggle word wrap

4. 次の例に示す設定を使用して、DataProtectionApplication (DPA) CR を作成します。

   apiVersion: oadp.openshift.io/v1alpha1
   kind: DataProtectionApplication
   metadata:
     name: ts-dpa
     namespace: openshift-adp
   spec:
     configuration:
       velero:
         defaultPlugins:
           - azure
           - openshift
     backupLocations:
       - velero:
           config:
             resourceGroup: oadp-....-b7q4-rg
             storageAccount: oadp...kb7q4
             subscriptionId: 53b8f5...fd54c8a
           credential:
             key: cloud
             name: cloud-credentials-azure 

   1

   
           provider: azure
           default: true
           objectStorage:
             bucket: <bucket_name>
             prefix: velero

   Copy to Clipboard Toggle word wrap

   1

   Secret オブジェクトの名前を指定します。この例では、名前は cloud-credentials-azure です。

5. 次の例に示すように、バックアップストレージの場所 (BSL) の名前、VolumeSnapshotClass オブジェクト、および永続ボリューム要求の詳細を指定して、DPT CR を作成します。

   apiVersion: oadp.openshift.io/v1alpha1
   kind: DataProtectionTest
   metadata:
     name: dpt-sample
     namespace: openshift-adp
   spec:
     backupLocationName: <bsl_name> 

   1

   
     uploadSpeedTestConfig:
       fileSize: 40MB
       timeout: 120s
     csiVolumeSnapshotTestConfigs:
       - snapshotClassName: csi-azuredisk-vsc 

   2

   
         timeout: 90s
         volumeSnapshotSource:
           persistentVolumeClaimName: mysql-data 

   3

   
           persistentVolumeClaimNamespace: ocp-mysql 

   4

   
       - snapshotClassName: csi-azuredisk-vsc
         timeout: 120s
         volumeSnapshotSource:
           persistentVolumeClaimName: mysql-data1
           persistentVolumeClaimNamespace: ocp-mysql

   Copy to Clipboard Toggle word wrap

   1

   BSL の名前を指定します。

   2

   Azure スナップショットクラス名。

   3

   永続ボリューム要求の名前。

   4

   永続ボリューム要求 namespace の名前。

6. DPT CR を実行して、スナップショットの準備状況を確認します。

手順

1. must-gather データを保存するディレクトリーに移動します。

2. 次のデータ収集オプションのいずれかに対して、oc adm must-gather コマンドを実行します。

   • must-gather ツールのデフォルト設定を使用するには、以下のコマンドを実行します。

     $ oc adm must-gather --image=registry.redhat.io/oadp/oadp-mustgather-rhel9:v1.5

     Copy to Clipboard Toggle word wrap

   • must-gather ツールで timeout フラグを使用するには、以下のコマンドを実行します。

     $ oc adm must-gather --image=registry.redhat.io/oadp/oadp-mustgather-rhel9:v1.5 -- /usr/bin/gather --request-timeout 1m 

     1

     Copy to Clipboard Toggle word wrap

     1

     この例では、タイムアウトは 1 分です。

   • must-gather ツールで非セキュアな TLS 接続フラグを使用するには、以下のコマンドを実行します。

     $ oc adm must-gather --image=registry.redhat.io/oadp/oadp-mustgather-rhel9:v1.5 -- /usr/bin/gather --skip-tls

     Copy to Clipboard Toggle word wrap

   • 非セキュアな TLS 接続と timeout フラグの組み合わせを must-gather ツールで使用するには、以下のコマンドを実行します。

     $ oc adm must-gather --image=registry.redhat.io/oadp/oadp-mustgather-rhel9:v1.5 -- /usr/bin/gather --request-timeout 15s --skip-tls 

     1

     Copy to Clipboard Toggle word wrap

     1

     この例では、タイムアウトは 15 秒です。デフォルトでは、--skip-tls フラグの値は false です。安全でない TLS 接続を許可するには、値を true に設定します。

検証

1. Markdown 出力ファイルが次の場所に生成されていることを確認します: must-gather.local.89…​054550/registry.redhat.io/oadp/oadp-mustgather-rhel9:v1.5-sha256-0…​84/clusters/a4…​86/oadp-must-gather-summary.md

2. Markdown プレビューワーでファイルを開き、Markdown ファイルで must-gather データを確認します。出力例は、以下のイメージを参照してください。この出力ファイルを Red Hat カスタマーポータル で作成したサポートケースにアップロードできます。

   図5.2 must-gather ツールのマークダウン出力の例

   

   View larger image

   

手順

1. 次のコマンドを使用して、openshift-monitoring namespace の cluster-monitoring-config ConfigMap オブジェクトを編集します。

   $ oc edit configmap cluster-monitoring-config -n openshift-monitoring

   Copy to Clipboard Toggle word wrap

2. 次のコマンドを使用して、data セクションの config.yaml フィールドで enableUserWorkload オプションを追加または有効にします。

   apiVersion: v1
   kind: ConfigMap
   data:
     config.yaml: |
       enableUserWorkload: true 

   1

   
   metadata:
   # ...

   Copy to Clipboard Toggle word wrap

   1

   このオプションを追加するか、true に設定します

3. しばらく待ってから、openshift-user-workload-monitoring namespace で次のコンポーネントが稼働していることを確認し、ユーザーワークロードモニタリングのセットアップを確認します。

   $ oc get pods -n openshift-user-workload-monitoring

   Copy to Clipboard Toggle word wrap

   出力例

   NAME                                   READY   STATUS    RESTARTS   AGE
   prometheus-operator-6844b4b99c-b57j9   2/2     Running   0          43s
   prometheus-user-workload-0             5/5     Running   0          32s
   prometheus-user-workload-1             5/5     Running   0          32s
   thanos-ruler-user-workload-0           3/3     Running   0          32s
   thanos-ruler-user-workload-1           3/3     Running   0          32s

   Copy to Clipboard Toggle word wrap

4. openshift-user-workload-monitoring に user-workload-monitoring-config ConfigMap が存在することを確認します。存在する場合、この手順の残りの手順はスキップしてください。

   $ oc get configmap user-workload-monitoring-config -n openshift-user-workload-monitoring

   Copy to Clipboard Toggle word wrap

   出力例

   Error from server (NotFound): configmaps "user-workload-monitoring-config" not found

   Copy to Clipboard Toggle word wrap

5. ユーザーワークロードモニタリングの user-workload-monitoring-config ConfigMap オブジェクトを作成し、2_configure_user_workload_monitoring.yaml ファイル名に保存します。

   出力例

   apiVersion: v1
   kind: ConfigMap
   metadata:
     name: user-workload-monitoring-config
     namespace: openshift-user-workload-monitoring
   data:
     config.yaml: |

   Copy to Clipboard Toggle word wrap

6. 次のコマンドを使用して、2_configure_user_workload_monitoring.yaml ファイルを適用します。

   $ oc apply -f 2_configure_user_workload_monitoring.yaml
   configmap/user-workload-monitoring-config created

   Copy to Clipboard Toggle word wrap

手順

1. openshift-adp-velero-metrics-svc サービスが存在することを確認します。このサービスには、ServiceMonitor オブジェクトのセレクターとして使用される app.kubernetes.io/name=velero ラベルが含まれているはずです。

   $ oc get svc -n openshift-adp -l app.kubernetes.io/name=velero

   Copy to Clipboard Toggle word wrap

   出力例

   NAME                               TYPE        CLUSTER-IP      EXTERNAL-IP   PORT(S)    AGE
   openshift-adp-velero-metrics-svc   ClusterIP   172.30.38.244   <none>        8085/TCP   1h

   Copy to Clipboard Toggle word wrap

2. 既存のサービスラベルと一致する ServiceMonitor YAML ファイルを作成し、そのファイルを 3_create_oadp_service_monitor.yaml として保存します。サービスモニターは openshift-adp-velero-metrics-svc サービスが存在する openshift-adp namespace に作成されます。

   ServiceMonitor オブジェクトの例

   apiVersion: monitoring.coreos.com/v1
   kind: ServiceMonitor
   metadata:
     labels:
       app: oadp-service-monitor
     name: oadp-service-monitor
     namespace: openshift-adp
   spec:
     endpoints:
     - interval: 30s
       path: /metrics
       targetPort: 8085
       scheme: http
     selector:
       matchLabels:
         app.kubernetes.io/name: "velero"

   Copy to Clipboard Toggle word wrap

3. 3_create_oadp_service_monitor.yaml ファイルを適用します。

   $ oc apply -f 3_create_oadp_service_monitor.yaml

   Copy to Clipboard Toggle word wrap

   出力例

   servicemonitor.monitoring.coreos.com/oadp-service-monitor created

   Copy to Clipboard Toggle word wrap

手順

1. サンプルの OADPBackupFailing アラートを含む PrometheusRule YAML ファイルを作成し、4_create_oadp_alert_rule.yaml として保存します。

   OADPBackupFailing アラートのサンプル

   apiVersion: monitoring.coreos.com/v1
   kind: PrometheusRule
   metadata:
     name: sample-oadp-alert
     namespace: openshift-adp
   spec:
     groups:
     - name: sample-oadp-backup-alert
       rules:
       - alert: OADPBackupFailing
         annotations:
           description: 'OADP had {{$value | humanize}} backup failures over the last 2 hours.'
           summary: OADP has issues creating backups
         expr: |
           increase(velero_backup_failure_total{job="openshift-adp-velero-metrics-svc"}[2h]) > 0
         for: 5m
         labels:
           severity: warning

   Copy to Clipboard Toggle word wrap

   このサンプルでは、アラートは次の条件で表示されます。

   • 過去 2 時間において、失敗した新規バックアップの数が 0 よりも多く、その状態が少なくとも 5 分間持続した場合。
   • 失敗が最初に検知されてから 5 分未満の場合、アラートは Pending 状態になり、その後 Firing 状態に変わります。

2. 4_create_oadp_alert_rule.yaml ファイルを適用して、openshift-adp namespace に PrometheusRule オブジェクトを作成します。

   $ oc apply -f 4_create_oadp_alert_rule.yaml

   Copy to Clipboard Toggle word wrap

   出力例

   prometheusrule.monitoring.coreos.com/sample-oadp-alert created

   Copy to Clipboard Toggle word wrap