az arcdata dc debug

  • Référence

Remarque

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 commande az arcdata dc debug . En savoir plus sur les extensions.

Déboguez un contrôleur de données.

Commandes

Nom Description Type Statut
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

Copie 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

--enable

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

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.

valeur par défaut: 8
--use-k8s

Utilisez les API Kubernetes locales pour effectuer cette action.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

az arcdata dc debug copy-logs

Copie 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

--container -c

Copier les journaux des conteneurs avec un nom similaire. Facultatif : par défaut, copie les journaux de tous les conteneurs. Ne peut pas être spécifié plusieurs fois. S’il est spécifié plusieurs fois, c’est le dernier qui sera utilisé.

--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.

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.

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.

valeur par défaut: False
--exclude-dumps

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

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.

valeur par défaut: False
--pod

Copier les journaux des pods avec un nom similaire. Facultatif : par défaut, copie les journaux de tous les pods. Ne peut pas être spécifié plusieurs fois. S’il est spécifié plusieurs fois, c’est le dernier qui sera utilisé.

--resource-kind

Copiez les journaux de la ressource d’un type particulier. Ne peut pas être spécifié plusieurs fois. S’il est spécifié plusieurs fois, c’est le dernier qui sera utilisé. S’il est 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é. Ne peut pas être spécifié plusieurs fois. S’il est spécifié plusieurs fois, c’est le dernier qui sera utilisé. S’il est spécifié, --resource-kind doit également être spécifié pour identifier la ressource.

--skip-compress

Indique s’il convient ou non d’ignorer la compression du dossier de résultats. La valeur par défaut est False, ce qui compresse le dossier de résultats.

valeur par défaut: False
--target-folder -d

Chemin du dossier cible dans lequel copier les journaux. Facultatif : par défaut, crée le résultat dans le dossier local. Ne peut pas être spécifié plusieurs fois. S’il est spécifié plusieurs fois, c’est le dernier qui sera utilisé.

--timeout -t

Nombre de secondes à attendre pour l’exécution de la commande. La valeur par défaut est 0, qui est illimitée.

valeur par défaut: 0
--use-k8s

Utilisez les API Kubernetes locales pour effectuer cette action.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

az arcdata dc debug dump

Déclenchez le vidage de la mémoire.

Déclenchez le vidage de la mémoire et copiez le contenu hors 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

--container -c

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

valeurs acceptées: controller
valeur par défaut: controller
--target-folder -d

Dossier cible pour copier le vidage.

valeur par défaut: ./output/dump
--use-k8s

Utilisez les API Kubernetes locales pour effectuer cette action.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

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 », sous un nom de base de données unique basé sur l’horodatage d’exécution.

--k8s-namespace -k

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

Paramètres facultatifs

--use-k8s

Utilisez les API Kubernetes locales pour effectuer cette action.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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