az vm diagnostics

Configurez l’extension de diagnostic de machine virtuelle Azure.

Commandes

Nom	Description	Type	État
az vm diagnostics get-default-config	Obtenez les paramètres de configuration par défaut d’une machine virtuelle.	Core	GA
az vm diagnostics set	Configurez l’extension de diagnostic de machine virtuelle Azure.	Core	GA

az vm diagnostics get-default-config

Modifier

Obtenez les paramètres de configuration par défaut d’une machine virtuelle.

az vm diagnostics get-default-config [--acquire-policy-token]
                                     [--change-reference]
                                     [--is-windows-os]

Exemples

Obtenez les diagnostics par défaut pour une machine virtuelle Linux et remplacez le nom du compte de stockage et l’ID de ressource de machine virtuelle.

az vm diagnostics get-default-config \
    | sed "s#__DIAGNOSTIC_STORAGE_ACCOUNT__#MyStorageAccount#g" \
    | sed "s#__VM_OR_VMSS_RESOURCE_ID__#MyVmResourceId#g"

Obtenez les diagnostics par défaut pour une machine virtuelle Windows.

az vm diagnostics get-default-config --is-windows-os

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--acquire-policy-token

Acquisition automatique d’un jeton Azure Policy pour cette opération de ressource.

Propriété	Valeur
Groupe de paramètres:	Global Policy Arguments

--change-reference

ID de référence de modification associé pour cette opération de ressource.

Propriété	Valeur
Groupe de paramètres:	Global Policy Arguments

--is-windows-os

Pour les machines virtuelles Windows.

Propriété	Valeur
Valeur par défaut:	False

Paramètres globaux

--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété	Valeur
Valeur par défaut:	False

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété	Valeur
Valeur par défaut:	False

--output -o

Format de sortie.

Propriété	Valeur
Valeur par défaut:	json
Valeurs acceptées:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété	Valeur
Valeur par défaut:	False

az vm diagnostics set

Modifier

Configurez l’extension de diagnostic de machine virtuelle Azure.

az vm diagnostics set --settings
                      [--acquire-policy-token]
                      [--change-reference]
                      [--ids]
                      [--no-auto-upgrade {false, true}]
                      [--no-auto-upgrade-minor-version {false, true}]
                      [--protected-settings]
                      [--resource-group]
                      [--subscription]
                      [--version]
                      [--vm-name]

Exemples

Configurez les diagnostics par défaut sur une machine virtuelle Linux pour Portail Azure graphiques de métriques de machine virtuelle et la collecte syslog.

# 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

Configurez les diagnostics par défaut sur une machine virtuelle 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'}"

Paramètres obligatoires

--settings

Chaîne Json ou chemin d’accès de fichier, qui définit les données à collecter.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--acquire-policy-token

Acquisition automatique d’un jeton Azure Policy pour cette opération de ressource.

Propriété	Valeur
Groupe de paramètres:	Global Policy Arguments

--change-reference

ID de référence de modification associé pour cette opération de ressource.

Propriété	Valeur
Groupe de paramètres:	Global Policy Arguments

--ids

Un ou plusieurs ID de ressource (délimités par l’espace). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

Propriété	Valeur
Groupe de paramètres:	Resource Id Arguments

--no-auto-upgrade

Déprécié

L’option « --no-auto-upgrade » a été déconseillée et sera supprimée dans une prochaine version. Utilisez plutôt « --no-auto-upgrade-minor-version ».

Si elle est définie, le service d’extension ne sélectionne pas ou ne met pas automatiquement à niveau vers la dernière version mineure, même si l’extension est redéployée.

Propriété	Valeur
Valeur par défaut:	False
Valeurs acceptées:	false, true

--no-auto-upgrade-minor-version

Si elle est définie, le service d’extension ne sélectionne pas ou ne met pas automatiquement à niveau vers la dernière version mineure, même si l’extension est redéployée.

Propriété	Valeur
Valeur par défaut:	False
Valeurs acceptées:	false, true

--protected-settings

Chaîne Json ou chemin d’accès de fichier contenant des configurations privées telles que des clés de compte de stockage, etc.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Propriété	Valeur
Groupe de paramètres:	Resource Id Arguments

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

Propriété	Valeur
Groupe de paramètres:	Resource Id Arguments

--version

Version de l’extension diagnostics. Utilise la dernière version si elle n’est pas spécifiée.

--vm-name

Nom de la machine virtuelle. Vous pouvez configurer la valeur par défaut à l’aide az configure --defaults vm=<name>de .

Propriété	Valeur
Groupe de paramètres:	Resource Id Arguments