PowerShell'i günlük toplama için kullanmak için Azure Stack HCI kümesindeki herhangi bir düğümden cmdlet'ini çalıştırın Send-DiagnosticData . Bu cmdlet günlükleri geçici olarak yerel olarak kopyalar. Kopyalanan günlükler ayrıştırılır, Microsoft'a gönderilir ve sisteminizden silinir.
PowerShell kullanarak günlükleri toplarken göz önünde bulundurmanız gereken bazı önemli noktalar şunlardır:
- Cmdlet'in
Send-DiagnosticData tamamlanma süresi, günlüklerin toplandığı roller, belirtilen süre ve Azure Stack HCI ortamınızdaki düğüm sayısı gibi faktörlere bağlı olarak değişir.
- Herhangi bir parametre belirtmezseniz,
Send-DiagnosticData cmdlet önceki bir saatlik süre boyunca tüm düğümlerden veri toplar.
söz dizimi şöyledir Send-DiagnosticData:
Send-DiagnosticData [[-FilterByRole] <string[]>] [[-FromDate] <datetime>] [[-ToDate] <datetime>] [[-CollectSddc] <bool>] [<CommonParameters>]
hakkında Send-DiagnosticDatabaşvuru bilgileri için bu makalenin devamında yer alan Send-DiagnosticData komut başvurusu bölümüne bakın.
Örnekler ve örnek çıkışlar
Burada, cmdlet'in farklı parametrelerle nasıl kullanılacağını Send-DiagnosticData gösteren örnek çıkışlara sahip bazı örnek komutlar verilmiştir.
Tarih filtreleme ile tanılama verilerini gönderme
Bu örnekte, son iki saat için günlük dosyaları için tarih filtreleme ile tanılama verileri gönderirsiniz:
Send-DiagnosticData -FromDate (Get-Date).AddHours(-2) -ToDate (Get-Date)
Bu komutun örnek çıktısı aşağıda verilmişti:
PS C:\CloudDeployment\logs> Send-DiagnosticData -FromDate (Get-Date).AddHours(-2) -ToDate (Get-Date)
Converting FromDate and ToDate to UTC
FromDate in UTC is now 12/04/2023 19:14:18. ToDate in UTC is now 12/04/2023 21:14:18
The correlation Id is <Correlation-ID>. This is used to query for this log collection in the diagnostic pipeline.
Provide the below information to the customer support engineer working on your case.
AEORegion: eastus
AEODeviceARMResourceUri: /Subscriptions/<Subscription-ID>/resourceGroups/EDGECI-REGISTRATION/providers/Microsoft.AzureStackHCI/clusters/<cluster-name>
AEOClusterNodeArcResourceUri: /subscriptions/<Subscription-ID>/resourceGroups/EDGECI-REGISTRATION/providers/Microsoft.HybridCompute/machines/<v-host-name>
CorrelationId: <Correlation-ID>
Observability Agent is running.
Successfully submitted on-demand. Log collection Job Id: <Job-ID>. This is used to track the log collection with Get-LogCollectionHistory.
Current log collection status: Running
Waiting for log collection to complete...
==== CUT ==================== CUT =======
Log collection ended with status: Succeeded
PS C:\CloudDeployment\logs>
Belirtilen roller için tanılama verileri gönderme
Bu örnekte, BareMetal ve ECE için rol filtreleme ile tanılama verileri gönderirsiniz:
Send-DiagnosticData -FilterByRole BareMetal, ECE –CollectSddc $false
Bu komutun örnek çıktısı aşağıda verilmişti:
PS C:\Users\docsuser> Send-DiagnosticData -FilterByRole BareMetal, ECE –CollectSddc $false
FromDate parameter not specified. Setting to default value 12/04/2023 20:41:21
ToDate parameter not specified. Setting to default value 12/04/2023 21:41:21
Converting FromDate and ToDate to UTC
FromDate in UTC is now 12/04/2023 20:41:21. ToDate in UTC is now 12/04/2023 21:41:21
The correlation Id is <Correlation-ID>. This is used to query for this log collection in the diagnostic pipeline.
Provide the below information to the customer support engineer working on your case.
AEORegion: eastus
AEODeviceARMResourceUri: /Subscriptions/<Subscription-ID>/resourceGroups/EDGECI-REGISTRATION/providers/Microsoft.AzureStackHCI/clusters/cluster-e5c7b2aa9a36490f9567b432a0eb51f1
AEOClusterNodeArcResourceUri: /subscriptions/<Subscription-ID>/resourceGroups/EDGECI-REGISTRATION/providers/Microsoft.HybridCompute/machines/v-Host1
CorrelationId: <Correlation-ID>
Observability Agent is running.
Successfully submitted on-demand. Log collection Job Id: <Job-ID>. This is used to track the log collection with Get-LogCollectionHistory.
Current log collection status: Running
Waiting for log collection to complete...
==== CUT ==================== CUT =======
Log collection ended with status: Succeeded
PS C:\Users\docsuser>
Günlük toplama geçmişini alma
Gerçekleştirdiğiniz tüm günlük koleksiyonlarının geçmişini alabilirsiniz. Bu geçmiş, günlük koleksiyonlarının türleri, günlük koleksiyonlarının boyutları, günlüklerin toplandığı zamanlar ve günlük toplama yöntemleri hakkında bilgi edinmenize yardımcı olur.
Son 90 güne ait günlük koleksiyonlarının geçmişini almak için şunu girin:
Get-LogCollectionHistory
İşte cmdlet'in örnek çıktısı Get-LogCollectionHistory . datetime Parametreler UTC saat dilimindedir.
PS C:\CloudDeployment\logs> Get-LogCollectionHistory
Name Value
---- -----
TimeCollected 9/29/2022 5:08:14 PM +00:00
Status Succeeded
CollectionFromDate 9/29/2022 4:07:57 PM +00:00
CollectionToDate 9/29/2022 5:07:57 PM +00:00
LogCollectionId fdcd94c8-1bd2-4ec6-8612-c92d5abd9a84
Type OnDemand
LogUploadSizeMb 1598
UploadNumberOfFiles 1924
Directory
Location
Error
---------- ---------------------------------------------------------
TimeCollected 9/27/2022 11:57:25 PM +00:00
Status Succeeded
CollectionFromDate 9/27/2022 9:57:16 PM +00:00
CollectionToDate 9/27/2022 11:57:16 PM +00:00
LogCollectionId f3d8dcc6-901e-4c72-a3cc-210055e6f198
Type OnDemand
LogUploadSizeMb 1069
UploadNumberOfFiles 1941
Directory
Location
Error
PS C:\CloudDeployment\logs>
Günlükleri yerel dosya paylaşımına kaydetme
Ağ sorunlarınız varsa veya verileri Azure'a göndermek yerine yerel olarak kaydetmeyi tercih ediyorsanız tanılama günlüklerini yerel bir Sunucu İleti Bloğu (SMB) paylaşımında depolayabilirsiniz.
Günlükleri yerel bir paylaşıma kaydetmek için şu adımları izleyin:
Paylaşım oluşturmak için aşağıdaki komutu çalıştırın:
New-SMBShare -Name <share-name> -Path <path-to-share> -FullAccess Users -ChangeAccess 'Server Operators'
Paylaşımda PSCredentials oluşturmak için aşağıdaki komutları çalıştırın:
$user = "<username>"
$pass = "<password>"
$sec=ConvertTo-SecureString -String $pass -AsPlainText -Force
$shareCredential = New-Object System.Management.Automation.PSCredential ($user, $sec)
Günlükleri toplamak ve yerel olarak kaydetmek için kümenin her düğümünde aşağıdaki komutu çalıştırın:
Send-DiagnosticData -SaveToPath <path to share> -ShareCredential $shareCredential
Günlükleri kaydettiğiniz SMB paylaşımından giden bağlantınız varsa, günlükleri Microsoft'a göndermek için aşağıdaki komutu çalıştırabilirsiniz:
Send-DiagnosticData NoLogCollection -SupplementaryLogs <path-to-share> -ShareCredentail $shareCredential
Send-DiagnosticData komut başvurusu
Bu bölümde parametreleri, söz dizimi ve kullanım örnekleri dahil olmak üzere üzerinde Send-DiagnosticDatabaşvuru bilgileri sağlanır.
FromDate ve ToDate
Bu parametreler belirli bir süre için günlükleri toplamanızı sağlar.
Söz dizimi
Send-DiagnosticData [[-FilterByRole] <string[]>] [[-FromDate] <datetime>] [[-ToDate] <datetime>] [[-CollectSddc] <bool>] [<CommonParameters>]
Örnek
$fromDate = Get-Date -Date "11/30/2023 18:35:00"
$toDate = Get-Date -Date "11/30/2023 19:35:00"
Send-DiagnosticData –FromDate $fromDate –ToDate $toDate
Uzantı sürümü
Tümü
FilterByRole
Bu parametre, hangi rollerin günlüklerini toplamak istediğinizi seçmenizi sağlar. Birden çok rol belirtebilirsiniz. Günlükleri filtreleyebileceğiniz kullanılabilir rollerin listesi için bkz . Günlükleri filtrelemek için kullanılabilen roller.
Söz dizimi
Send-DiagnosticData [[-FilterByRole] <string[]>]
Örnek
Send-DiagnosticData –FilterByRole “ALM” -CollectSddc $false
Uzantı sürümü
Tümü
CollectSddc
Bu parametre, yazılım tanımlı veri merkezi (SDDC) günlüklerinin dahil edilip edilmeyeceğinin belirlenmesine yardımcı olur. Varsayılan olarak, SDDC günlükleri eklenir. Dışlamak istiyorsanız $false olarak ayarlayın. SDDC tanılama araçlarını kullanma hakkında daha fazla bilgi için bkz . Kümeler için tanılama verilerini toplama.
Söz dizimi
Send-DiagnosticData [-CollectSddc <bool>]
Örnek
Send-DiagnosticData –CollectSddc $false
Uzantı sürümü
Tümü
BypassObsAgent
Gözlemlenebilirlik aracısını atlarken günlükler yalnızca günlük koleksiyonunun başlatıldığı düğümde toplanır. Koleksiyonun hiçbir kaydı geçmişe kaydedilmez.
Söz dizimi
Send-DiagnosticData [-BypassObsAgent]
Örnek
Send-DiagnosticData –BypassObsAgent
Uzantı sürümü
Tümü
SaveToPath
Bu parametre, tanılama günlüklerini Microsoft'a iletmek yerine konak makinede belirtilen bir yola kaydetmenizi sağlar.
Söz dizimi
Send-DiagnosticData -SaveToPath <string> [-FilterByRole <string[]>] [-FromDate <datetime>] [-ToDate <datetime>] [-CollectSddc <bool>] [-SupplementaryLogs <string>] [-ShareCredential <pscredential>] [-BypassObsAgent] [<CommonParameters>]
Örnekler
Ana bilgisayarda parametresine SaveToPath bir paylaşım yolu veya çıkış yolu sağlayabilirsiniz.
Send-DiagnosticData –SaveToPath <output path>
Send-DiagnosticData –SaveToPath <share path>
Eşlenmeyen bir paylaşım yolu kullanıyorsanız parametresini -ShareCredential de kullanmanız gerekir.
Send-DiagnosticData –SaveToPath <share path> -ShareCredential <credentials for share path>
, , , SupplementaryLogsShareCredentialToDateCollectSddcve BypassObsAgentgibi FromDateFilterByRolediğer parametrelerle kullanabilirsiniz.SaveToPath
Send-DiagnosticData –SaveToPath <output path> -FIlterByRole <role>
Uzantı sürümü
Sürüm 1.0.2.0 ve üzeri
NoLogCollection
NoLogCollection switch parametresi, Microsoft'a geçici bir günlük kümesi göndermenizi sağlar. Bu parametreyi kullanırken aşağıdaki ayrıntıları göz önünde bulundurun:
- ,
ShareCredentialve BypassObsAgent parametrelerini parametresiyle NoLogCollection birleştirebilirsinizSupplementaryLogs.
SupplementaryLogs parametresi kullanılırken NoLogCollectionzorunludur. Microsoft'a gönderilmesi gereken günlüklerin yolunu belirtir.- Ana bilgisayar üzerindeki bir paylaşım yolunu veya çıkış yolunu parametresine geçirme esnekliğine
SupplementaryLogs sahipsiniz. Eşlenmemiş bir paylaşım yolu kullanıyorsanız parametresini -ShareCredential de kullanmanız gerekir.
Söz dizimi
Send-DiagnosticData -SupplementaryLogs <string> -NoLogCollection [-ShareCredential <pscredential>] [-BypassObsAgent] [<CommonParameters>]
Örnekler
Zorunlu SupplementaryLogs parametreyle kullanın–NoLogCollection:
Send-DiagnosticData –NoLogCollection –SupplementaryPath <output path>
Eşlenmemiş paylaşım yolu ile kullanın –NoLogCollection :
Send-DiagnosticData –NoLogCollection –SupplementaryPath <share path>
-ShareCredential <credential to share path>
Uzantı sürümü
Sürüm 1.0.2.0 ve üzeri
SupplementaryLogs
SupplementaryLogs parametresi, Geçici günlükleri Microsoft'a göndermenizi sağlar.
Söz dizimi
Bunu aşağıdaki yollarla kullanabilirsiniz:
Bu senaryoda ile hem SaveToPathtanılama günlükleri hem de geçici günlükler toplanır ve belirtilen bir yola kaydedilir.
Send-DiagnosticData [-SupplementaryLogs <string>] -SaveToPath <path>
Burada ile NoLogCollectionyalnızca geçici günlükler toplanır ve Microsoft'a gönderilir. Tanılama günlükleri toplanmaz.
Send-DiagnosticData -SupplementaryLogs <string> -NoLogCollection
veya NoLogCollectionolmadanSaveToPath. Bu, hem tanılama günlüklerinin hem de geçici günlüklerin toplandığı ve Microsoft'a gönderildiği anlamına gelir.
Send-DiagnosticData [-SupplementaryLogs <string>]
Hem tanılama hem de geçici günlükleri toplarken, parametresini SupplementaryLogs , , FromDateToDateve CollectSddcgibi FilterByRolediğer parametrelerle kullanabilirsiniz.
Örnekler
veya NoLogCollectionolmadanSaveToPath:
Send-DiagnosticData –SupplementaryLogs <path to adhoc logs to collect>
ile:SaveToPath
Send-DiagnosticData –SaveToPath <path> -SupplementaryLogs <path to adhoc logs to collect>
ile:NoLogCollection
Send-DiagnosticData –NoLogCollection –SupplementaryLogs <path to adhoc logs to collect>
Uzantı sürümü
Sürüm 1.0.2.0 ve üzeri
ShareCredential
Bu parametre, günlükleri toplama ve bunları bir paylaşım yoluna kaydetme veya doğrudan bir paylaşım yolundan Microsoft'a günlük gönderme esnekliği sağlar.
Söz dizimi
Günlükleri bir yola kaydedin:
Send-DiagnosticData [-ShareCredential <pscredential>] -SaveToPath <path>
Paylaşım yolundaki günlükleri Microsoft'a gönderin:
Send-DiagnosticData [-ShareCredential <pscredential>] -SupplementaryLogs <path> -NoLogCollection;
Örnekler
Günlükleri bir yola kaydedin:
Send-DiagnosticData –SaveToPath <share path> -ShareCredential <credential to share path>
Paylaşım yolundaki günlükleri Microsoft'a gönderin:
Send-DiagnosticData –NoLogCollection –SupplementaryLogs <share path> –ShareCredential <credential to the share path>
Uzantı sürümü
Tümü
(Kullanımdan kaldırmayı planlayın) ToSMBShare
Bu parametre, günlükleri bir çıkış yoluna veya paylaşım yoluna kaydetmenizi sağlar. Eşlenmeyen bir paylaşım yolu kullanıyorsanız parametresini ShareCredential de kullanmanız gerekir. Bu parametre uzantının gelecek sürümlerinde kaldırılacağından, bunun yerine parametresini -SaveToPath kullanın.
Söz dizimi
Send-DiagnosticData –ToSMBShare –SharePath <path> [-ShareCredential <pscredential>]
Örnekler
Günlükleri çıkış yoluna veya paylaşım yoluna kaydedin:
Send-DiagnosticData –ToSMBShare –SharePath <output path or share path>
Günlükleri eşlenmemiş bir paylaşım yoluna kaydedin:
Send-DiagnosticData –ToSMBShare –SharePath <share path> -ShareCredential <credential for the share path>
Uzantı sürümü
Başlangıçta tüm sürümlerde erişilebilir, ancak bu parametre sonunda 0.1.42 ve önceki sürümler ile sınırlı olacaktır.
(Kullanımdan kaldırmayı planlayın) FromSMBShare
Bu parametre, günlükleri bir çıkış yolundan veya paylaşım yolundan doğrudan Microsoft'a göndermenizi sağlar. Eşlenmeyen bir paylaşım yolu kullanıyorsanız parametresini ShareCredential de kullanmanız gerekir. Bu parametre uzantının gelecek sürümlerinde kaldırılacağından, bunun yerine parametresini -NoLogCollection kullanın.
Söz dizimi
Send-DiagnosticData –FromSMBShare –SharePath <path> [-ShareCredential <pscredential>]
Örnekler
Send-DiagnosticData –FromSMBShare –SharePath <output path or share path>
Send-DiagnosticData –FromSMBShare –SharePath <share path>
Uzantı sürümü
Başlangıçta tüm sürümlerde erişilebilir, ancak bu parametre sonunda 0.1.42 ve önceki sürümler ile sınırlı olacaktır.
(Kullanımdan kaldırmayı planlayın) SharePath
SharePath parametresi aşağıdaki amaçlardan biri için kullanılabilir:
- Tanılama günlüklerini bir paylaşım yoluna veya çıkış yoluna kaydedin.
- Günlükleri bir paylaşım yolundan veya çıkış yolundan Microsoft'a gönderin. Paylaşım yolu kullanıyorsanız ve paylaşım yolu eşlenmemişse parametresinin
ShareCredential de kullanılması gerekir.
Bu parametre uzantının gelecek sürümlerinde kaldırılacağından, günlükleri bir yola kaydetmek için veya –SupplementaryLogs bunun yerine Geçici günlükleri Microsoft'a gönderirken komutunu kullanın–SaveToPath.
Söz dizimi
Send-DiagnosticData –ToSMBShare –SharePath <path> [-ShareCredential <pscredential>];
Send-DiagnosticData –FromSMBShare –SharePath <path> [-ShareCredential <pscredential>];
Örnekler
Send-DiagnosticData –ToSMBShare –SharePath <output path or share path>
Send-DiagnosticData –ToSMBShare –SharePath <share path> -ShareCredential <credential for the share path>
Send-DiagnosticData –FromSMBShare –SharePath <output path or share path>
Send-DiagnosticData –FromSMBShare –SharePath <share path>
Uzantı sürümü
Başlangıçta tüm sürümlerde erişilebilir, ancak bu parametre sonunda 0.1.42 ve önceki sürümler ile sınırlı olacaktır.
Günlükleri filtrelemek için kullanılabilen roller
FilterByRole parametresine göre filtreleme için aşağıdaki roller kullanılabilir. Gelecekteki bir sürümde kullanılabilir roller farklı olabilir.
| Rol adı |
Açıklama |
| ALM |
Uygulama Yaşam Döngüsü Yönetimi (ALM), yazılım uygulamaları için geliştirme, test, dağıtım ve bakım yönetimi içerir. |
| ArcAgent |
Azure Arc aracılığıyla Windows Server yönetimine izin veren bir aracı. Bkz . Azure Bağlı Makine aracısı genel bakış. |
| BareMetal |
Sanallaştırma katmanı olmadan çıplak sunucularda hizmetleri çalıştırmanıza olanak tanıyan altyapı rolü. İşletim sistemi ve donanım üzerinde tam erişime ve denetime sahip olabilirsiniz. |
| CommonInfra |
Ağ, depolama ve güvenlik gibi yaygın altyapı bileşenleri için günlükleri toplar. |
| DeploymentLogs |
Alınan adımlar, karşılaşılan hatalar ve işlem durumu da dahil olmak üzere dağıtım işleminin ayrıntılarını kaydeder. |
| ECE |
Dağıtım, güncelleştirme, düğüm ekleme ve düğüm değiştirme dahil olmak üzere yaşam döngüsü iş akışlarını yönetir. |
| Dahili |
Azure yönetilen uzantılarıyla ilgili veriler. |
| FleetDiagnosticsAgent |
Günlük toplamayı başlatmak için sistem durumu tetikleyicilerini dinler. Bu günlükler FleetDiagnosticsAgent ve günlük toplama ile ilgili sorunları tanılamak için kullanılır. |
| HCICloudService |
Azure Stack HCI için temel işlevsellik sağlayan bir Azure bulut hizmeti. Azure gücünü şirket içi sunucuların esnekliğiyle birleştirir. |
| DownloadService |
Güncelleştirme içeriğini indirmek için altyapı hizmetinin bir parçası. |
| Sağlık |
Olay günlükleri ve performans sayaçları gibi çeşitli kaynaklardan sistem durumu, performans ve kullanım verilerini toplar. |
| HostNetwork |
Konak ağını yapılandırmak için kullanılan temel işletim sistemi bileşeni olan Ağ ATC sorunlarını gidermek için kullanılan günlükler. |
| MOC_ARB |
Azure Stack HCI ve Windows Server'da sanal makinelerin bulut tabanlı yönetimini sağlayan yönetim yığını. |
| NC |
Ağ altyapısıyla ilgili bilgiler. |
| ObservabilityLogmanTraces |
Gözlemlenebilirlik izlemeleri için günlükleri toplar. Bu günlükler, tanılama verilerini göndermeyle ilgili sorunları gidermeye yardımcı olur. |
| ObservabilityVolume |
Gözlemlenebilirlik birimi için günlükleri toplar. |
| OEMDiagnostics |
BIOS, sürücüler, algılayıcılar ve daha fazlası gibi sunucu donanımınızla ilgili sorunları belirlemenize ve çözmenize yardımcı olabilecek OEM tanılama günlüklerini toplar. |
| OSUpdateLogs |
Azure Stack HCI düğümlerindeki işletim sistemi güncelleştirmeleriyle ilgili günlükleri toplayan rol, güncelleştirmeyle ilgili sorunları gidermek için kullanışlıdır. |
| RemoteSupportAgent |
Müşteri desteği olaylarını gidermek için kullanılan uzaktan destek oturumlarıyla ilgili sorunları gidermeye yardımcı olan günlükler. |
| TestObservability |
Uzantının Test-Observability düzgün çalışıp çalışmadığını test etmek için kullanılan cmdlet'inden TelemetryAndDiagnostics günlükleri toplar. |
| URP |
ve OsUpdate ECE rol olaylarıyla UpdateService ilgili günlüklerden oluşur. Azure Update Service Stack HCI sistemleri için güncelleştirmeleri yönetir. OsUpdate ECE rolü, dağıtım sırasında kümenin parçası olmayan makinelere (fiziksel konaklar ve InfraVM'ler) işletim sistemi güncelleştirmeleri almak ve yüklemek, düğüm eklemek, düğümü onarmak ve Infra VM'leri güncelleştirme senaryolarını yüklemek için kullanılır. Bu iki bileşenden gelen izlemeler rolün URP bir parçasıdır. |
