az vm diagnostics
Настройте расширение диагностики виртуальных машин Azure.
Команды
| Имя | Описание | Тип | Состояние |
|---|---|---|---|
| az vm diagnostics get-default-config |
Получите параметры конфигурации по умолчанию для виртуальной машины. |
Core | GA |
| az vm diagnostics set |
Настройте расширение диагностики виртуальных машин Azure. |
Core | GA |
az vm diagnostics get-default-config
Получите параметры конфигурации по умолчанию для виртуальной машины.
az vm diagnostics get-default-config [--is-windows-os]
Примеры
Получите диагностику по умолчанию для виртуальной машины Linux и переопределите имя учетной записи хранения и идентификатор ресурса виртуальной машины.
az vm diagnostics get-default-config \
| sed "s#__DIAGNOSTIC_STORAGE_ACCOUNT__#MyStorageAccount#g" \
| sed "s#__VM_OR_VMSS_RESOURCE_ID__#MyVmResourceId#g"
Получите диагностику по умолчанию для виртуальной машины Windows.
az vm diagnostics get-default-config --is-windows-os
Необязательные параметры
Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.
Для виртуальных машин Windows.
| Свойство | Значение |
|---|---|
| Default value: | False |
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
| Свойство | Значение |
|---|---|
| Default value: | False |
Показать это сообщение справки и выйти.
Отображать только ошибки, не показывая предупреждения.
| Свойство | Значение |
|---|---|
| Default value: | False |
Формат вывода.
| Свойство | Значение |
|---|---|
| Default value: | json |
| Допустимые значения: | json, jsonc, none, table, tsv, yaml, yamlc |
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.
Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
| Свойство | Значение |
|---|---|
| Default value: | False |
az vm diagnostics set
Настройте расширение диагностики виртуальных машин Azure.
az vm diagnostics set --settings
[--ids]
[--no-auto-upgrade {false, true}]
[--no-auto-upgrade-minor-version {false, true}]
[--protected-settings]
[--resource-group]
[--subscription]
[--version]
[--vm-name]
Примеры
Настройте диагностику по умолчанию на виртуальной машине Linux для графов метрик виртуальных машин портала Azure и коллекции системного журнала.
# Set the following 3 parameters first.
my_resource_group={Resource group name containing your Linux VM and the storage account}
my_linux_vm={Your Azure Linux VM name}
my_diagnostic_storage_account={Your Azure storage account for storing VM diagnostic data}
my_vm_resource_id=$(az vm show -g $my_resource_group -n $my_linux_vm --query "id" -o tsv)
default_config=$(az vm diagnostics get-default-config \
| sed "s#__DIAGNOSTIC_STORAGE_ACCOUNT__#$my_diagnostic_storage_account#g" \
| sed "s#__VM_OR_VMSS_RESOURCE_ID__#$my_vm_resource_id#g")
storage_sastoken=$(az storage account generate-sas \
--account-name $my_diagnostic_storage_account --expiry 2037-12-31T23:59:00Z \
--permissions wlacu --resource-types co --services bt -o tsv)
protected_settings="{'storageAccountName': '$my_diagnostic_storage_account', \
'storageAccountSasToken': '$storage_sastoken'}"
az vm diagnostics set --settings "$default_config" \
--protected-settings "$protected_settings" \
--resource-group $my_resource_group --vm-name $my_linux_vm
Настройте диагностику по умолчанию на виртуальной машине Windows.
# Set the following 3 parameters first.
my_resource_group={Resource group name containing your Windows VM and the storage account}
my_windows_vm={Your Azure Windows VM name}
my_diagnostic_storage_account={Your Azure storage account for storing VM diagnostic data}
my_vm_resource_id=$(az vm show -g $my_resource_group -n $my_windows_vm --query "id" -o tsv)
default_config=$(az vm diagnostics get-default-config --is-windows-os \
| sed "s#__DIAGNOSTIC_STORAGE_ACCOUNT__#$my_diagnostic_storage_account#g" \
| sed "s#__VM_OR_VMSS_RESOURCE_ID__#$my_vm_resource_id#g")
# Please use the same options, the WAD diagnostic extension has strict
# expectations of the sas token's format. Set the expiry as desired.
storage_sastoken=$(az storage account generate-sas \
--account-name $my_diagnostic_storage_account --expiry 2037-12-31T23:59:00Z \
--permissions acuw --resource-types co --services bt --https-only --output tsv)
protected_settings="{'storageAccountName': '$my_diagnostic_storage_account', \
'storageAccountSasToken': '$storage_sastoken'}"
az vm diagnostics set --settings "$default_config" \
--protected-settings "$protected_settings" \
--resource-group $my_resource_group --vm-name $my_windows_vm
# # Alternatively, if the WAD extension has issues parsing the sas token,
# # one can use a storage account key instead.
storage_account_key=$(az storage account keys list --account-name {my_storage_account} \
--query [0].value -o tsv)
protected_settings="{'storageAccountName': '$my_diagnostic_storage_account', \
'storageAccountKey': '$storage_account_key'}"
Обязательные параметры
Строка JSON или путь к файлу, определяющий собираемые данные.
Необязательные параметры
Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.
Один или несколько идентификаторов ресурсов (разделенных пробелами). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах Resource Id. Необходимо указать аргументы --ids или другие параметры 'Resource Id'.
| Свойство | Значение |
|---|---|
| Группа параметров: | Resource Id Arguments |
Параметр "--no-auto-upgrade" устарел и будет удален в будущем выпуске. Вместо этого используйте "--no-auto-upgrade-minor-version".
Если задано, служба расширений не будет автоматически выбирать или обновляться до последней дополнительной версии, даже если расширение повторно развернуто.
| Свойство | Значение |
|---|---|
| Default value: | False |
| Допустимые значения: | false, true |
Если задано, служба расширений не будет автоматически выбирать или обновляться до последней дополнительной версии, даже если расширение повторно развернуто.
| Свойство | Значение |
|---|---|
| Default value: | False |
| Допустимые значения: | false, true |
Строка JSON или путь к файлу, содержащий частные конфигурации, такие как ключи учетной записи хранения и т. д.
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.
| Свойство | Значение |
|---|---|
| Группа параметров: | Resource Id Arguments |
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.
| Свойство | Значение |
|---|---|
| Группа параметров: | Resource Id Arguments |
Версия расширения диагностики. Будет использовать последнюю версию, если она не задана.
Имя виртуальной машины. Вы можете настроить значение по умолчанию с помощью az configure --defaults vm=<name>.
| Свойство | Значение |
|---|---|
| Группа параметров: | Resource Id Arguments |
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
| Свойство | Значение |
|---|---|
| Default value: | False |
Показать это сообщение справки и выйти.
Отображать только ошибки, не показывая предупреждения.
| Свойство | Значение |
|---|---|
| Default value: | False |
Формат вывода.
| Свойство | Значение |
|---|---|
| Default value: | json |
| Допустимые значения: | json, jsonc, none, table, tsv, yaml, yamlc |
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
| Свойство | Значение |
|---|---|
| Default value: | False |