Share via

az arcdata dc debug

  • Referenz

Hinweis

Diese Referenz ist Teil der Arcdata-Erweiterung für die Azure CLI (Version 2.3.1 oder höher). Die Erweiterung wird automatisch installiert, wenn Sie einen az arcdata dc debug-Befehl zum ersten Mal ausführen. Weitere Informationen zu Erweiterungen

Dient zum Debuggen des Datencontrollers.

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.

 Durchwahl Allgemein verfügbar
az arcdata dc debug copy-logs

Kopieren von Protokollen.

 Durchwahl Allgemein verfügbar
az arcdata dc debug dump

Auslösen eines Speicherabbilds

 Durchwahl Allgemein verfügbar
az arcdata dc debug restore-controldb-snapshot

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

 Durchwahl Allgemein verfügbar

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

--enable

Aktivieren oder Deaktivieren der Änderungsdatenerfassung.

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

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

Standardwert: 8
--use-k8s

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

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az arcdata dc debug copy-logs

Kopieren von Protokollen.

Hiermit werden die Debugprotokolle aus dem Datencontroller kopiert – auf Ihrem System ist eine Kubernetes-Konfiguration 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 Datencontrollers

Optionale Parameter

--container -c

Kopieren Sie die Protokolle für die Container mit ähnlichem Namen. Standardmäßig werden die Protokolle für alle Container kopiert. Dieser Parameter kann nicht mehrfach angegeben werden. Ist er mehrfach angegeben, wird der letzte Parameter 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.

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.

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.

Standardwert: False
--exclude-dumps

Gibt an, ob Sicherungsdateien aus dem resultierenden Ordner ausgeschlossen werden sollen Der Standardwert ist „False“. Dadurch werden Sicherungsdateien eingeschlossen.

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.

Standardwert: False
--pod

Kopieren Sie die Protokolle für die Pods mit ähnlichem Namen. Optional. Standardmäßig werden die Protokolle für alle Pods kopiert. Dieser Parameter kann nicht mehrfach angegeben werden. Ist er mehrfach angegeben, wird der letzte Parameter verwendet.

--resource-kind

Kopieren Sie die Protokolle für eine bestimmte Art von Ressource. Dieser Parameter kann nicht mehrfach angegeben werden. Ist er mehrfach angegeben, wird der letzte Parameter verwendet. Wenn dieser Parameter angegeben ist, sollte zum Identifizieren der Ressource auch --resource-name angegeben werden.

--resource-name

Kopieren Sie die Protokolle für die Ressource mit dem angegebenen Namen. Dieser Parameter kann nicht mehrfach angegeben werden. Ist er mehrfach angegeben, wird der letzte Parameter verwendet. Wenn dieser Parameter angegeben ist, sollte zum Identifizieren der Ressource auch --resource-kind angegeben werden.

--skip-compress

Gibt an, ob die Komprimierung des resultierenden Ordners übersprungen werden soll Der Standardwert ist „False“. Dadurch wird der resultierende Ordner komprimiert.

Standardwert: False
--target-folder -d

Der Pfad des Zielordners, in den die Protokolle kopiert werden sollen. Optional. Standardmäßig wird das Ergebnis im lokalen Ordner erstellt. Dieser Parameter kann nicht mehrfach angegeben werden. Ist er mehrfach angegeben, wird der letzte Parameter verwendet.

--timeout -t

Die Zeit in Sekunden, während der auf das Abschließen des Befehls gewartet wird. Der Standardwert ist 0, der unbegrenzt ist.

Standardwert: 0
--use-k8s

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

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az arcdata dc debug dump

Auslösen eines Speicherabbilds

Lösen Sie ein Speicherabbild aus, und kopieren Sie es aus dem Container. Hierfür ist eine Kubernetes-Konfiguration 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 Datencontrollers

Optionale Parameter

--container -c

Hierbei handelt es sich um den Zielcontainer, der zum Sichern der aktiven Prozesse ausgelöst werden soll.

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

Zielordner zum Kopieren des Dumps.

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

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

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

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 unter einem eindeutigen Datenbanknamen basierend auf dem Ausführungszeitstempel wiederhergestellt.

--k8s-namespace -k

Kubernetes-Namespace des vorhandenen Datenverantwortlichen.

Optionale Parameter

--use-k8s

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

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.