Pokud chcete použít PowerShell pro shromažďování protokolů, spusťte rutinu Send-DiagnosticData z libovolného uzlu v místní instanci Azure. Tato rutina dočasně zkopíruje protokoly místně. Zkopírované protokoly se analyzují, odesílají do Microsoftu a pak se z vašeho systému odstraní.
Tady je několik důležitých bodů, které je potřeba vzít v úvahu při shromažďování protokolů pomocí PowerShellu:
- Doba
Send-DiagnosticData dokončení rutiny se liší v závislosti na faktorech, jako jsou role, pro které se shromažďují protokoly, zadaná doba trvání a počet uzlů v místním prostředí Azure.
- Pokud nezadáte žádné parametry,
Send-DiagnosticData rutina shromažďuje data ze všech uzlů za předchozí hodinu.
Tady je syntaxe Send-DiagnosticData:
Send-DiagnosticData [[-FilterByRole] <string[]>] [[-FromDate] <datetime>] [[-ToDate] <datetime>] [[-CollectSddc] <bool>] [<CommonParameters>]
Referenční informace najdete Send-DiagnosticDatav části s referenčními Send-DiagnosticData informacemi o příkazu dále v tomto článku.
Příklady a ukázkové výstupy
Tady je několik ukázkových příkazů s ukázkovými výstupy, které ukazují, jak použít rutinu Send-DiagnosticData s různými parametry.
Odesílání diagnostických dat s filtrováním kalendářních dat
V tomto příkladu odešlete diagnostická data s filtrováním kalendářních dat pro soubory protokolu za poslední dvě hodiny:
Send-DiagnosticData -FromDate (Get-Date).AddHours(-2) -ToDate (Get-Date)
Tady je ukázkový výstup tohoto příkazu:
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>
Odeslání diagnostických dat pro zadané role
V tomto příkladu odešlete diagnostická data s filtrováním rolí pro BareMetal a ECE:
Send-DiagnosticData -FilterByRole BareMetal, ECE –CollectSddc $false
Tady je ukázkový výstup tohoto příkazu:
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>
Získání historie shromažďování protokolů
Můžete získat historii všech kolekcí protokolů, které jste provedli. Tato historie vám pomůže získat informace o typech kolekcí protokolů, velikostech kolekcí protokolů, časech shromažďování protokolů a metodách shromažďování protokolů.
Pokud chcete získat historii kolekcí protokolů za posledních 90 dnů, zadejte:
Get-LogCollectionHistory
Tady je ukázkový výstup rutiny Get-LogCollectionHistory . Parametry datetime jsou v časovém pásmu 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>
Ukládání protokolů do místní sdílené složky
Diagnostické protokoly můžete ukládat do místní sdílené složky SMB (Server Message Block), pokud máte problémy se sítí nebo dáváte přednost místnímu ukládání dat místo jejich odesílání do Azure.
Pokud chcete uložit protokoly do místní sdílené složky, postupujte takto:
Spuštěním následujícího příkazu vytvořte sdílenou složku:
New-SMBShare -Name <share-name> -Path <path-to-share> -FullAccess Users -ChangeAccess 'Server Operators'
Spuštěním následujících příkazů vytvořte příkazy PSCredentials do sdílené složky:
$user = "<username>"
$pass = "<password>"
$sec=ConvertTo-SecureString -String $pass -AsPlainText -Force
$shareCredential = New-Object System.Management.Automation.PSCredential ($user, $sec)
Spuštěním následujícího příkazu na každém uzlu systému shromážděte protokoly a uložte je místně:
Send-DiagnosticData -SaveToPath <path to share> -ShareCredential $shareCredential
Pokud máte odchozí připojení ze sdílené složky SMB, do které jste protokoly uložili, můžete protokoly odeslat Microsoftu spuštěním následujícího příkazu:
Send-DiagnosticData NoLogCollection -SupplementaryLogs <path-to-share> -ShareCredentail $shareCredential
Send-DiagnosticData referenční dokumentace k příkazům
Tato část obsahuje referenční informace o Send-DiagnosticDataparametrech, syntaxi a příkladech použití.
FromDate a ToDate
Tyto parametry umožňují shromažďovat protokoly pro určité časové období.
Syntaxe
Send-DiagnosticData [[-FilterByRole] <string[]>] [[-FromDate] <datetime>] [[-ToDate] <datetime>] [[-CollectSddc] <bool>] [<CommonParameters>]
Příklad
$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
Verze rozšíření
Všechny
FilterByRole
Tento parametr umožňuje zvolit protokoly rolí, které chcete shromažďovat. Můžete zadat více rolí. Seznam dostupných rolí, na kterých můžete filtrovat protokoly, najdete v tématu Role dostupné pro filtrování protokolů.
Syntaxe
Send-DiagnosticData [[-FilterByRole] <string[]>]
Příklad
Send-DiagnosticData –FilterByRole “ALM” -CollectSddc $false
Verze rozšíření
Všechny
CollectSddc
Určuje, jestli se mají zahrnout nebo vyloučit protokoly softwarově definovaného datového centra (SDDC). Ve výchozím nastavení jsou zahrnuté protokoly SDDC. Pokud je chcete vyloučit, nastavte ho na $false. Další informace o používání diagnostických nástrojů SDDC najdete v tématu Shromažďování diagnostických dat pro systémy.
Syntaxe
Send-DiagnosticData [-CollectSddc <bool>]
Příklad
Send-DiagnosticData –CollectSddc $false
Verze rozšíření
Všechny
BypassObsAgent
Při obejití agenta pozorovatelnosti se protokoly shromažďují jenom na uzlu, ve kterém byla inicializována kolekce protokolů. V historii se neuchovávají žádné záznamy o kolekci.
Syntaxe
Send-DiagnosticData [-BypassObsAgent]
Příklad
Send-DiagnosticData –BypassObsAgent
Verze rozšíření
Všechny
SaveToPath
Tento parametr umožňuje ukládat diagnostické protokoly na zadanou cestu na hostitelském počítači místo jejich přenosu do Microsoftu.
Syntaxe
Send-DiagnosticData -SaveToPath <string> [-FilterByRole <string[]>] [-FromDate <datetime>] [-ToDate <datetime>] [-CollectSddc <bool>] [-SupplementaryLogs <string>] [-ShareCredential <pscredential>] [-BypassObsAgent] [<CommonParameters>]
Příklady
Parametru můžete poskytnout cestu ke sdílené složce nebo výstupní cestu na hostiteli SaveToPath .
Send-DiagnosticData –SaveToPath <output path>
Send-DiagnosticData –SaveToPath <share path>
Pokud používáte cestu ke sdílené složce, která není namapovaná, musíte také použít -ShareCredential parametr.
Send-DiagnosticData –SaveToPath <share path> -ShareCredential <credentials for share path>
Můžete použít SaveToPath s jinými parametry, například FilterByRole, FromDate, ToDate, CollectSddc, SupplementaryLogs, ShareCredential, a BypassObsAgent.
Send-DiagnosticData –SaveToPath <output path> -FIlterByRole <role>
Verze rozšíření
Verze 1.0.2.0 a vyšší
NoLogCollection
Parametr NoLogCollection přepínače umožňuje odesílat do Microsoftu ad hoc sadu protokolů. Při použití tohoto parametru zvažte následující podrobnosti:
- S parametrem
SupplementaryLogsShareCredential můžete kombinovat parametry , BypassObsAgenta NoLogCollection parametry.
- Parametr
SupplementaryLogs je povinný při použití NoLogCollection. Určuje cestu k protokolům, které je potřeba odeslat do Microsoftu.
- K parametru máte možnost předat cestu ke sdílené složce nebo výstupní cestu na hostiteli
SupplementaryLogs . Pokud používáte nenamapovanou cestu ke sdílené složce, musíte použít -ShareCredential také parametr.
Syntaxe
Send-DiagnosticData -SupplementaryLogs <string> -NoLogCollection [-ShareCredential <pscredential>] [-BypassObsAgent] [<CommonParameters>]
Příklady
Použijte –NoLogCollection s povinným SupplementaryLogs parametrem:
Send-DiagnosticData –NoLogCollection –SupplementaryPath <output path>
Používá se –NoLogCollection s nenamapovanou cestou ke sdílené složce:
Send-DiagnosticData –NoLogCollection –SupplementaryPath <share path>
-ShareCredential <credential to share path>
Verze rozšíření
Verze 1.0.2.0 a vyšší
Doplňkováloga
Parametr SupplementaryLogs umožňuje odesílat protokoly ad hoc microsoftu.
Syntaxe
Můžete ho použít následujícími způsoby:
S SaveToPath. V tomto scénáři se shromažďují a ukládají diagnostické protokoly i protokoly ad hoc do zadané cesty.
Send-DiagnosticData [-SupplementaryLogs <string>] -SaveToPath <path>
S NoLogCollection. Tady se shromažďují a odesílají do Microsoftu jenom protokoly ad hoc. Neshromažďují se žádné diagnostické protokoly.
Send-DiagnosticData -SupplementaryLogs <string> -NoLogCollection
Bez SaveToPath nebo NoLogCollectionbez . To znamená, že diagnostické protokoly i protokoly ad hoc se shromažďují a odesílají do Microsoftu.
Send-DiagnosticData [-SupplementaryLogs <string>]
Při shromažďování diagnostických i ad hoc protokolů můžete parametr použít SupplementaryLogs s dalšími parametry, jako FilterByRolejsou , FromDate, ToDatea CollectSddc.
Příklady
Bez SaveToPath nebo NoLogCollection:
Send-DiagnosticData –SupplementaryLogs <path to adhoc logs to collect>
S SaveToPath:
Send-DiagnosticData –SaveToPath <path> -SupplementaryLogs <path to adhoc logs to collect>
S NoLogCollection:
Send-DiagnosticData –NoLogCollection –SupplementaryLogs <path to adhoc logs to collect>
Verze rozšíření
Verze 1.0.2.0 a vyšší
ShareCredential
Tento parametr poskytuje flexibilitu při shromažďování protokolů a jejich ukládání do cesty ke sdílené složce nebo přímé odesílání protokolů z cesty ke sdílené složce do Microsoftu.
Syntaxe
Uložte protokoly do cesty:
Send-DiagnosticData [-ShareCredential <pscredential>] -SaveToPath <path>
Odeslání protokolů na cestě ke sdílené složce do Microsoftu:
Send-DiagnosticData [-ShareCredential <pscredential>] -SupplementaryLogs <path> -NoLogCollection;
Příklady
Uložte protokoly do cesty:
Send-DiagnosticData –SaveToPath <share path> -ShareCredential <credential to share path>
Odeslání protokolů na cestě ke sdílené složce do Microsoftu:
Send-DiagnosticData –NoLogCollection –SupplementaryLogs <share path> –ShareCredential <credential to the share path>
Verze rozšíření
Všechny
(Plánování vyřazení) ToSMBShare
Tento parametr umožňuje ukládat protokoly buď do výstupní cesty, nebo do cesty ke sdílené složce. Pokud jste použili cestu ke sdílené složce, která nebyla namapovaná, musíte použít ShareCredential také parametr. Vzhledem k tomu, že tento parametr bude odebrán v budoucích verzích rozšíření, použijte -SaveToPath tento parametr.
Syntaxe
Send-DiagnosticData –ToSMBShare –SharePath <path> [-ShareCredential <pscredential>]
Příklady
Uložte protokoly do výstupní cesty nebo cesty ke sdílené složce:
Send-DiagnosticData –ToSMBShare –SharePath <output path or share path>
Uložte protokoly do cesty sdílené složky, která není namapovaná:
Send-DiagnosticData –ToSMBShare –SharePath <share path> -ShareCredential <credential for the share path>
Verze rozšíření
Tento parametr bude zpočátku přístupný ve všech verzích, ale nakonec bude omezen na verze 0.1.42 a starší.
(Plánování vyřazení) FromSMBShare
Tento parametr umožňuje odesílat protokoly z výstupní cesty nebo sdílet cestu přímo do Microsoftu. Pokud jste použili cestu ke sdílené složce, která nebyla namapovaná, musíte použít ShareCredential také parametr. Vzhledem k tomu, že tento parametr bude odebrán v budoucích verzích rozšíření, použijte -NoLogCollection tento parametr.
Syntaxe
Send-DiagnosticData –FromSMBShare –SharePath <path> [-ShareCredential <pscredential>]
Příklady
Send-DiagnosticData –FromSMBShare –SharePath <output path or share path>
Send-DiagnosticData –FromSMBShare –SharePath <share path>
Verze rozšíření
Tento parametr bude zpočátku přístupný ve všech verzích, ale nakonec bude omezen na verze 0.1.42 a starší.
(Plánování vyřazení) SharePath
Parametr SharePath lze použít pro jeden z následujících účelů:
- Uložte diagnostické protokoly do cesty ke sdílené složce nebo do výstupní cesty.
- Odesílání protokolů do Microsoftu z cesty ke sdílené složce nebo z výstupní cesty Pokud používáte cestu ke sdílené složce a cesta ke sdílené složce není mapovaná,
ShareCredential je potřeba použít také parametr.
Vzhledem k tomu, že tento parametr bude odebrán v budoucích verzích rozšíření, použijte –SaveToPath k uložení protokolů do cesty nebo –SupplementaryLogs při odesílání protokolů ad hoc do Microsoftu.
Syntaxe
Send-DiagnosticData –ToSMBShare –SharePath <path> [-ShareCredential <pscredential>];
Send-DiagnosticData –FromSMBShare –SharePath <path> [-ShareCredential <pscredential>];
Příklady
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>
Verze rozšíření
Tento parametr bude zpočátku přístupný ve všech verzích, ale nakonec bude omezen na verze 0.1.42 a starší.
Role dostupné pro filtrování protokolů
Pro filtrování podle parametru FilterByRole jsou k dispozici následující role. Dostupné role se můžou v budoucí verzi lišit.
| Název role |
Popis |
| ALM |
Správa životního cyklu aplikací (ALM) zahrnuje správu vývoje, testování, nasazení a údržby softwarových aplikací. |
| ArcAgent |
Agent, který umožňuje správu Windows Serveru přes Azure Arc. Viz přehled agenta Azure Connected Machine. |
| BareMetal |
Role infrastruktury, která umožňuje spouštět služby na holých serverech bez vrstvy virtualizace. Můžete mít úplný přístup a kontrolu nad operačním systémem a hardwarem. |
| CommonInfra |
Shromažďuje protokoly pro běžné součásti infrastruktury, jako jsou sítě, úložiště a zabezpečení. |
| Protokoly nasazení |
Zaznamenává podrobnosti o procesu nasazení, včetně provedených kroků, zjištěných chyb a stavu operace. |
| ECE |
Spravuje pracovní postupy životního cyklu, včetně nasazení, aktualizace, přidání uzlu a nahrazení uzlů. |
| Rozšíření |
Data související s rozšířeními spravovanými Azure |
| FleetDiagnosticsAgent |
Naslouchá triggerům stavu pro spuštění shromažďování protokolů. Tyto protokoly slouží k diagnostice problémů s sadou FleetDiagnosticsAgent a shromažďováním protokolů. |
| HCICloudService |
Cloudová služba Azure, která poskytuje základní funkce pro místní Azure. Kombinuje výkon Azure s flexibilitou místních počítačů. |
| DownloadService |
Část služby infra ke stažení obsahu aktualizace. |
| Zdravotnictví |
Shromažďuje data o stavu, výkonu a využití z různých zdrojů, jako jsou protokoly událostí a čítače výkonu. |
| Hostitelská síť |
Protokoly používané k řešení potíží se síťovým ATC, základní komponentou operačního systému používanou ke konfiguraci hostitelských sítí. |
| MOC_ARB |
Zásobník pro správu, který umožňuje cloudovou správu virtuálních počítačů na místních počítačích Azure a Na Windows Serveru. |
| NC |
Informace týkající se síťové infrastruktury |
| ObservabilityLogmanTraces |
Shromažďuje protokoly pro sledování pozorovatelnosti. Tyto protokoly pomáhají při řešení potíží s odesíláním diagnostických dat. |
| PozorovatelnostVolume |
Shromažďuje protokoly pro svazek pozorovatelnosti. |
| OEMDiagnostics |
Shromažďuje protokoly pro diagnostiku OEM, která může pomoct identifikovat a vyřešit problémy s hardwarem serveru, jako je BIOS, ovladače, senzory a další. |
| OSUpdateLogs |
Role, která shromažďuje protokoly související s aktualizacemi operačního systému v místních uzlech Azure, je užitečná pro řešení potíží souvisejících s aktualizacemi. |
| RemoteSupportAgent |
Protokoly, které pomáhají řešit problémy s relacemi vzdálené podpory, které se používají k řešení případů zákaznické podpory. |
| TestObservability |
Shromažďuje protokoly z Test-Observability rutiny, která slouží k otestování správného TelemetryAndDiagnostics fungování rozšíření. |
| URP |
Skládá se z protokolů souvisejících s UpdateService událostmi role ECE a OsUpdate ECE. Spravuje Update Service aktualizace pro Místní Azure. Role OsUpdate ECE slouží k získání a instalaci aktualizací operačního systému na počítače (fyzické hostitele a virtuální počítače InfraVM), které nejsou součástí systému během nasazování, přidání uzlu, uzlu opravy a scénářů aktualizace virtuálních počítačů infrastruktury. Trasování z těchto dvou součástí jsou součástí URP role. |
