Untuk menggunakan PowerShell untuk pengumpulan log, jalankan Send-DiagnosticData
cmdlet dari simpul apa pun dalam kluster Azure Stack HCI. Cmdlet ini untuk sementara menyalin log secara lokal. Log yang disalin diurai, dikirim ke Microsoft, lalu dihapus dari sistem Anda.
Berikut adalah beberapa poin penting yang perlu dipertimbangkan saat mengumpulkan log menggunakan PowerShell:
- Waktu
Send-DiagnosticData
penyelesaian cmdlet bervariasi tergantung pada faktor-faktor, seperti peran di mana log dikumpulkan, durasi waktu yang ditentukan, dan jumlah simpul di lingkungan Azure Stack HCI Anda.
- Jika Anda tidak menentukan parameter apa pun,
Send-DiagnosticData
cmdlet mengumpulkan data dari semua simpul selama durasi satu jam sebelumnya.
Berikut sintaksis dari Send-DiagnosticData
:
Send-DiagnosticData [[-FilterByRole] <string[]>] [[-FromDate] <datetime>] [[-ToDate] <datetime>] [[-CollectSddc] <bool>] [<CommonParameters>]
Untuk informasi referensi tentang Send-DiagnosticData
, lihat Send-DiagnosticData
bagian referensi perintah nanti di artikel ini.
Contoh dan output sampel
Berikut adalah beberapa contoh perintah dengan output sampel yang menunjukkan cara menggunakan Send-DiagnosticData
cmdlet dengan parameter yang berbeda.
Mengirim data diagnostik dengan pemfilteran tanggal
Dalam contoh ini, Anda mengirim data diagnostik dengan pemfilteran tanggal untuk file log selama dua jam terakhir:
Send-DiagnosticData -FromDate (Get-Date).AddHours(-2) -ToDate (Get-Date)
Berikut adalah contoh output dari perintah ini:
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>
Mengirim data diagnostik untuk peran tertentu
Dalam contoh ini, Anda mengirim data diagnostik dengan pemfilteran peran untuk BareMetal dan ECE:
Send-DiagnosticData -FilterByRole BareMetal, ECE –CollectSddc $false
Berikut adalah contoh output dari perintah ini:
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>
Mendapatkan riwayat pengumpulan log
Anda bisa mendapatkan riwayat semua koleksi log yang telah Anda lakukan. Riwayat ini membantu Anda mempelajari tentang jenis koleksi log, ukuran koleksi log, waktu ketika log dikumpulkan, dan metode pengumpulan log.
Untuk mendapatkan riwayat koleksi log selama 90 hari terakhir, masukkan:
Get-LogCollectionHistory
Berikut adalah contoh output Get-LogCollectionHistory
cmdlet. Parameter datetime
berada di zona waktu UTC.
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>
Menyimpan log ke berbagi file lokal
Anda dapat menyimpan log diagnostik pada berbagi Blok Pesan Server (SMB) lokal jika Anda memiliki masalah jaringan atau lebih suka menyimpan data secara lokal alih-alih mengirimkannya ke Azure.
Ikuti langkah-langkah ini untuk menyimpan log ke berbagi lokal:
Jalankan perintah berikut untuk membuat berbagi:
New-SMBShare -Name <share-name> -Path <path-to-share> -FullAccess Users -ChangeAccess 'Server Operators'
Jalankan perintah berikut untuk membuat PSCredentials ke berbagi:
$user = "<username>"
$pass = "<password>"
$sec=ConvertTo-SecureString -String $pass -AsPlainText -Force
$shareCredential = New-Object System.Management.Automation.PSCredential ($user, $sec)
Jalankan perintah berikut pada setiap simpul kluster untuk mengumpulkan log dan menyimpannya secara lokal:
Send-DiagnosticData -SaveToPath <path to share> -ShareCredential $shareCredential
Jika Anda memiliki konektivitas keluar dari berbagi SMB tempat Anda menyimpan log, Anda dapat menjalankan perintah berikut untuk mengirim log ke Microsoft:
Send-DiagnosticData NoLogCollection -SupplementaryLogs <path-to-share> -ShareCredentail $shareCredential
Send-DiagnosticData
referensi perintah
Bagian ini menyediakan informasi referensi tentang Send-DiagnosticData
, termasuk parameter, sintaks, dan contoh penggunaannya.
FromDate dan ToDate
Parameter ini memungkinkan Anda mengumpulkan log untuk periode waktu tertentu.
Sintaks
Send-DiagnosticData [[-FilterByRole] <string[]>] [[-FromDate] <datetime>] [[-ToDate] <datetime>] [[-CollectSddc] <bool>] [<CommonParameters>]
Contoh
$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
Versi ekstensi
Semua
FilterByRole
Parameter ini memungkinkan Anda memilih log peran mana yang ingin Anda kumpulkan. Anda dapat menentukan beberapa peran. Untuk daftar peran yang tersedia di mana Anda dapat memfilter log, lihat Peran yang tersedia untuk memfilter log.
Sintaks
Send-DiagnosticData [[-FilterByRole] <string[]>]
Contoh
Send-DiagnosticData –FilterByRole “ALM” -CollectSddc $false
Versi ekstensi
Semua
CollectSddc
Parameter ini membantu menentukan apakah akan menyertakan atau mengecualikan log pusat data yang ditentukan perangkat lunak (SDDC). Secara default, log SDDC disertakan. Atur ke $false jika Anda ingin mengecualikannya. Untuk informasi selengkapnya tentang menggunakan alat diagnostik SDDC, lihat Mengumpulkan data diagnostik untuk kluster.
Sintaks
Send-DiagnosticData [-CollectSddc <bool>]
Contoh
Send-DiagnosticData –CollectSddc $false
Versi ekstensi
Semua
BypassObsAgent
Saat melewati agen observabilitas, log dikumpulkan hanya pada simpul tempat pengumpulan log dimulai. Tidak ada catatan koleksi yang disimpan dalam riwayat.
Sintaks
Send-DiagnosticData [-BypassObsAgent]
Contoh
Send-DiagnosticData –BypassObsAgent
Versi ekstensi
Semua
SaveToPath
Parameter ini memungkinkan Anda menyimpan log diagnostik ke jalur tertentu pada komputer host, daripada mengirimkannya ke Microsoft.
Sintaksis
Send-DiagnosticData -SaveToPath <string> [-FilterByRole <string[]>] [-FromDate <datetime>] [-ToDate <datetime>] [-CollectSddc <bool>] [-SupplementaryLogs <string>] [-ShareCredential <pscredential>] [-BypassObsAgent] [<CommonParameters>]
Contoh
Anda dapat menyediakan jalur berbagi atau jalur output pada host ke SaveToPath
parameter .
Send-DiagnosticData –SaveToPath <output path>
Send-DiagnosticData –SaveToPath <share path>
Jika Anda menggunakan jalur berbagi yang tidak dipetakan, Anda juga harus menggunakan -ShareCredential
parameter .
Send-DiagnosticData –SaveToPath <share path> -ShareCredential <credentials for share path>
Anda dapat menggunakan SaveToPath
dengan parameter lain, seperti FilterByRole
, , FromDate
, ToDate
CollectSddc
, SupplementaryLogs
, ShareCredential
dan BypassObsAgent
.
Send-DiagnosticData –SaveToPath <output path> -FIlterByRole <role>
Versi ekstensi
Versi 1.0.2.0 ke atas
NoLogCollection
Parameter NoLogCollection
pengalihan memungkinkan Anda mengirim sekumpulan log ad-hoc ke Microsoft. Saat menggunakan parameter ini, pertimbangkan detail berikut:
- Anda dapat menggabungkan
SupplementaryLogs
parameter , ShareCredential
, dan BypassObsAgent
dengan NoLogCollection
parameter .
- Parameter
SupplementaryLogs
wajib saat menggunakan NoLogCollection
. Ini menentukan jalur ke log yang perlu dikirim ke Microsoft.
- Anda memiliki fleksibilitas untuk meneruskan jalur berbagi atau jalur output pada host ke
SupplementaryLogs
parameter . Jika Anda menggunakan jalur berbagi yang tidak dipetakan, Anda juga harus menggunakan -ShareCredential
parameter .
Sintaksis
Send-DiagnosticData -SupplementaryLogs <string> -NoLogCollection [-ShareCredential <pscredential>] [-BypassObsAgent] [<CommonParameters>]
Contoh
Gunakan –NoLogCollection
dengan parameter wajib SupplementaryLogs
:
Send-DiagnosticData –NoLogCollection –SupplementaryPath <output path>
Gunakan –NoLogCollection
dengan jalur berbagi yang tidak dipetakan:
Send-DiagnosticData –NoLogCollection –SupplementaryPath <share path>
-ShareCredential <credential to share path>
Versi ekstensi
Versi 1.0.2.0 ke atas
SupplementaryLogs
Parameter SupplementaryLogs memungkinkan Anda mengirim log ad-hoc ke Microsoft.
Sintaksis
Anda dapat menggunakannya dengan cara berikut:
Dalam skenario ini, dengan SaveToPath
, baik log diagnostik maupun log ad-hoc dikumpulkan dan disimpan ke jalur tertentu.
Send-DiagnosticData [-SupplementaryLogs <string>] -SaveToPath <path>
Di sini, dengan NoLogCollection
, hanya log ad-hoc yang dikumpulkan dan dikirim ke Microsoft. Tidak ada log diagnostik yang dikumpulkan.
Send-DiagnosticData -SupplementaryLogs <string> -NoLogCollection
Tanpa SaveToPath
atau NoLogCollection
. Ini berarti bahwa log diagnostik dan log ad-hoc dikumpulkan dan dikirim ke Microsoft.
Send-DiagnosticData [-SupplementaryLogs <string>]
Saat mengumpulkan log diagnostik dan ad-hoc, Anda dapat menggunakan SupplementaryLogs
parameter dengan parameter lain seperti FilterByRole
, , FromDate
, ToDate
dan CollectSddc
.
Contoh
Tanpa SaveToPath
atau NoLogCollection
:
Send-DiagnosticData –SupplementaryLogs <path to adhoc logs to collect>
Dengan SaveToPath
:
Send-DiagnosticData –SaveToPath <path> -SupplementaryLogs <path to adhoc logs to collect>
Dengan NoLogCollection
:
Send-DiagnosticData –NoLogCollection –SupplementaryLogs <path to adhoc logs to collect>
Versi ekstensi
Versi 1.0.2.0 ke atas
ShareCredential
Parameter ini memberikan fleksibilitas untuk mengumpulkan log dan menyimpannya ke jalur berbagi atau langsung mengirim log dari jalur berbagi ke Microsoft.
Sintaksis
Simpan log ke jalur:
Send-DiagnosticData [-ShareCredential <pscredential>] -SaveToPath <path>
Kirim log pada jalur berbagi ke Microsoft:
Send-DiagnosticData [-ShareCredential <pscredential>] -SupplementaryLogs <path> -NoLogCollection;
Contoh
Simpan log ke jalur:
Send-DiagnosticData –SaveToPath <share path> -ShareCredential <credential to share path>
Kirim log pada jalur berbagi ke Microsoft:
Send-DiagnosticData –NoLogCollection –SupplementaryLogs <share path> –ShareCredential <credential to the share path>
Versi ekstensi
Semua
(Rencana untuk menghentikan) ToSMBShare
Parameter ini memungkinkan Anda menyimpan log baik ke jalur output atau jalur berbagi. Jika Anda menggunakan jalur berbagi yang tidak dipetakan, Anda juga perlu menggunakan ShareCredential
parameter . Karena parameter ini akan dihapus dalam versi ekstensi yang akan datang, gunakan parameter sebagai gantinya -SaveToPath
.
Sintaksis
Send-DiagnosticData –ToSMBShare –SharePath <path> [-ShareCredential <pscredential>]
Contoh
Simpan log ke jalur output atau jalur berbagi:
Send-DiagnosticData –ToSMBShare –SharePath <output path or share path>
Simpan log ke jalur berbagi yang tidak dipetakan:
Send-DiagnosticData –ToSMBShare –SharePath <share path> -ShareCredential <credential for the share path>
Versi ekstensi
Awalnya dapat diakses di semua versi, namun, parameter ini pada akhirnya akan dibatasi pada Versi 0.1.42 dan yang lebih lama.
(Rencana untuk menghentikan) FromSMBShare
Parameter ini memungkinkan Anda mengirim log dari jalur output atau berbagi jalur langsung ke Microsoft. Jika Anda menggunakan jalur berbagi yang tidak dipetakan, Anda juga perlu menggunakan ShareCredential
parameter . Karena parameter ini akan dihapus dalam versi ekstensi yang akan datang, gunakan parameter sebagai gantinya -NoLogCollection
.
Sintaksis
Send-DiagnosticData –FromSMBShare –SharePath <path> [-ShareCredential <pscredential>]
Contoh
Send-DiagnosticData –FromSMBShare –SharePath <output path or share path>
Send-DiagnosticData –FromSMBShare –SharePath <share path>
Versi ekstensi
Awalnya dapat diakses di semua versi, namun, parameter ini pada akhirnya akan dibatasi pada Versi 0.1.42 dan yang lebih lama.
(Rencana untuk menghentikan) SharePath
Parameter SharePath dapat digunakan untuk salah satu tujuan berikut:
- Simpan log diagnostik ke jalur berbagi atau jalur output.
- Kirim log ke Microsoft dari jalur berbagi atau jalur output. Jika Anda menggunakan jalur berbagi dan jalur berbagi tidak dipetakan, parameter
ShareCredential
juga harus digunakan.
Karena parameter ini akan dihapus dalam versi ekstensi yang akan datang, gunakan –SaveToPath
untuk menyimpan log ke jalur, atau –SupplementaryLogs
saat mengirim log ad-hoc ke Microsoft sebagai gantinya.
Sintaksis
Send-DiagnosticData –ToSMBShare –SharePath <path> [-ShareCredential <pscredential>];
Send-DiagnosticData –FromSMBShare –SharePath <path> [-ShareCredential <pscredential>];
Contoh
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>
Versi ekstensi
Awalnya dapat diakses di semua versi, namun, parameter ini pada akhirnya akan dibatasi pada Versi 0.1.42 dan yang lebih lama.
Peran tersedia untuk memfilter log
Peran berikut tersedia untuk pemfilteran menurut parameter FilterByRole . Peran yang tersedia mungkin berbeda dalam rilis mendatang.
Nama peran |
Deskripsi |
ALM |
Application Lifecycle Management (ALM) melibatkan pengelolaan pengembangan, pengujian, penyebaran, dan pemeliharaan untuk aplikasi perangkat lunak. |
ArcAgent |
Agen yang memungkinkan manajemen Windows Server melalui Azure Arc. Lihat Gambaran Umum agen Azure Connected Machine. |
BareMetal |
Peran infrastruktur yang memungkinkan Anda menjalankan layanan di server bare metal tanpa lapisan virtualisasi. Anda dapat memiliki akses dan kontrol penuh atas sistem operasi dan perangkat keras. |
CommonInfra |
Mengumpulkan log untuk komponen infrastruktur umum, seperti jaringan, penyimpanan, dan keamanan. |
DeploymentLogs |
Mencatat detail proses penyebaran, termasuk langkah-langkah yang diambil, mengalami kesalahan, dan status operasi. |
ECE |
Mengelola alur kerja siklus hidup, termasuk penyebaran, pembaruan, add-node, dan penggantian simpul. |
Ekstensi |
Data yang terkait dengan ekstensi terkelola Azure. |
FleetDiagnosticsAgent |
Mendengarkan pemicu kesehatan untuk memulai pengumpulan log. Log ini digunakan untuk mendiagnosis masalah dengan FleetDiagnosticsAgent dan pengumpulan log. |
HCICloudService |
Layanan cloud Azure yang menyediakan fungsionalitas inti untuk Azure Stack HCI. Ini menggabungkan daya Azure dengan fleksibilitas server lokal. |
DownloadService |
Bagian dari layanan infra untuk mengunduh konten pembaruan. |
Kesehatan |
Mengumpulkan data kesehatan, performa, dan penggunaan dari berbagai sumber, seperti log peristiwa dan penghitung kinerja. |
HostNetwork |
Log yang digunakan untuk memecahkan masalah ATC Jaringan, komponen sistem operasi yang mendasar digunakan untuk mengonfigurasi jaringan host. |
MOC_ARB |
Tumpukan manajemen yang memungkinkan manajemen komputer virtual berbasis cloud di Azure Stack HCI dan Windows Server. |
NC |
Informasi yang terkait dengan infrastruktur jaringan. |
ObservabilityLogmanTraces |
Mengumpulkan log untuk jejak pengamatan. Log ini membantu memecahkan masalah pengiriman data diagnostik. |
ObservabilityVolume |
Mengumpulkan log untuk volume pengamatan. |
OEMDiagnostics |
Mengumpulkan log untuk diagnostik OEM, yang dapat membantu mengidentifikasi dan menyelesaikan masalah dengan perangkat keras server Anda, seperti BIOS, driver, sensor, dan banyak lagi. |
OSUpdateLogs |
Peran yang mengumpulkan log yang terkait dengan pembaruan sistem operasi pada simpul Azure Stack HCI, berguna untuk memecahkan masalah terkait pembaruan. |
RemoteSupportAgent |
Log yang membantu memecahkan masalah dengan sesi dukungan jarak jauh, yang digunakan untuk mengatasi kasus dukungan pelanggan. |
TestObservability |
Mengumpulkan log dari Test-Observability cmdlet, yang digunakan untuk menguji bahwa TelemetryAndDiagnostics ekstensi berfungsi dengan baik. |
URP |
Terdiri dari log yang terkait dengan UpdateService peristiwa peran ECE dan OsUpdate . Mengelola Update Service pembaruan untuk sistem Azure Stack HCI. Peran OsUpdate ECE digunakan untuk memperoleh dan menginstal pembaruan sistem operasi pada komputer (host fisik dan InfraVM) yang bukan bagian dari kluster selama penyebaran, menambahkan node, memperbaiki node, dan skenario pembaruan VM Infra. Jejak dari kedua komponen ini adalah bagian URP dari peran. |