Поделиться через


az arcdata dc debug

Примечание.

Эта ссылка является частью расширения arcdata для Azure CLI (версия 2.3.1 или более поздней). Расширение будет автоматически устанавливаться при первом запуске команды az arcdata dc debug . Подробнее о расширениях.

Контроллер данных отладки.

Команды

Имя Описание Тип Состояние
az arcdata dc debug controldb-cdc

Включение и отключение CDC в базе данных контроллера данных и таблицах — только для устранения неполадок.

Расширение Общедоступная версия
az arcdata dc debug copy-logs

Копирование журналов.

Расширение Общедоступная версия
az arcdata dc debug dump

Создание дампа памяти.

Расширение Общедоступная версия
az arcdata dc debug restore-controldb-snapshot

Восстанавливает уникальную копию ControlDB из резервной копии— только для устранения неполадок.

Расширение Общедоступная версия

az arcdata dc debug controldb-cdc

Включение и отключение CDC в базе данных контроллера данных и таблицах — только для устранения неполадок.

Включение и отключение отслеживания измененных данных для базы данных контроллера и поддерживаемых таблиц с настраиваемыми часами хранения.

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

Примеры

Включает запись измененных данных с 4 часами хранения.

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

Отключает запись измененных данных.

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

Обязательные параметры

--k8s-namespace -k

Пространство имен Kubernetes существующего контроллера данных.

Необязательные параметры

--enable

Включение или отключение отслеживания измененных данных.

допустимые значения: false, true
--retention-hours

Срок хранения CDC, указанный в часах. Допустимые значения: от 1 до 24.

значение по умолчанию: 8
--use-k8s

Для выполнения этого действия используйте локальные API Kubernetes.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az arcdata dc debug copy-logs

Копирование журналов.

Копирование журналов отладки из контроллера данных. В системе должна быть конфигурация Kubernetes.

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]

Обязательные параметры

--k8s-namespace -k

Пространство имен Kubernetes контроллера данных.

Необязательные параметры

--container -c

Копирование журналов для контейнеров с одинаковыми именами. Необязательный параметр. По умолчанию копируются журналы для всех контейнеров. Нельзя указывать несколько раз. Если этот параметр указан несколько раз, используется последний параметр.

--exclude-arcdata-logs

Следует ли исключить журналы служб данных arc из папки результатов. Значение по умолчанию — False, которое включает все журналы контейнеров служб данных arc.

значение по умолчанию: False
--exclude-cluster-info

Следует ли исключить сведения о ресурсах Kubernetes из папки результатов для каждого пространства имен. Значение по умолчанию — False, включающее сведения о ресурсе пространства имен.

значение по умолчанию: False
--exclude-controldb

Следует ли исключить резервную копию controldb из папки результатов. Значение по умолчанию — False, которое включает резервную копию controldb.

значение по умолчанию: False
--exclude-dumps

Следует ли исключать дампы из папки результатов. Значение по умолчанию — false, включающее дампы.

значение по умолчанию: False
--exclude-system-logs

Следует ли исключить журналы пространства имен kube-system и azure-arc из коллекции. Значение по умолчанию — False, которое включает в себя журналы kube-system и connectedk8s, если это доступно.

значение по умолчанию: False
--pod

Копирование журналов для объектов pod с одинаковыми именами. Необязательный параметр. По умолчанию копируются журналы для всех объектов pod. Нельзя указывать несколько раз. Если этот параметр указан несколько раз, используется последний параметр.

--resource-kind

Копирование журналов для ресурса определенного типа. Нельзя указывать несколько раз. Если этот параметр указан несколько раз, используется последний параметр. Если указан этот параметр, то для определения ресурса также должен быть указан параметр --resource-name.

--resource-name

Копирование журналов для ресурса указанного имени. Нельзя указывать несколько раз. Если этот параметр указан несколько раз, используется последний параметр. Если указан этот параметр, то для определения ресурса также должен быть указан параметр --resource-kind.

--skip-compress

Следует ли пропустить сжатие папки результатов. Значение по умолчанию — false, которое сжимает папку результатов.

значение по умолчанию: False
--target-folder -d

Путь к конечной папке, в которую должны копироваться журналы. Необязательный параметр. По умолчанию результаты помещаются в локальную папку. Нельзя указывать несколько раз. Если этот параметр указан несколько раз, используется последний параметр.

--timeout -t

Время ожидания завершения команды в секундах. Значение по умолчанию равно 0, которое является неограниченным.

значение по умолчанию: 0
--use-k8s

Для выполнения этого действия используйте локальные API Kubernetes.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az arcdata dc debug dump

Создание дампа памяти.

Создание дампа памяти и его копирование из контейнера. В системе должна быть конфигурация Kubernetes.

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

Обязательные параметры

--k8s-namespace -k

Пространство имен Kubernetes контроллера данных.

Необязательные параметры

--container -c

Целевой контейнер, запускаемый для создания дампа запущенных процессов.

допустимые значения: controller
значение по умолчанию: controller
--target-folder -d

Целевая папка для копирования дампа.

значение по умолчанию: ./output/dump
--use-k8s

Для выполнения этого действия используйте локальные API Kubernetes.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az arcdata dc debug restore-controldb-snapshot

Восстанавливает уникальную копию ControlDB из резервной копии— только для устранения неполадок.

Восстанавливает COPY_ONLY резервную копию ControlDB с уникальным именем для устранения неполадок. Конфигурация Kubernetes требуется в системе.

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

Примеры

Linux — восстановление резервной копии, взятой из ранее выполняемой команды arcdata dc debug copy-logs.

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

Windows — восстановление резервной копии, взятой из ранее выполняемой команды arcdata dc debug copy-logs.

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

Обязательные параметры

--backup-file -f

Существующий файл резервного копирования базы данных контроллера — должен заканчиваться в формате BAK, будет восстановлен под уникальным именем базы данных на основе метки времени выполнения.

--k8s-namespace -k

Пространство имен Kubernetes существующего контроллера данных.

Необязательные параметры

--use-k8s

Для выполнения этого действия используйте локальные API Kubernetes.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.