Gestione della partecipazione al programma CEIP

Il Programma di Miglioramento dell'Esperienza del Cliente (CEIP) di VMware è un programma volontario che raccoglie informazioni sull'utilizzo dei prodotti di VMware da parte degli utenti.

I dati raccolti possono includere identificatori dei dispositivi e informazioni che identificano gli utenti. Questi dati vengono raccolti per consentire a VMware di diagnosticare e migliorare i prodotti e i servizi che offre, risolvere i problemi relativi ai prodotti, nonché fornire supporto tecnico proattivo e consigli su come distribuire e utilizzare al meglio i prodotti. I dati vengono raccolti utilizzando la libreria open source Sonobuoy.

Quando si distribuisce un cluster di gestione utilizzando l'interfaccia del programma di installazione o la CLI, la partecipazione al Programma di Miglioramento dell'Esperienza del Cliente (CEIP) di VMware è abilitata per impostazione predefinita, a meno che non si selezioni l'opzione per disabilitarla. Se si sceglie di partecipare al programma, il cluster di gestione invia dati a VMware a intervalli regolari. Questi dati vengono raccolti per consentire a VMware di diagnosticare e migliorare i prodotti e i servizi che offre, risolvere i problemi relativi ai prodotti, nonché fornire supporto tecnico proattivo e consigli su come distribuire e utilizzare al meglio i prodotti.

Se si partecipa al programma CEIP, i cluster di gestione inviano le seguenti informazioni a VMware:

Numero di cluster del carico di lavoro distribuiti.
Provider di infrastruttura, rete e storage utilizzati.
Tempo necessario alla CLI tanzu per eseguire operazioni di base come cluster create, cluster delete, cluster scale e cluster upgrade.
Pacchetti di Tanzu Kubernetes Grid implementati.
Piani utilizzati per distribuire i cluster, nonché il numero e la configurazione dei nodi del piano di controllo e dei nodi worker.
Versioni di Tanzu Kubernetes Grid e Kubernetes utilizzate.
Tipo e dimensioni dei carichi di lavoro eseguiti dai cluster, nonché il loro ciclo di vita.
Se si integra o meno Tanzu Kubernetes Grid con vSphere with Tanzu, Tanzu Mission Control o VMware Aria Operations for Applications.
La natura di eventuali problemi ed errori che si verificano quando si utilizza Tanzu Kubernetes Grid, in modo da poter identificare le aree di Tanzu Kubernetes Grid da potenziare.

Partecipazione o annullamento della partecipazione al programma CEIP di VMware

Se si sceglie di non partecipare al programma CEIP quando si distribuisce un cluster di gestione e in seguito si desidera partecipare oppure se si sceglie di partecipare e in seguito si desidera annullare la partecipazione, è possibile modificare l'impostazione della partecipazione al programma CEIP dopo la distribuzione.

Il programma CEIP viene eseguito come cronjob nel cluster di gestione. Non viene eseguito nei cluster del carico di lavoro. cronjob controlla la mappa di configurazione vmware-telemetry-cluster-ceip che si trova nello spazio dei nomi vmware-system-telemetry per determinare se deve raccogliere o meno i dati.

Visualizzazione dello stato del programma CEIP

Per visualizzare lo stato corrente del programma CEIP del cluster di gestione:

Esportare il kubeconfig che ha come destinazione il cluster di gestione in una variabile di ambiente, KUBECONFIG.
```
export KUBECONFIG=~/.kube/config
```
Eseguire il comando tanzu telemetry participation status per visualizzare lo stato del programma CEIP del cluster di gestione corrente, ad esempio:
```
tanzu telemetry participation status
```
```
- ceip: |
    level: disabled
  shared_identifiers: ...
```
L'elenco di ceip.level di output indica lo stato del programma CEIP:
- standard o nessuno stato: La partecipazione al programma CEIP è abilitata in un cluster di gestione e invia dati di telemetria. Si tratta del comportamento predefinito.
- disabled: La partecipazione al programma CEIP è disattivata.

Attivazione del programma CEIP

Per attivare la partecipazione al programma CEIP in un cluster di gestione in cui è attualmente disattivata:

Eseguire il comando tanzu telemetry participation update --CEIP-opt-in.
```
tanzu telemetry participation update --CEIP-opt-in
```
Per verificare che la partecipazione al programma CEIP sia ora attiva, eseguire nuovamente tanzu telemetry participation status.

Lo stato dovrebbe essere standard.
```
- ceip: |
    level: standard
  shared_identifiers: ...
```
È inoltre possibile verificare che il cronjob del programma CEIP sia in esecuzione impostando il contesto di kubectl sul cluster di gestione ed eseguendo kubectl get cronjobs -A. Ad esempio:
```
kubectl config use-context my-aws-mgmt-cluster-admin@my-aws-mgmt-cluster
```
```
kubectl get cronjobs -A
```
L'output indica che il processo tkg-telemetry è in esecuzione:
```
NAMESPACE              NAME            SCHEDULE      SUSPEND   ACTIVE   LAST SCHEDULE   AGE
tkg-system-telemetry   tkg-telemetry   0 */6 * * *   False     0        <none>          18s
```

Disattivazione del programma CEIP

Per disattivare la partecipazione al programma CEIP in un cluster di gestione in cui è attualmente attivata:

Eseguire il comando tanzu telemetry participation update --CEIP-opt-out.
```
tanzu telemetry participation update --CEIP-opt-out
```
Per verificare che la partecipazione al programma CEIP sia disattivata, eseguire nuovamente tanzu telemetry participation status.

Lo stato dovrebbe essere disabled.
```
- ceip: |
    level: disabled
  shared_identifiers: ...
```
La disattivazione del programma CEIP non comporta la rimozione del processo cron dal cluster di gestione. Il processo cron controlla se il programma CEIP è disattivato o attivato. Quando il processo cron non sta raccogliendo la telemetria, lo indica nei registri. Per verificare se il processo cron sta inviando o meno la telemetria, è necessario controllare i registri del pod creato dal processo cron di telemetria.

Eseguire il comando seguente per visualizzare tutti i pod nello spazio dei nomi della telemetria:

kubectl get pods -n tkg-system-telemetry

L'output deve avere un aspetto simile al seguente:

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

Selezionare il pod completato più di recente e controllarne i registri utilizzando il comando seguente:

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

I registri devono contenere le righe seguenti, che indicano che non sono stati raccolti dati

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

Aggiunta del numero EAN e del tipo di ambiente al profilo di telemetria

Gli operatori della piattaforma possono utilizzare la CLI di Tanzu per aggiungere un numero EAN (Entitlement Account Number) e un tipo di ambiente a un profilo di telemetria.

EAN è un numero univoco di nove cifre associato a un account. Se si aggiunge un numero EAN a un profilo di telemetria, è possibile associare a tale account tutte le informazioni raccolte dal programma CEIP e il team dell'account può creare report per l'account.

VMware consiglia di utilizzare il numero EAN per tutte le interazioni relative al prodotto e al supporto. Se non si specifica alcun numero EAN, è possibile creare un nuovo numero EAN per l'interazione.

Per aggiungere un numero EAN e un tipo di ambiente a un profilo di telemetria:

Identificare il numero EAN (Entitlement Account Number)
Aggiornare il cluster di gestione

Identificare il numero EAN (Entitlement Account Number)

Se non si conosce il numero EAN, utilizzare uno dei metodi seguenti per individuarlo.

Individuare il numero EAN in VMware Customer Connect
Individuare il numero EAN nel portale di Partner Connect

Individuazione del numero EAN in Customer Connect

In un browser Web, passare a VMware Customer Connect e accedere. Se si è un nuovo utente, registrarsi per creare un profilo Customer Connect. Per ulteriori informazioni sulla creazione di un profilo Customer Connect, vedere Come creare un profilo Customer Connect nella Knowledge Base di VMware.

Individuare il numero EAN in Customer Connect in uno dei modi seguenti:

In Riepilogo account (Account Summary):
1. Nella pagina Home, fare clic sul collegamento rapido Gestisci account (Manage Accounts).
2. Selezionare Account > Riepilogo account (Account Summary).
3. Nella pagina Riepilogo account (Account Summary), individuare l'account e prendere nota del numero EAN.
In Chiavi di licenza (License Keys):
1. Nella barra dei menu superiore, fare clic su Account > Chiavi di licenza (License Keys).
2. Nella pagina Chiavi di licenza (License Keys), individuare l'account e prendere nota del numero EAN.

Individuare il numero EAN nel portale di Partner Connect

Individuazione del numero EAN in Partner Connect:

In un browser Web, passare a VMware Partner Portal e accedere.

Se si è un nuovo utente, registrarsi in Partner Connect. Per ulteriori informazioni sulla registrazione, vedere Come registrarsi in Partner Connect nella Knowledge Base di VMware.
Nella barra dei menu superiore, fare clic su Incentivi (Incentives) > Advantage Plus e selezionare Ricerca Entitlement Account (Entitlement Account Lookup).
Aggiornare i campi Nome cliente (Customer Name) e Paese (Country), quindi fare clic su Cerca (Search). Nei risultati, individuare l'account e prendere nota del numero EAN.

Aggiornare il cluster di gestione

Aggiungere il numero EAN e il tipo di ambiente nel profilo di telemetria, quindi verificare lo stato del programma CEIP.

Per aggiungere il numero EAN e il tipo di ambiente al profilo di telemetria, eseguire:
```
tanzu telemetry metadata update --entitlement-account-number "MY-EAN" --env-is-prod true
```
In cui:
- MY-EAN è il numero EAN (Entitlement Account Number).
Per verificare che il numero EAN sia stato aggiunto, eseguire:
```
tanzu telemetry metadata status
```
Verificare che l'output di questo comando indichi lo stato del programma CEIP standard e che il numero EAN sia visualizzato in shared_identifiers
```
- ceip: |
    level: standard
  shared_identifiers: |
    ...
    customer_entitlement_account_number: <MY-EAN>
    env_is_prod: "true"
```