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

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.

Default value: 8
--use-k8s

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

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

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

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

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

--output -o

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

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: 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.

Default value: False
--exclude-cluster-info

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

Default value: False
--exclude-controldb

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

Default value: False
--exclude-dumps

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

Default value: False
--exclude-system-logs

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

Default value: False
--pod

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

--resource-kind

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

--resource-name

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

--skip-compress

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

Default value: False
--target-folder -d

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

--timeout -t

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

Default value: 0
--use-k8s

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

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

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

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

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

--output -o

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

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: 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
Default value: controller
--target-folder -d

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

Default value: ./output/dump
--use-k8s

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

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

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

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

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

--output -o

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

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: 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
Default value: json
--query

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

--subscription

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

--verbose

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