Azure Yerel sorunlarını gidermek için Destek Tanılama Aracı'nı kullanın

Makale
11/23/2024

Şunlar için geçerlidir: Azure Yerel, sürüm 23H2

Bu makale, Azure Yerel Destek Tanılama Aracı'nı indirme ve kullanma hakkında bilgi sağlar. Araç, veri toplama, sorun giderme ve yaygın sorunların çözümünü basitleştirmeye yönelik bir dizi PowerShell komutudur.

Bu araç, uzman bilgisinin yerini tutmaz. Herhangi bir sorunla karşılaşırsanız yardım için Microsoft Desteği başvurun.

Sosyal haklar

Azure Yerel Destek Tanılama Aracı, uzman ürün bilgisi olmadan sorunları belirlemek için basit komutları kullanır.

Araç aşağıdakileri sağlar:

Kolay yükleme ve güncelleştirmeler: ek gereksinimler olmadan PowerShell Galerisi kullanarak yerel olarak yükleyin ve güncelleştirin.
Tanılama denetimleri: Yaygın sorunlar, olaylar ve telemetri verileri temelinde tanılama denetimleri sağlar.
Otomatik veri toplama: Microsoft Desteği sağlamak için önemli verileri otomatik olarak toplar.
Düzenli güncelleştirmeler: Azure Yerel'de sorunları yönetmek, gidermek ve tanılamak için yeni denetimler ve yararlı komutlar içeren güncelleştirmeler.

Önkoşullar

PowerShell modülünü kullanmadan önce şunları yaptığınızdan emin olun:

PowerShell Galerisi Azure Yerel Destek Tanılama Aracı'nı indirin.
Modülü, yerel sistemde yönetici ayrıcalıklarına sahip bir hesap kullanarak yükseltilmiş bir PowerShell penceresine aktarın. Daha fazla bilgi için bkz . PowerShell Modülünü İçeri Aktarma.
Modülü Azure Yerel sisteminin her düğümüne yükleyin. Düğüme bağlanma hakkında bilgi için bkz . RDP'yi etkinleştirme.

Azure Yerel Destek Tanılama Aracı'nı yükleme ve kullanma

PowerShell'i yönetici olarak çalıştırın ve ardından aşağıdaki komutları çalıştırın:

Aracı yüklemek için aşağıdaki komutu çalıştırın:

Install-Module –Name Microsoft.AzureStack.HCI.CSSTools

Tüm kullanılabilir tanılama denetimlerini listelemek için aşağıdaki komutu çalıştırın:

Invoke-AzsSupportDiagnosticCheck –ProductName <BaseSystem, Registration>

parametresinden ProductNamesonra tuşuna basarak CTRL+SPACE tüm tanılama denetimlerini çalıştırın.

Önceden tanımlanmış koleksiyon kümelerimizden birini kullanarak veri toplamak için aşağıdaki komutu çalıştırın:

New-AzsSupportDataBundle –Component <Component>

Tüm veri toplama kümelerini denetlemek için parametresinden Componentsonra tuşuna basınCTRL+SPACE.

Kendi veri kümenizi toplamak için aşağıdaki komutu çalıştırın:

$ClusterCommands = @(<clusterCommand1>,<clusterCommand2>)
$nodeCommands = @(<nodeCommand1>,<nodeCommand2>)
$nodeEvents = @(<eventLogName1>,<eventLogName2>)
$nodeRegistry = @(<registryPath1>,<registryPath2>)
$nodeFolders = @(<folderPath1>,<folderPath2>)


New-AzsSupportDataBundle -ClusterCommands $clusterCommands `
-NodeCommands $nodeCommands `
-NodeEvents $nodeEvents `
-NodeRegistry $nodeRegistry `
-NodeFolders $nodeFolders `
-ComputerName @(<computerName1>,<computerName2>)

Örnek senaryo

Azure Yerel sorunlarını gidermek için aşağıdaki komutları çalıştırın:

Dağıtım sorunları için

Başarıyla yürütülen adımlar, atlanan adımlar ve hata ayrıntıları da dahil olmak üzere dağıtımınız hakkında ayrıntılı bir rapor oluşturmak için aşağıdaki komutu çalıştırın:

Get-AzsSupportEceDeploymentDetails

Güncelleştirme veya yükseltme sorunları için

Get-AzsSupportEceUpdateDetails

Kayıt sorunları için

Invoke-AzsSupportDiagnosticCheck -ProductName Registration

Aşağıda kayıt sorununa yönelik bir çıktı örneği verilmişti:

PS C:\temp> Invoke-AzsSupportDiagnosticCheck -ProductName Registration
Starting known issue check for Azure Stack HCI: Registration.                                                                                                       
Starting Azure Stack HCI base system validation.                                                                                                                        
Gathering information from all clustered nodes.                                                                                                                         
We are preparing to collect diagnostic information from your environment                                                                                                
We started the diagnostic data collection! This might take some time.                                                                                                   
Finished collecting diagnostic information.                                                                                                                             
====[ Validating registration state on node: HCI-N-1 ]====                                                                                                              
[Pass] [Azure Stack HCI - General registration state]                                                                                                                   
Validate that the cluster is registered
Details: Validation successfull

[Fail] [Azure Stack HCI - Azure Connection state]
Validate that the cluster is in a connected state
Details: This Azure Stack HCI node does not seem to be connected to azure. Ensure that this node is in a connected state.
Documentation: https://learn.microsoft.com/en-us/azure-stack/hci/deploy/troubleshoot-hci-registration.

[Pass] [Azure Arc Agent - Connection state]
Validate that the azure arc agent is connected
Details: Validation successfull

[Pass] [Azure Arc Agent - Service state]
Validate that all azure arc services are running
Details: Validation successfull

[Pass] [Azure Arc Agent - Heartbeat state]
Validate that the azure arc agent has sent out a heartbeat at least a day ago
Details: Validation successfull

[Pass] [Azure Stack HCI - Arc Agent onboarded]
Validate that all arc agent checks are passed
Details: Validation successfull

[Fail] [Validation summary]

Details: At least one node reported an invalid registration state.

We will collect log information from your envirorment.
Creating local storage container for diagnostic data.
Gathering cluster data ... this might take a while.
Cluster data collection complete.
We are preparing to collect diagnostic information from your environment
We started the diagnostic data collection! This might take some time.
Waiting for all diagnostic output to be generated and compressed ... this might take a while.
Finished collecting diagnostic information.
Starting copy of items ... this might take a while.
All items copied.
Successfully created archive C:\temp\6c5a4685-6e32-4b68-aeec-05475f8d6c6f\log-collection-RegistrationInformation07-22_06-03-2024.zip. Removing raw data C:\temp\6c5a4685-6e32-4b68-aeec-05475f8d6c6f\container.
Data collection done . Please upload the file to the Microsoft Workspace.

Temel Azure Yerel sistem sorunları için

Invoke-AzsSupportDiagnosticCheck -ProductName BaseSystem

Aşağıda temel sistem sorunlarına yönelik bir çıktı örneği verilmişti:

PS C:\temp> Invoke-AzsSupportDiagnosticCheck -ProductName BaseSystem
Starting known issue check for Azure Stack HCI: BaseSystem.
Gathering information from all clustered nodes.
We are preparing to collect diagnostic information from your environment
We started the diagnostic data collection! This might take some time.
Starting to validate cluster settings.
[Pass] [Failover Clustering - Cluster validation report contains no errors]
Validate that there are no critical errors in the cluster validation report
Details: Validation successfull

[Pass] [Failover Clustering - Cluster Networks have redundancy]
Validate that we have redundancy in clustered networks
Details: Validation successfull

[Pass] [Failover Clustering - Validation Summary]
Validate that there are no critical issues in our cluster validation report.
Details: Validation successfull

Collecting node data.
Finished collecting diagnostic information.
====[ Validating data from node: HCI-N-1 ]====
[Pass] [Windows Features - All windows features installed]
Verify that all features required for Azure Local are installed.
Details: Validation successfull

[Pass] [Validation summary]
Ensure that no other check has returned a failed state
Details: Validation successfull

Daha sonra, düzgün bağlanmış Azure Yerel sistemleri için gereken farklı bileşenlere kapsamlı bir genel bakış oluşturulur. Bu genel bakışı temel alarak sorun giderme yönergelerini izleyebilir veya yardım için Microsoft Desteği ulaşabilirsiniz.

Veri toplamak için aşağıdaki iki örnek senaryoya bakın:

Otomatik veri toplama için

New-AzsSupportDataBundle -Component OS
==== CUT ==================== CUT =======
Data collection done C:\temp\Azs.Support\XXXXXXX\SupportDataBundle-XX-XX_XX-XX-XXXX.zip . Please upload the file to the Microsoft Workspace

El ile veri toplama için

$ClusterCommands = @()
$nodeCommands = @('Get-AzureStackHci','Get-AzureStackHCIArcIntegration','Get-ClusteredScheduledTask | fl *','systeminfo.exe')
$nodeEvents = @('system','application','Microsoft-AzureStack-HCI/Admin')
$nodeRegistry = @('HKLM:\Cluster\ArcForServers')
$nodeFolders = @('C:\Windows\Tasks\ArcforServers\','C:\ProgramData\AzureConnectedMachineAgent\Log\')

New-AzsSupportDataBundle -ClusterCommands $clusterCommands `
-NodeCommands $nodeCommands `
-NodeEvents $nodeEvents `
-NodeRegistry $nodeRegistry `
-NodeFolders $nodeFolders `
-ComputerName (Get-ClusterNode)

==== CUT ==================== CUT =======
Data collection done C:\temp\Azs.Support\XXXXXXX\SupportDataBundle-XX-XX_XX-XX-XXXX.zip . Please upload the file to the Microsoft Workspace.

Sorularınız mı yoksa Geri Bildirim mi?

Bir sorununuz mu var? Azure Yerel Destek Tanılama Aracı hakkındaki geri bildirimleri bizimle paylaşmak ister misiniz? Dinliyoruz! Geri bildirim göndermek için PSGallery içindeki "kişi sahipleri" seçeneğini kullanın.

Sonraki adımlar

İlgili bilgiler için ayrıca bkz:

Azure Yerel için destek alın.

Aracılığıyla paylaş