PowerShell'i günlük toplama için kullanmak amacıyla Azure Yerel örneği içindeki herhangi bir düğümden Send-DiagnosticData cmdlet'ini çalıştırın. 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 Yerel 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>]
Send-DiagnosticData hakkında bilgi almak için bu makalenin ilerleyen kısımlarındaki 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 görüntüle
Gerçekleştirdiğiniz tüm günlük kayıtları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 sistemin 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 referansı
Bu bölümde, Send-DiagnosticData üzerinde parametreleri, söz dizimi ve kullanım örnekleri dahil olmak üzere başvuru bilgileri sağlanır.
BaşlangıçTarihi ve BitişTarihi
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
Yazılım tanımlı veri merkezi (SDDC) günlüklerinin dahil edilip edilmeyeceğini belirler. Varsayılan olarak, SDDC günlükleri eklenir. Onları dışlamak istiyorsanız, değeri $false olarak ayarlayın. SDDC tanılama araçlarını kullanma hakkında daha fazla bilgi için Sistemler için tanılama verilerini toplama bölümüne bakın.
Sözdizimi
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şte tutulmaz.
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
Host üzerinde SaveToPath parametresine bir paylaşım yolu veya bir çıkış yolu sağlayabilirsiniz.
Send-DiagnosticData –SaveToPath <output path>
Send-DiagnosticData –SaveToPath <share path>
Eşlenmeyen bir paylaşım yolu kullanıyorsanız, -ShareCredential parametresi de kullanmanız gerekir.
Send-DiagnosticData –SaveToPath <share path> -ShareCredential <credentials for share path>
SaveToPath'ı, FilterByRole, FromDate, ToDate, CollectSddc, SupplementaryLogs, ShareCredential ve BypassObsAgent gibi diğer parametrelerle birlikte kullanabilirsiniz.
Send-DiagnosticData –SaveToPath <output path> -FIlterByRole <role>
Uzantı sürümü
Sürüm 1.0.2.0 ve üzeri
NoLog Veri Toplama Sistemi
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:
-
SupplementaryLogs, ShareCredential ve BypassObsAgent parametrelerini NoLogCollection parametresiyle birleştirebilirsiniz.
-
SupplementaryLogs parametresi kullanılırken NoLogCollectionzorunludur. Microsoft'a gönderilmesi gereken günlüklerin yolunu belirtir.
-
SupplementaryLogs parametresine ana bilgisayar üzerindeki bir paylaşım yolunu veya bir çıkış yolunu geçirme esnekliğine sahipsiniz. Eşlenmemiş bir paylaşım yolu kullanıyorsanız -ShareCredential parametresini de kullanmanız gerekir.
Söz dizimi
Send-DiagnosticData -SupplementaryLogs <string> -NoLogCollection [-ShareCredential <pscredential>] [-BypassObsAgent] [<CommonParameters>]
Örnekler
Zorunlu SupplementaryLogs parametresiyle –NoLogCollection kullanın:
Send-DiagnosticData –NoLogCollection –SupplementaryPath <output path>
Eşlenmemiş paylaşım yolu ile –NoLogCollection kullanın
Send-DiagnosticData –NoLogCollection –SupplementaryPath <share path>
-ShareCredential <credential to share path>
Uzantı sürümü
Sürüm 1.0.2.0 ve üzeri
Ek Günlükler
SupplementaryLogs parametresi, Geçici günlükleri Microsoft'a göndermenizi sağlar.
Sözdizimi
Bunu aşağıdaki yollarla kullanabilirsiniz:
ile SaveToPath. Bu senaryoda hem tanılama günlükleri hem de geçici günlükler toplanır ve belirtilen bir yola kaydedilir.
Send-DiagnosticData [-SupplementaryLogs <string>] -SaveToPath <path>
NoLogCollection ile. Burada yalnı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 SaveToPatholmadanNoLogCollection. 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, SupplementaryLogs parametresini FilterByRole, FromDate, ToDate ve CollectSddc gibi diğer parametrelerle kullanabilirsiniz.
Örnekler
veya SaveToPatholmadanNoLogCollection:
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şlenmemiş bir paylaşım yolu kullanıyorsanız, ShareCredential parametresini de kullanmanız gerekiyordu. 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, ShareCredential parametresini 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, o zaman
ShareCredential parametresi de kullanılmalıdır.
Bu parametre uzantının gelecekteki sürümlerinde kaldırılacağından, günlükleri bir yola kaydetmek için –SaveToPath veya günlükleri geçici olarak Microsoft'a gönderirken –SupplementaryLogs kullanın.
Sözdizimi
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önetmeye izin veren bir aracı. Daha fazla bilgi için Azure Bağlı Makine aracısı genel bakış bölümüne bakın. |
| 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. |
| Ortak Altyapı |
Ağ, depolama ve güvenlik gibi yaygın altyapı bileşenleri için günlükleri toplar. |
| Dağıtım Kayıtları |
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. |
| Eklenti / Uzatma |
Azure yönetilen uzantılarıyla ilgili veriler. |
| FiloTeşhisAjanı |
Günlük toplamayı başlatmak için sağlık tetikleyicilerini dinler. Bu günlükler FleetDiagnosticsAgent ve günlük toplama ile ilgili sorunları tanılamak için kullanılır. |
| HCICloudService |
Azure Yerel için temel işlevsellik sağlayan bir Azure bulut hizmeti. Azure gücünü şirket içi makinelerin 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 |
Ağ ATC'nin ve konak ağı iletişim ayarlarını yapılandırmak için kullanılan temel işletim sistemi bileşeni ile ilgili sorunların giderilmesinde kullanılan günlükler. |
| MOC_ARB |
Azure Yerel 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 izleri için günlükleri toplar. Bu günlükler, tanılama verilerini göndermeyle ilgili sorunları gidermeye yardımcı olur. |
| Gözlemlenebilirlik Hacmi |
Gözlemlenebilirlik hacmi 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 Yerel 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. |
| UzaktanDestekAjanı |
Uzaktan destek oturumlarıyla ilgili sorunları gidermeye yardımcı olan ve müşteri desteği olaylarını ele almak için kullanılan günlükler. |
| Test Gözlemlenebilirlik |
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 |
UpdateService ve OsUpdate ECE rolü olaylarıyla ilgili günlüklerden oluşur.
Update Service Azure Yerel güncellemelerini yönetir.
OsUpdate ECE rolü, dağıtım sırasında sistemin 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şenin izleri URP rolünün bir parçasıdır. |
