Freigeben über

az arcdata dc debug

Note

This reference is part of the arcdata extension for the Azure CLI (version 2.3.1 or higher). Die Erweiterung wird automatisch installiert, wenn Sie ein az arcdata dc debug Befehl ausführen. Learn more about extensions.

Debuggen des Datenverantwortlichen.

Befehle

Name Beschreibung Typ Status
az arcdata dc debug controldb-cdc

Aktivieren/Deaktivieren von CDC für Datenbank und Tabellen des Datenverantwortlichen – nur zu Problembehandlungszwecken.

 Extension GA
az arcdata dc debug copy-logs

Copy logs.

 Extension GA
az arcdata dc debug dump

Speicherabbild auslösen.

 Extension GA
az arcdata dc debug restore-controldb-snapshot

Stellt eine eindeutige Kopie von ControlDB aus der Sicherung wieder her – nur für Problembehandlungszwecke.

 Extension GA

az arcdata dc debug controldb-cdc

Aktivieren/Deaktivieren von CDC für Datenbank und Tabellen des Datenverantwortlichen – nur zu Problembehandlungszwecken.

Aktivieren/Deaktivieren der Änderungsdatenerfassung für "Controller"-Datenbank und unterstützte Tabellen mit konfigurierbaren Aufbewahrungszeiten.

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

Beispiele

Ermöglicht die Änderungsdatenerfassung mit 4 Stunden Aufbewahrung.

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

Deaktiviert die Änderung der Datenerfassung.

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

Erforderliche Parameter

--k8s-namespace -k

Kubernetes-Namespace des vorhandenen Datenverantwortlichen.

Optionale Parameter

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--enable

Aktivieren oder Deaktivieren der Änderungsdatenerfassung.

Eigenschaft Wert
Zulässige Werte: false, true
--retention-hours

CDC-Aufbewahrungszeitraum, der in Stunden angegeben ist. Zulässige Werte sind 1 bis 24.

Eigenschaft Wert
Standardwert: 8
--use-k8s

Verwenden Sie lokale Kubernetes-APIs, um diese Aktion auszuführen.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Output format.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az arcdata dc debug copy-logs

Copy logs.

Kopieren Sie die Debugprotokolle vom Datenverantwortlichen – Kubernetes-Konfiguration ist auf Ihrem System erforderlich.

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]

Erforderliche Parameter

--k8s-namespace -k

Kubernetes-Namespace des Datenverantwortlichen.

Optionale Parameter

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--container -c

Kopieren Sie die Protokolle für die Container mit ähnlichem Namen, optional, standardmäßig Protokolle für alle Container. Es kann nicht mehrmals angegeben werden. Wenn mehrere Male angegeben, wird der letzte verwendet.

--exclude-arcdata-logs

Gibt an, ob Arc Data Services-Protokolle aus dem Ergebnisordner ausgeschlossen werden sollen. Der Standardwert ist False, der alle Containerprotokolle von Arc Data Services enthält.

Eigenschaft Wert
Standardwert: False
--exclude-cluster-info

Gibt an, ob Kubernetes-Ressourceninformationen aus dem Ergebnisordner pro Namespace ausgeschlossen werden sollen. Der Standardwert ist False, der Namespace-Ressourceninformationen enthält.

Eigenschaft Wert
Standardwert: False
--exclude-controldb

Gibt an, ob eine Sicherung von controldb aus dem Ergebnisordner ausgeschlossen werden soll. Der Standardwert ist False, der eine controldb-Sicherung enthält.

Eigenschaft Wert
Standardwert: False
--exclude-dumps

Gibt an, ob Dumps aus dem Ergebnisordner ausgeschlossen werden sollen. Der Standardwert ist False, der Dumps enthält.

Eigenschaft Wert
Standardwert: False
--exclude-system-logs

Gibt an, ob kube-system- und azure-arc-Namespaceprotokolle aus der Sammlung ausgeschlossen werden sollen. Der Standardwert ist "False", der kube-system- und connectedk8s-Protokolle enthält, sofern auf sie zugegriffen werden kann.

Eigenschaft Wert
Standardwert: False
--pod

Kopieren Sie die Protokolle für die Pods mit einem ähnlichen Namen. Optional, kopiert standardmäßig Protokolle für alle Pods. Es kann nicht mehrmals angegeben werden. Wenn mehrere Male angegeben, wird der letzte verwendet.

--resource-kind

Kopieren Sie die Protokolle für die Ressource einer bestimmten Art. Es kann nicht mehrmals angegeben werden. Wenn mehrere Male angegeben, wird der letzte verwendet. Wenn angegeben, sollte auch "--resource-name" angegeben werden, um die Ressource zu identifizieren.

--resource-name

Kopieren Sie die Protokolle für die Ressource des angegebenen Namens. Es kann nicht mehrmals angegeben werden. Wenn mehrere Male angegeben, wird der letzte verwendet. Falls angegeben, sollte auch "--resource-kind" angegeben werden, um die Ressource zu identifizieren.

--skip-compress

Gibt an, ob das Komprimieren des Ergebnisordners übersprungen werden soll. Der Standardwert ist False, der den Ergebnisordner komprimiert.

Eigenschaft Wert
Standardwert: False
--target-folder -d

Zielordnerpfad zum Kopieren von Protokollen in. Optional, erstellt standardmäßig das Ergebnis im lokalen Ordner. Es kann nicht mehrmals angegeben werden. Wenn mehrere Male angegeben, wird der letzte verwendet.

--timeout -t

Die Anzahl der Sekunden, bis der Befehl abgeschlossen ist. Der Standardwert ist 0, der unbegrenzt ist.

Eigenschaft Wert
Standardwert: 0
--use-k8s

Verwenden Sie lokale Kubernetes-APIs, um diese Aktion auszuführen.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Output format.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az arcdata dc debug dump

Speicherabbild auslösen.

Auslösen des Speicherabbilds und Kopieren des Speicherabbilds aus containern – Kubernetes-Konfiguration ist auf Ihrem System erforderlich.

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

Erforderliche Parameter

--k8s-namespace -k

Kubernetes-Namespace des Datenverantwortlichen.

Optionale Parameter

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--container -c

Der Zielcontainer, der für das Dumping der ausgeführten Prozesse ausgelöst werden soll.

Eigenschaft Wert
Standardwert: controller
Zulässige Werte: controller
--target-folder -d

Zielordner zum Kopieren des Dumps.

Eigenschaft Wert
Standardwert: ./output/dump
--use-k8s

Verwenden Sie lokale Kubernetes-APIs, um diese Aktion auszuführen.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Output format.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az arcdata dc debug restore-controldb-snapshot

Stellt eine eindeutige Kopie von ControlDB aus der Sicherung wieder her – nur für Problembehandlungszwecke.

Stellt eine COPY_ONLY Sicherung von ControlDB unter einem eindeutigen Namen für die Problembehandlung wieder her – Kubernetes-Konfiguration ist auf Ihrem System erforderlich.

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

Beispiele

Linux : Wiederherstellen einer Sicherung aus einem zuvor ausgeführten Befehl "arcdata dc debug copy-logs".

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

Windows – Wiederherstellen einer Sicherung aus einem zuvor ausgeführten Befehl "arcdata dc debug copy-logs".

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

Erforderliche Parameter

--backup-file -f

Vorhandene Controllerdatenbank-Sicherungsdatei – muss in ".bak" enden, wird basierend auf dem Ausführungszeitstempel unter einem eindeutigen Datenbanknamen wiederhergestellt.

--k8s-namespace -k

Kubernetes-Namespace des vorhandenen Datenverantwortlichen.

Optionale Parameter

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--use-k8s

Verwenden Sie lokale Kubernetes-APIs, um diese Aktion auszuführen.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Output format.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False