Freigeben über

Aktivieren der Diagnose mithilfe von PowerShell in Azure Cloud Services (klassisch)

  • Artikel

Wichtig

Cloud Services (klassisch) ist jetzt ab dem 1. September 2024 für alle Kunden veraltet. Alle vorhandenen ausgeführten Bereitstellungen werden beendet und von Microsoft heruntergefahren, und die Daten sind ab Oktober 2024 dauerhaft verloren. In neuen Bereitstellungen sollte das neue auf Azure Resource Manager basierende Bereitstellungsmodell für Azure Cloud Services (erweiterter Support) verwendet werden.

Mit der Azure-Diagnoseerweiterung können Sie Diagnosedaten wie Anwendungsprotokolle, Leistungsindikatoren usw. von einem Clouddienst sammeln. In diesem Artikel wird beschrieben, wie Sie die Azure-Diagnoseerweiterung für einen Clouddienst mithilfe von PowerShell aktivieren. Informationen zu den erforderlichen Komponenten für diesen Artikel finden Sie unter Installieren und Konfigurieren von Azure PowerShell.

Aktivieren der Diagnoseerweiterung bei der Bereitstellung eines Clouddiensts

Dieser Ansatz eignet sich für Szenarien mit fortlaufender Integration, bei denen die Diagnoseerweiterung im Rahmen der Bereitstellung von Clouddiensten aktiviert werden kann. Beim Erstellen einer neuen Clouddienstbereitstellung können Sie die Diagnoseerweiterung aktivieren, indem Sie den ExtensionConfiguration -Parameter an das Cmdlet New-AzureDeployment übergeben. Der ExtensionConfiguration -Parameter akzeptiert ein Array von Diagnosekonfigurationen, die Sie mit dem Cmdlet New-AzureServiceDiagnosticsExtensionConfig erstellen können.

Das folgende Beispiel zeigt, wie Sie die Diagnose für einen Clouddienst mit einer Webrolle und einer Workerrolle mit jeweils unterschiedlicher Diagnosekonfiguration aktivieren können.

$service_name = "MyService"
$service_package = "CloudService.cspkg"
$service_config = "ServiceConfiguration.Cloud.cscfg"
$webrole_diagconfigpath = "MyService.WebRole.PubConfig.xml"
$workerrole_diagconfigpath = "MyService.WorkerRole.PubConfig.xml"

$webrole_diagconfig = New-AzureServiceDiagnosticsExtensionConfig -Role "WebRole" -DiagnosticsConfigurationPath $webrole_diagconfigpath
$workerrole_diagconfig = New-AzureServiceDiagnosticsExtensionConfig -Role "WorkerRole" -DiagnosticsConfigurationPath $workerrole_diagconfigpath

New-AzureDeployment -ServiceName $service_name -Slot Production -Package $service_package -Configuration $service_config -ExtensionConfiguration @($webrole_diagconfig,$workerrole_diagconfig)

Falls in der Diagnosekonfigurationsdatei ein StorageAccount-Element mit einem Speicherkontonamen angegeben ist, verwendet das Cmdlet New-AzureServiceDiagnosticsExtensionConfig automatisch dieses Speicherkonto. Damit diese Konfiguration funktioniert, muss das Speicherkonto allerdings demselben Abonnement angehören wie der bereitgestellte Clouddienst.

Ab Azure SDK 2.6 enthalten die von der MSBuild-Veröffentlichungszielausgabe generierten Erweiterungskonfigurationsdateien den Speicherkontonamen basierend auf der Diagnosekonfigurations-Zeichenfolge, die in der Dienstkonfigurationsdatei (CSCFG) angegeben ist. Das folgende Skript veranschaulicht das Analysieren der Erweiterungskonfigurationsdateien aus der Veröffentlichungszielausgabe und das Konfigurieren der Diagnoseerweiterung für jede Rolle, wenn der Clouddienst bereitgestellt wird.

$service_name = "MyService"
$service_package = "C:\build\output\CloudService.cspkg"
$service_config = "C:\build\output\ServiceConfiguration.Cloud.cscfg"

#Find the Extensions path based on service configuration file
$extensionsSearchPath = Join-Path -Path (Split-Path -Parent $service_config) -ChildPath "Extensions"

$diagnosticsExtensions = Get-ChildItem -Path $extensionsSearchPath -Filter "PaaSDiagnostics.*.PubConfig.xml"
$diagnosticsConfigurations = @()
foreach ($extPath in $diagnosticsExtensions)
{
    #Find the RoleName based on file naming convention PaaSDiagnostics.<RoleName>.PubConfig.xml
    $roleName = ""
    $roles = $extPath -split ".",0,"simplematch"
    if ($roles -is [system.array] -and $roles.Length -gt 1)
    {
        $roleName = $roles[1]
        $x = 2
        while ($x -le $roles.Length)
            {
               if ($roles[$x] -ne "PubConfig")
                {
                    $roleName = $roleName + "." + $roles[$x]
                }
                else
                {
                    break
                }
                $x++
            }
        $fullExtPath = Join-Path -path $extensionsSearchPath -ChildPath $extPath
        $diagnosticsconfig = New-AzureServiceDiagnosticsExtensionConfig -Role $roleName -DiagnosticsConfigurationPath $fullExtPath
        $diagnosticsConfigurations += $diagnosticsconfig
    }
}
New-AzureDeployment -ServiceName $service_name -Slot Production -Package $service_package -Configuration $service_config -ExtensionConfiguration $diagnosticsConfigurations

Der Visual Studio-Codespace verwendet einen ähnlichen Ansatz für automatisierte Bereitstellungen von Clouddiensten mit der Diagnoseerweiterung. Unter Publish-AzureCloudDeployment.ps1 finden Sie ein vollständiges Beispiel.

Wenn in der Diagnosekonfiguration kein StorageAccount angegeben wurde, müssen Sie den StorageAccountName-Parameter an das Cmdlet übergeben. Bei Angabe des Parameters StorageAccountName verwendet das Cmdlet das im Parameter angegebene Speicherkonto und nicht das in der Diagnosekonfigurationsdatei angegebene.

Wenn das Diagnosespeicherkonto einem anderen Abonnement angehört als der Clouddienst, müssen die Parameter StorageAccountName und StorageAccountKey explizit an das Cmdlet übergeben werden. Der Parameter StorageAccountKey ist nicht erforderlich, wenn das Diagnosespeicherkonto demselben Abonnement angehört, da das Cmdlet beim Aktivieren der Diagnoseerweiterung den Schlüsselwert automatisch abfragen und festlegen kann. Gehört das Diagnosespeicherkonto dagegen einem anderen Abonnement an, kann das Cmdlet den Schlüssel unter Umständen nicht automatisch abrufen, weshalb er in diesem Fall explizit über den Parameter StorageAccountKey angegeben werden muss.

$webrole_diagconfig = New-AzureServiceDiagnosticsExtensionConfig -Role "WebRole" -DiagnosticsConfigurationPath $webrole_diagconfigpath -StorageAccountName $diagnosticsstorage_name -StorageAccountKey $diagnosticsstorage_key
$workerrole_diagconfig = New-AzureServiceDiagnosticsExtensionConfig -Role "WorkerRole" -DiagnosticsConfigurationPath $workerrole_diagconfigpath -StorageAccountName $diagnosticsstorage_name -StorageAccountKey $diagnosticsstorage_key

Aktivieren der Diagnoseerweiterung für einen vorhandenen Clouddienst

Mit dem Cmdlet Set-AzureServiceDiagnosticsExtension können Sie die Diagnosekonfiguration für einen Clouddienst aktivieren oder aktualisieren, der bereits ausgeführt wird.

Warnung

Wenn Sie die Diagnose für eine vorhandene Rolle aktivieren, werden alle Erweiterungen, die Sie festgelegt haben, beim Bereitstellen des Pakets deaktiviert. Dazu gehören:

  • Microsoft Monitoring Agent-Diagnose
  • Microsoft Azure-Sicherheitsüberwachung
  • Microsoft Antimalware
  • Microsoft Monitoring Agent
  • Microsoft-Dienst-Profiler-Agent
  • Windows Azure-Domänenerweiterung
  • Windows Azure-Diagnoseerweiterung
  • Windows Azure-Remotedesktoperweiterung
  • Windows Azure Log Collector

Sie können Ihre Erweiterungen über das Azure-Portal oder PowerShell zurücksetzen, nachdem Sie die aktualisierte Rolle bereitgestellt haben.

$service_name = "MyService"
$webrole_diagconfigpath = "MyService.WebRole.PubConfig.xml"
$workerrole_diagconfigpath = "MyService.WorkerRole.PubConfig.xml"

$webrole_diagconfig = New-AzureServiceDiagnosticsExtensionConfig -Role "WebRole" -DiagnosticsConfigurationPath $webrole_diagconfigpath
$workerrole_diagconfig = New-AzureServiceDiagnosticsExtensionConfig -Role "WorkerRole" -DiagnosticsConfigurationPath $workerrole_diagconfigpath

Set-AzureServiceDiagnosticsExtension -DiagnosticsConfiguration @($webrole_diagconfig,$workerrole_diagconfig) -ServiceName $service_name

Abrufen der aktuellen Konfiguration der Diagnoseerweiterung

Mit dem Cmdlet Get-AzureServiceDiagnosticsExtension können Sie die aktuelle Diagnosekonfiguration für einen Clouddienst abrufen.

Get-AzureServiceDiagnosticsExtension -ServiceName "MyService"

Entfernen der Diagnoseerweiterung

Sie können zum Deaktivieren der Diagnose für einen Clouddienst das Cmdlet Remove-AzureServiceDiagnosticsExtension verwenden.

Remove-AzureServiceDiagnosticsExtension -ServiceName "MyService"

Wenn Sie die Diagnoseerweiterung entweder mit Set-AzureServiceDiagnosticsExtension oder mit New-AzureServiceDiagnosticsExtensionConfig ohne den Role-Parameter aktiviert haben, können Sie die Erweiterung mit Remove-AzureServiceDiagnosticsExtension ohne den Role-Parameter entfernen. Wenn beim Aktivieren der Erweiterung der Role -Parameter verwendet wurde, muss er auch zum Entfernen der Erweiterung verwendet werden.

So entfernen Sie die Diagnoseerweiterung aus jeder einzelnen Rolle

Remove-AzureServiceDiagnosticsExtension -ServiceName "MyService" -Role "WebRole"

Nächste Schritte