az vm diagnostics

Referenz

Konfigurieren Sie die Azure Virtual Machine Diagnostics-Erweiterung.

Befehle

Name	Beschreibung	Typ	Status
az vm diagnostics get-default-config	Rufen Sie die Standardkonfigurationseinstellungen für einen virtuellen Computer ab.	Kern	GA
az vm diagnostics set	Konfigurieren Sie die Azure VM-Diagnoseerweiterung.	Kern	GA

az vm diagnostics get-default-config

Bearbeiten

Rufen Sie die Standardkonfigurationseinstellungen für einen virtuellen Computer ab.

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

Beispiele

Rufen Sie die Standarddiagnose für einen virtuellen Linux-Computer ab, und überschreiben Sie den Namen des Speicherkontos und die VM-Ressourcen-ID.

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

Rufen Sie die Standarddiagnose für eine Windows-VM ab.

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

Optionale Parameter

--is-windows-os

Für Windows-VMs.

Standardwert: False

Globale Parameter

--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, 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

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az vm diagnostics set

Bearbeiten

Konfigurieren Sie die Azure VM-Diagnoseerweiterung.

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]

Beispiele

Richten Sie die Standarddiagnose auf einer Linux-VM für VM-Metrikdiagramme und syslog-Auflistungen für Azure Portal-VM ein.

# 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

Richten Sie die Standarddiagnose auf einer Windows-VM ein.

# 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'}"

Erforderliche Parameter

--settings

Json-Zeichenfolge oder ein Dateipfad, der daten definiert, die gesammelt werden sollen.

Optionale Parameter

--ids

Mindestens eine Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--no-auto-upgrade

Als veraltet markiert

Option "--no-auto-upgrade" ist veraltet und wird in einer zukünftigen Version entfernt. Verwenden Sie stattdessen "---no-auto-upgrade-minor-version".

Bei Festlegung wählt der Erweiterungsdienst nicht automatisch die neueste Nebenversion aus, auch wenn die Erweiterung erneut bereitgestellt wird.

Zulässige Werte: false, true

Standardwert: False

--no-auto-upgrade-minor-version

Bei Festlegung wählt der Erweiterungsdienst nicht automatisch die neueste Nebenversion aus, auch wenn die Erweiterung erneut bereitgestellt wird.

Zulässige Werte: false, true

Standardwert: False

--protected-settings

Json-Zeichenfolge oder ein Dateipfad, der private Konfigurationen enthält, z. B. Speicherkontoschlüssel usw.

--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--version

Version der Diagnoseerweiterung. Verwendet die neuesten, wenn nicht angegebenen.

--vm-name

Der Name des virtuellen Computers. Sie können die Standardeinstellung mithilfe von az configure --defaults vm=<name>.

Globale Parameter

--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, 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

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Freigeben über

az vm diagnostics

Befehle

az vm diagnostics get-default-config

Beispiele

Optionale Parameter

az vm diagnostics set

Beispiele

Erforderliche Parameter

Optionale Parameter

Zusätzliche Ressourcen