Share via

az arcdata dc debug

  • Riferimento

Nota

Questo riferimento fa parte dell'estensione arcdata per l'interfaccia della riga di comando di Azure (versione 2.3.1 o successiva). L'estensione installerà automaticamente la prima volta che si esegue un comando az arcdata dc debug . Altre informazioni sulle estensioni.

Eseguire il debug del controller dati.

Comandi

Nome Descrizione Tipo Stato
az arcdata dc debug controldb-cdc

Abilitare/disabilitare CDC nel database e nelle tabelle del controller di dati: solo a scopo di risoluzione dei problemi.

 Estensione Disponibilità generale
az arcdata dc debug copy-logs

Copia i log.

 Estensione Disponibilità generale
az arcdata dc debug dump

Attiva il dump della memoria.

 Estensione Disponibilità generale
az arcdata dc debug restore-controldb-snapshot

Ripristina una copia univoca di ControlDB dal backup, solo a scopo di risoluzione dei problemi.

 Estensione Disponibilità generale

az arcdata dc debug controldb-cdc

Abilitare/disabilitare CDC nel database e nelle tabelle del controller di dati: solo a scopo di risoluzione dei problemi.

Abilitare/disabilitare Change Data Capture per il database "controller" e le tabelle supportate con ore di conservazione configurabili.

az arcdata dc debug controldb-cdc --k8s-namespace
                                  [--enable {false, true}]
                                  [--retention-hours]
                                  [--use-k8s]

Esempio

Abilita Change Data Capture con 4 ore di conservazione.

az arcdata dc debug controldb-cdc -k arc-data-services --enable true --retention-hours 4

Disabilita Change Data Capture.

az arcdata dc debug controldb-cdc -k arc-data-services --enable false

Parametri necessari

--k8s-namespace -k

Spazio dei nomi Kubernetes del controller dati esistente.

Parametri facoltativi

--enable

Abilitare o disabilitare Change Data Capture.

valori accettati: false, true
--retention-hours

Periodo di conservazione CDC, specificato in ore. I valori consentiti sono compresi tra 1 e 24.

valore predefinito: 8
--use-k8s

Usare le API Kubernetes locali per eseguire questa azione.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az arcdata dc debug copy-logs

Copia i log.

Copia i log di debug dal controller dati. È necessaria la configurazione di Kubernetes nel sistema in uso.

az arcdata dc debug copy-logs --k8s-namespace
                              [--container]
                              [--exclude-arcdata-logs]
                              [--exclude-cluster-info]
                              [--exclude-controldb]
                              [--exclude-dumps]
                              [--exclude-system-logs]
                              [--pod]
                              [--resource-kind]
                              [--resource-name]
                              [--skip-compress]
                              [--target-folder]
                              [--timeout]
                              [--use-k8s]

Parametri necessari

--k8s-namespace -k

Spazio dei nomi Kubernetes del controller dati.

Parametri facoltativi

--container -c

Copia i log relativi ai contenitori con nome simile. Facoltativo; per impostazione predefinita, vengono copiati i log di tutti i contenitori. Questo parametro non può essere specificato più volte. In caso contrario, verrà usato l'ultimo parametro specificato.

--exclude-arcdata-logs

Indica se escludere o meno i log di Arc Data Services dalla cartella dei risultati. Il valore predefinito è False che include tutti i log dei contenitori di Arc Data Services.

valore predefinito: False
--exclude-cluster-info

Indica se escludere o meno le informazioni sulle risorse kubernetes dalla cartella dei risultati per spazio dei nomi. Il valore predefinito è False, che include informazioni sulla risorsa con spazio dei nomi.

valore predefinito: False
--exclude-controldb

Indica se escludere o meno un backup di controldb dalla cartella dei risultati. Il valore predefinito è False, che include un backup controldb.

valore predefinito: False
--exclude-dumps

Indica se escludere o meno i dump dalla cartella dei risultati. Il valore predefinito è False, ovvero i dump vengono inclusi.

valore predefinito: False
--exclude-system-logs

Indica se escludere o meno i log dello spazio dei nomi kube-system e azure-arc dalla raccolta. Il valore predefinito è False che include i log kube-system e connectedk8s, se accessibili.

valore predefinito: False
--pod

Copia i log relativi ai pod con nome simile. Facoltativo; per impostazione predefinita, vengono copiati i log di tutti i pod. Questo parametro non può essere specificato più volte. In caso contrario, verrà usato l'ultimo parametro specificato.

--resource-kind

Copiare i log per la risorsa di un determinato tipo. Questo parametro non può essere specificato più volte. In caso contrario, verrà usato l'ultimo parametro specificato. Se specificato, è necessario specificare anche --resource-name per identificare la risorsa.

--resource-name

Copiare i log per la risorsa con il nome specificato. Questo parametro non può essere specificato più volte. In caso contrario, verrà usato l'ultimo parametro specificato. Se specificato, è necessario specificare anche --resource-kind per identificare la risorsa.

--skip-compress

Indica se ignorare o meno la compressione della cartella dei risultati. Il valore predefinito è False, ovvero la cartella dei risultati viene compressa.

valore predefinito: False
--target-folder -d

Percorso della cartella di destinazione in cui copiare i log. Facoltativo; per impostazione predefinita, il risultato viene creato nella cartella locale. Questo parametro non può essere specificato più volte. In caso contrario, verrà usato l'ultimo parametro specificato.

--timeout -t

Numero di secondi di attesa per il completamento del comando. Il valore predefinito è 0 che è illimitato.

valore predefinito: 0
--use-k8s

Usare le API Kubernetes locali per eseguire questa azione.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az arcdata dc debug dump

Attiva il dump della memoria.

Attiva il dump della memoria e lo copia dal contenitore. È necessaria la configurazione di Kubernetes nel sistema in uso.

az arcdata dc debug dump --k8s-namespace
                         [--container {controller}]
                         [--target-folder]
                         [--use-k8s]

Parametri necessari

--k8s-namespace -k

Spazio dei nomi Kubernetes del controller dati.

Parametri facoltativi

--container -c

Contenitore di destinazione da attivare per il dump dei processi in esecuzione.

valori accettati: controller
valore predefinito: controller
--target-folder -d

Cartella di destinazione per copiare il dump out.

valore predefinito: ./output/dump
--use-k8s

Usare le API Kubernetes locali per eseguire questa azione.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az arcdata dc debug restore-controldb-snapshot

Ripristina una copia univoca di ControlDB dal backup, solo a scopo di risoluzione dei problemi.

Ripristina un backup COPY_ONLY di ControlDB con un nome univoco per la risoluzione dei problemi: è necessaria la configurazione di Kubernetes nel sistema.

az arcdata dc debug restore-controldb-snapshot --backup-file
                                               --k8s-namespace
                                               [--use-k8s]

Esempio

Linux: ripristinare un backup eseguito in precedenza da un comando 'arcdata dc debug copy-logs'.

az arcdata dc debug restore-controldb-snapshot -k arc-data-services -f /path/to/backup/controller-1675653451.bak

Windows: ripristinare un backup eseguito da un comando 'arcdata dc debug copy-logs' precedentemente eseguito.

az arcdata dc debug restore-controldb-snapshot -k arc-data-services -f C:\path\to\backup\controller-1675653451.bak

Parametri necessari

--backup-file -f

File di backup del database del controller esistente: deve terminare con ".bak", verrà ripristinato con un nome di database univoco in base al timestamp di esecuzione.

--k8s-namespace -k

Spazio dei nomi Kubernetes del controller dati esistente.

Parametri facoltativi

--use-k8s

Usare le API Kubernetes locali per eseguire questa azione.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.