Logging

以下章節包含對 Harvester 日誌記錄進行故障排除的提示。

無法啟用 rancher-logging 附加元件

問題描述

當您嘗試啟用 rancher-logging 附加元件時,Harvester UI 上會出現錯誤訊息。

來自 cattle-logging-system/helm-install-rancher-logging Pod 的日誌訊息確認發生了錯誤。

範例:

...
 echo 'Installing helm chart'
...
+ helm install --version ... rancher-logging rancher-logging/rancher-logging ...
...
Error: INSTALLATION FAILED: Unable to continue with install: ClusterRole "logging-admin" in namespace "" exists
and cannot be imported into the current release: invalid ownership metadata;
annotation validation error: key "meta.helm.sh/release-name" must equal "rancher-logging":
current value is "hvst-upgrade-md54b-upgradelog-operator"

根本原因

摘要:當您啟用 rancher-logging 附加元件時,Harvester 會嘗試安裝 Logging Operator。當叢集上已存在 Logging Operator 時,安裝會失敗,該 Logging Operator 可能是先前升級嘗試遺留的資源或由當前正在進行的升級建立的。

Upgrade Software 畫面包含一個 Enable Logging 選項,您必須選擇該選項以啟用 Harvester 記錄升級事件。

但是,背景處理取決於是否啟用了 rancher-logging 附加元件。

當附加元件被停用時,升級控制器會建立以下 logging 和 managedchart 物件。

$ kubectl get upgrade.harvesterhci -A
NAMESPACE          NAME                 AGE
harvester-system   hvst-upgrade-hpfnw   36s

$ kubectl get logging -A
NAME                                          LOGGINGREF             CONTROLNAMESPACE
hvst-upgrade-hpfnw-upgradelog-infra           harvester-upgradelog   harvester-system        // 由升級控制器新建立
hvst-upgrade-hpfnw-upgradelog-operator-root                          cattle-logging-system   // 由升級控制器新建立,作為 logging-operator

$ kubectl get managedchart -A
NAMESPACE     NAME                                     AGE
fleet-local   hvst-upgrade-hpfnw-upgradelog-operator   18s  // 由升級控制器新建立

當附加元件被啟用時,升級控制器會建立以下 logging 物件。

$ kubectl get upgrade.harvesterhci -A
NAMESPACE          NAME                 AGE
harvester-system   hvst-upgrade-9sn4x   14s

$ kubectl get managedchart -A
NAMESPACE     NAME                     AGE

$ kubectl get logging -A
NAME                                  LOGGINGREF                     CONTROLNAMESPACE
hvst-upgrade-9sn4x-upgradelog-infra   harvester-upgradelog           harvester-system        // 由升級控制器新建立
rancher-logging-kube-audit            harvester-kube-audit-log-ref   cattle-logging-system   // 最初由 rancher-logging 附加元件建立
rancher-logging-root                                                 cattle-logging-system   // 最初由 rancher-logging 附加元件建立,作為 logging-operator

您可能會在以下情況下遇到此問題:

• rancher-logging 附加元件最初被停用。您在選擇 Enable Logging 選項的情況下開始升級。在未等待升級完成的情況下,您啟用了 rancher-logging 附加元件。Harvester UI 顯示錯誤訊息。

• rancher-logging 附加元件最初被停用。您在選擇 Enable Logging 選項的情況下開始升級並等待升級完成。由於已知問題,managedchart 和 logging 物件未被移除。接下來,您啟用 rancher-logging 附加元件。Harvester UI 顯示錯誤訊息。

解決方法

1. 如果升級正在進行中,請等待其成功完成或移除。

   important

   為避免日誌衝突,在升級進行中時請勿啟用或停用 rancher-logging 附加元件。在 Harvester v1.7.0 和更高版本中,此操作已被阻止。

2. 如果 rancher-logging 附加元件已啟用但處於失敗狀態,請停用它。

3. 檢查 logging 和 managedchart 物件。如果這些物件的名稱以 hvst-upgrade- 開頭,請手動刪除它們。

4. 啟用 rancher-logging 附加元件。

備註

在開始升級之前,所有附加元件都必須處於健康狀態。在 Harvester v1.7.0 和更高版本中,此先決條件會自動驗證。

相關問題

#9289 和 #9644