管理 CEIP 參與

VMware 的「客戶經驗改進計劃 (CEIP)」是一項自願參與計劃，用來收集有關使用者如何使用我們產品的資訊。

所收集的資料可能包括裝置識別碼以及用來識別您的使用者的資訊。收集此資料後，可讓 VMware 診斷及改進其產品和服務、修正產品問題、提供主動技術支援，以及向您建議如何更完善地部署及使用我們的產品。資料是使用開放原始碼 Sonobuoy 程式庫收集的。

當您使用安裝程式介面或 CLI 來部署管理叢集時，除非您指定了退出選項，否則依預設，將啟用參與 VMware 客戶經驗改進計劃 (CEIP)。只要您維持選擇加入該計劃，管理叢集會定期傳送資料給 VMware。收集此資料後，可讓 VMware 診斷及改進其產品和服務、修正產品問題、提供主動技術支援，以及向您建議如何更完善地部署及使用我們的產品。

如果您選擇加入 CEIP，管理叢集會將以下資訊傳送給 VMware：

您部署的工作負載叢集數目。
您使用的基礎結構、網路和儲存區提供者。
tanzu CLI 執行基本作業所花的時間，例如 cluster create、cluster delete、cluster scale 和 cluster upgrade 等作業。
您實作的 Tanzu Kubernetes Grid 套件。
您用來部署叢集的計劃，以及控制平面和工作節點的數目和組態。
您使用的 Tanzu Kubernetes Grid 版本和 Kubernetes 版本。
叢集所執行的工作負載類型和大小，以及其有效期間。
您是否將 Tanzu Kubernetes Grid 與 vSphere with Tanzu、Tanzu Mission Control 或 VMware Aria Operations for Applications 整合。
使用 Tanzu Kubernetes Grid 時所遇到的任何問題、錯誤和失敗的性質，以供我們識別 Tanzu Kubernetes Grid 的哪些區域需要進一步強化。

選取加入或退出 VMware CEIP

如果您在部署管理叢集時選擇退出 CEIP，但之後希望加入，或者如果您選擇加入後又希望退出，您可以在部署後變更 CEIP 參與設定。

CEIP 在管理叢集上作為 cronjob 執行。它不會在工作負載叢集上執行。cronjob 會檢查在 vmware-system-telemetry 命名空間中找到的 configmap vmware-telemetry-cluster-ceip，以判斷它是否應收集資料。

查看 CEIP 狀態

若要查看管理叢集的目前 CEIP 狀態，請執行以下動作：

將以管理叢集為目標的 kubeconfig 匯出至環境變數 KUBECONFIG。
```
export KUBECONFIG=~/.kube/config
```
執行 tanzu telemetry status 命令，以查看目前管理叢集的 CEIP 狀態，例如：
```
tanzu telemetry status
```
```
- ceip: |
    level: disabled
  shared_identifiers: ...
```
輸出 ceip.level 清單會指出 CEIP 狀態：
- standard 或未列出狀態：在管理叢集上啟用 CEIP 參與，並傳送遙測資料。這是預設行為。
- disabled：CEIP 參與已停用。

選擇加入 CEIP

若要在目前已停用 CEIP 的管理叢集上啟用 CEIP 參與，請執行以下動作：

執行 tanzu telemetry update --CEIP-opt-in 命令。
```
tanzu telemetry update --CEIP-opt-in
```

若要驗證「CEIP 參與」現在是否處於作用中，請再次執行 tanzu telemetry status。

現在狀態應為 standard。

- ceip: |
    level: standard
  shared_identifiers: ...

您也可以將 kubectl 內容設定為管理叢集，並執行 kubectl get cronjobs -A，來檢查 CEIP cronjob 是否正在執行。例如：

kubectl config use-context my-aws-mgmt-cluster-admin@my-aws-mgmt-cluster

kubectl get cronjobs -A

輸出顯示了 tkg-telemetry 工作正在執行：

NAMESPACE              NAME            SCHEDULE      SUSPEND   ACTIVE   LAST SCHEDULE   AGE
tkg-system-telemetry   tkg-telemetry   0 */6 * * *   False     0        <none>          18s

選擇退出 CEIP

若要在目前已啟用 CEIP 的管理叢集上停用 CEIP 參與，請執行以下動作：

執行 tanzu telemetry update --CEIP-opt-out 命令。
```
tanzu telemetry update --CEIP-opt-out
```
若要確認 CEIP 參與已停用，請重新執行 tanzu telemetry status。

現在狀態應為 disabled。
```
- ceip: |
    level: disabled
  shared_identifiers: ...
```
停用的 CEIP 並不會從管理叢集中移除 Cron 工作。Cron 工作負責檢查 CEIP 是否已停用/已啟用。此工作應會記錄它是否不在收集遙測。若要驗證 Cron 工作是否正在傳送遙測，我們需要檢查由遙測 Cron 工作所建立的網繭記錄。

請執行以下命令，檢視遙測命名空間中的所有網繭：

kubectl get pods -n tkg-system-telemetry

輸出應類似如下：

NAME                             READY   STATUS      RESTARTS   AGE
tkg-telemetry-1657519200-l8k9x   0/1     Completed   0          14h
tkg-telemetry-1657540800-j4dzw   0/1     Completed   0          8h
tkg-telemetry-1657562400-pj826   0/1     Completed   0          125m

使用以下命令，挑選最近完成的網繭，並檢查其記錄：

kubectl logs pods/tkg-telemetry-1657562400-pj826 -n tkg-system-telemetry

記錄應包含下列字行，其中指出未收集任何資料

2022-07-11T16:01:52.686-0400  INFO  CEIP.config vmware/ceip_validator.go:77  loaded config  {"cluster[level]": "disabled"}
2022-07-11T16:01:52.686-0400  INFO  tkg-telemetry/main.go:57  cluster is opted out of telemetry, aborting collection

將權利帳戶號碼和環境類型新增到遙測設定檔

平台操作員可以使用 Tanzu CLI，將權利帳戶號碼 (EAN) 和環境類型新增到遙測設定檔中。

EAN 是一個與帳戶相關聯的唯一九位數號碼。將 EAN 新增到遙測設定檔，可讓 CEIP 所收集的所有資訊與該帳戶關聯，並可讓您的帳戶團隊針對該帳戶建立報告。

VMware 建議您使用您的 EAN，來進行所有的產品和支援互動。如果未提供 EAN，可能會針對該次互動建立新的 EAN。

若要將 EAN 和環境類型新增到遙測設定檔，請執行以下動作：

識別權利帳戶號碼
更新管理叢集

識別權利帳戶號碼

如果您不知道 EAN，也可使用以下方法之一來尋找它。

從 VMware Customer Connect 中尋找 EAN
從 Partner Connect 入口網站中尋找 EAN

從 Customer Connect 中尋找 EAN

在網頁瀏覽器中，導覽至 VMware Customer Connect 並登入。如果您是新使用者，請登錄以建立 Customer Connect 設定檔。如需有關建立 Customer Connect 設定檔的詳細資訊，請參閱 VMware 知識庫中的如何建立 Customer Connect 設定檔。

透過以下方式之一，從 Customer Connect 中尋找 EAN：

從帳戶摘要 (Account Summary)：
1. 在首頁上，按一下管理帳戶 (Manage Accounts) 快速連結
2. 選取帳戶 (Accounts) > 帳戶摘要 (Account Summary)。
3. 在帳戶摘要 (Account Summary) 頁面中，找出帳戶並記錄 EAN。
從授權金鑰 (License Keys) 中：
1. 在頂端功能表列中，按一下帳戶 (Accounts) > 授權金鑰 (License Keys)。
2. 在授權金鑰 (License Keys) 頁面上，找到帳戶並記錄 EAN。

從 Partner Connect 入口網站中尋找 EAN

從 Partner Connect 中尋找 EAN：

在網頁瀏覽器中，導覽至 VMware 合作夥伴入口網站，然後登入。

如果您是新使用者，請向 Partner Connect 登錄。如需有關登錄的詳細資訊，請參閱 VMware 知識庫中的如何向 Partner Connect 登錄。
在頂端功能表列中，按一下獎勵 (Incentives) > 優勢增強 (Advantage Plus)，然後選取權利帳戶查閱 (Entitlement Account Lookup)。
更新客戶名稱 (Customer Name) 和國家/地區 (Country) 欄位，然後按一下搜尋 (Search)。在結果中，找出帳戶並記錄 EAN。

更新管理叢集

將 EAN 和環境類型新增至遙測設定檔中，然後確認 CEIP 狀態。

若要將 EAN 和環境類型新增到遙測設定檔中，請執行：
```
tanzu telemetry update --entitlement-account-number "MY-EAN" --env-is-prod true
```
其中：
- MY-EAN 是權利帳戶號碼。
若要驗證是否已新增 EAN，請執行：
```
tanzu telemetry status
```

確認此命令的輸出將 CEIP 狀態顯示為 standard，並且 EAN 顯示在 shared_identifiers 之下

- ceip: |
    level: standard
  shared_identifiers: |
    ...
    customer_entitlement_account_number: <MY-EAN>
    env_is_prod: "true"