az arcdata dc debug

Note

Cette référence fait partie de l’extension arcdata pour Azure CLI (version 2.3.1 ou ultérieure). L’extension installe automatiquement la première fois que vous exécutez une az arcdata dc debug commande. Apprenez-en davantage sur les extensions.

Déboguer le contrôleur de données.

Commandes

Nom	Description	Type	État
az arcdata dc debug controldb-cdc	Activez/désactivez la capture de données modifiées sur la base de données et les tables du contrôleur de données , à des fins de résolution des problèmes uniquement.	Extension	GA
az arcdata dc debug copy-logs	Copiez les journaux.	Extension	GA
az arcdata dc debug dump	Déclenchez le vidage de la mémoire.	Extension	GA
az arcdata dc debug restore-controldb-snapshot	Restaure une copie unique de ControlDB à partir de la sauvegarde , à des fins de résolution des problèmes uniquement.	Extension	GA

az arcdata dc debug controldb-cdc

Activez/désactivez la capture de données modifiées sur la base de données et les tables du contrôleur de données , à des fins de résolution des problèmes uniquement.

Activez/désactivez la capture de données modifiées pour la base de données « contrôleur » et les tables prises en charge avec des heures de rétention configurables.

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

Exemples

Active la capture de données modifiées avec 4 heures de rétention.

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

Désactive la capture des données modifiées.

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

Paramètres obligatoires

--k8s-namespace -k

Espace de noms Kubernetes du contrôleur de données existant.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--enable

Activez ou désactivez la capture des données modifiées.

Propriété	Valeur
Valeurs acceptées:	false, true

--retention-hours

Période de rétention cdc, spécifiée en heures. Les valeurs autorisées sont comprises entre 1 et 24.

Propriété	Valeur
Valeur par défaut:	8

--use-k8s

Utilisez les API Kubernetes locales pour effectuer cette action.

Paramètres globaux

--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété	Valeur
Valeur par défaut:	False

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété	Valeur
Valeur par défaut:	False

--output -o

Format de sortie.

Propriété	Valeur
Valeur par défaut:	json
Valeurs acceptées:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété	Valeur
Valeur par défaut:	False

az arcdata dc debug copy-logs

Copiez les journaux.

Copiez les journaux de débogage à partir du contrôleur de données : la configuration Kubernetes est requise sur votre système.

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]

Paramètres obligatoires

--k8s-namespace -k

Espace de noms Kubernetes du contrôleur de données.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--container -c

Copiez les journaux des conteneurs avec un nom similaire, Facultatif, par défaut copie les journaux pour tous les conteneurs. Impossible de spécifier plusieurs fois. Si elle est spécifiée plusieurs fois, la dernière sera utilisée.

--exclude-arcdata-logs

Indique si les journaux des services de données Arc doivent être exclus ou non du dossier de résultats. La valeur par défaut est False, qui inclut tous les journaux de conteneur des services de données Arc.

Propriété	Valeur
Valeur par défaut:	False

--exclude-cluster-info

Indique si les informations de ressource Kubernetes doivent être exclues ou non du dossier de résultats par espace de noms. La valeur par défaut est False, qui inclut les informations de ressource d’espace de noms.

Propriété	Valeur
Valeur par défaut:	False

--exclude-controldb

Indique si une sauvegarde de controldb doit être exclue ou non du dossier de résultats. La valeur par défaut est False, qui inclut une sauvegarde controldb.

Propriété	Valeur
Valeur par défaut:	False

--exclude-dumps

Indique s’il faut exclure ou non les vidages du dossier de résultats. La valeur par défaut est False, qui inclut les vidages.

Propriété	Valeur
Valeur par défaut:	False

--exclude-system-logs

Indique s’il faut exclure ou non les journaux d’espace de noms kube-system et azure-arc de la collection. La valeur par défaut est False, qui inclut les journaux kube-system et connectedk8s, le cas échéant.

Propriété	Valeur
Valeur par défaut:	False

--pod

Copiez les journaux des pods avec un nom similaire. Facultatif, par défaut copie les journaux pour tous les pods. Impossible de spécifier plusieurs fois. Si elle est spécifiée plusieurs fois, la dernière sera utilisée.

--resource-kind

Copiez les journaux de la ressource d’un type particulier. Impossible de spécifier plusieurs fois. Si elle est spécifiée plusieurs fois, la dernière sera utilisée. Si spécifié, --resource-name doit également être spécifié pour identifier la ressource.

--resource-name

Copiez les journaux de la ressource du nom spécifié. Impossible de spécifier plusieurs fois. Si elle est spécifiée plusieurs fois, la dernière sera utilisée. Si elle est spécifiée, --resource-kind doit également être spécifiée pour identifier la ressource.

--skip-compress

Indique si vous souhaitez ignorer ou non la compression du dossier de résultats. La valeur par défaut est False qui compresse le dossier de résultats.

Propriété	Valeur
Valeur par défaut:	False

--target-folder -d

Chemin du dossier cible vers lequel copier les journaux. Facultatif, par défaut, crée le résultat dans le dossier local. Impossible de spécifier plusieurs fois. Si elle est spécifiée plusieurs fois, la dernière sera utilisée.

--timeout -t

Nombre de secondes à attendre la fin de la commande. La valeur par défaut est 0, qui est illimitée.

Propriété	Valeur
Valeur par défaut:	0

--use-k8s

Utilisez les API Kubernetes locales pour effectuer cette action.

Paramètres globaux

--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété	Valeur
Valeur par défaut:	False

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété	Valeur
Valeur par défaut:	False

--output -o

Format de sortie.

Propriété	Valeur
Valeur par défaut:	json
Valeurs acceptées:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété	Valeur
Valeur par défaut:	False

az arcdata dc debug dump

Déclenchez le vidage de la mémoire.

Déclenchez le vidage de la mémoire et copiez-le à partir du conteneur . La configuration Kubernetes est requise sur votre système.

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

Paramètres obligatoires

--k8s-namespace -k

Espace de noms Kubernetes du contrôleur de données.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--container -c

Conteneur cible à déclencher pour vider les processus en cours d’exécution.

Propriété	Valeur
Valeur par défaut:	controller
Valeurs acceptées:	controller

--target-folder -d

Dossier cible pour copier le vidage.

Propriété	Valeur
Valeur par défaut:	./output/dump

--use-k8s

Utilisez les API Kubernetes locales pour effectuer cette action.

Paramètres globaux

--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété	Valeur
Valeur par défaut:	False

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété	Valeur
Valeur par défaut:	False

--output -o

Format de sortie.

Propriété	Valeur
Valeur par défaut:	json
Valeurs acceptées:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété	Valeur
Valeur par défaut:	False

az arcdata dc debug restore-controldb-snapshot

Restaure une copie unique de ControlDB à partir de la sauvegarde , à des fins de résolution des problèmes uniquement.

Restaure une sauvegarde COPY_ONLY de ControlDB sous un nom unique pour la résolution des problèmes : la configuration de Kubernetes est requise sur votre système.

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

Exemples

Linux : restaurez une sauvegarde effectuée à partir d’une commande « arcdata dc debug copy-logs » précédemment exécutée.

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

Windows : restaurez une sauvegarde effectuée à partir d’une commande « arcdata dc debug copy-logs » précédemment exécutée.

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

Paramètres obligatoires

--backup-file -f

Le fichier de sauvegarde de base de données du contrôleur existant doit se terminer par « .bak », sera restauré sous un nom de base de données unique en fonction de l’horodatage d’exécution.

--k8s-namespace -k

Espace de noms Kubernetes du contrôleur de données existant.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--use-k8s

Utilisez les API Kubernetes locales pour effectuer cette action.

Paramètres globaux

--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété	Valeur
Valeur par défaut:	False

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété	Valeur
Valeur par défaut:	False

--output -o

Format de sortie.

Propriété	Valeur
Valeur par défaut:	json
Valeurs acceptées:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété	Valeur
Valeur par défaut:	False