A PowerShell naplógyűjtéshez való használatához futtassa a Send-DiagnosticData parancsmagot az Azure Stack HCI-fürt bármely csomópontjáról. Ez a parancsmag ideiglenesen helyileg másolja a naplókat. A program elemzi a másolt naplókat, elküldi a Microsoftnak, majd törli a rendszerből.
Az alábbiakban néhány fontos szempontot érdemes figyelembe venni a naplók PowerShell-lel történő gyűjtésekor:
- A parancsmag befejezési
Send-DiagnosticData ideje különböző tényezőktől függ, például a naplók gyűjtéséhez használt szerepköröktől, a megadott időtartamtól és az Azure Stack HCI-környezetben lévő csomópontok számától.
- Ha nem ad meg paramétereket, a parancsmag adatokat
Send-DiagnosticData gyűjt az összes csomópontról az előző egyórás időtartamban.
Az alábbiak szintaxisa Send-DiagnosticData:
Send-DiagnosticData [[-FilterByRole] <string[]>] [[-FromDate] <datetime>] [[-ToDate] <datetime>] [[-CollectSddc] <bool>] [<CommonParameters>]
A hivatkozással kapcsolatos információkért Send-DiagnosticDatatekintse meg a Send-DiagnosticData jelen cikk későbbi részében található parancshivatkozási szakaszt.
Példák és mintakimenetek
Íme néhány példaparancs mintakimenetekkel, amelyek bemutatják, hogyan használhatja a Send-DiagnosticData parancsmagot különböző paraméterekkel.
Diagnosztikai adatok küldése dátumszűréssel
Ebben a példában diagnosztikai adatokat küld a naplófájlok dátumszűrésével az elmúlt két órában:
Send-DiagnosticData -FromDate (Get-Date).AddHours(-2) -ToDate (Get-Date)
Íme egy példa a parancs kimenetére:
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>
Diagnosztikai adatok küldése megadott szerepkörökhöz
Ebben a példában a BareMetal és az ECE szerepkörszűrésével küld diagnosztikai adatokat:
Send-DiagnosticData -FilterByRole BareMetal, ECE –CollectSddc $false
Íme egy példa a parancs kimenetére:
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>
Naplógyűjtési előzmények lekérése
Lekérheti az összes elvégzett naplógyűjtemény előzményeit. Ez az előzmények segítenek megismerni a naplógyűjtemények típusait, a naplógyűjtemények méretét, a naplók gyűjtésének idejét és a naplógyűjtés módszereit.
Az elmúlt 90 nap naplógyűjteményeinek előzményeinek lekéréséhez írja be a következőt:
Get-LogCollectionHistory
Íme a parancsmag mintakimenete Get-LogCollectionHistory . A datetime paraméterek az UTC időzónában vannak.
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>
Naplók mentése helyi fájlmegosztásba
A diagnosztikai naplókat egy helyi kiszolgálói üzenetblokkban (SMB) tárolhatja, ha hálózati problémákat tapasztal, vagy inkább helyileg szeretné menteni az adatokat az Azure-ba való küldés helyett.
A naplók helyi megosztásba való mentéséhez kövesse az alábbi lépéseket:
Megosztás létrehozásához futtassa a következő parancsot:
New-SMBShare -Name <share-name> -Path <path-to-share> -FullAccess Users -ChangeAccess 'Server Operators'
Futtassa a következő parancsokat a PS-hitelesítő adatok a megosztáshoz való létrehozásához:
$user = "<username>"
$pass = "<password>"
$sec=ConvertTo-SecureString -String $pass -AsPlainText -Force
$shareCredential = New-Object System.Management.Automation.PSCredential ($user, $sec)
Futtassa a következő parancsot a fürt minden csomópontján a naplók gyűjtéséhez és helyi mentéséhez:
Send-DiagnosticData -SaveToPath <path to share> -ShareCredential $shareCredential
Ha kimenő kapcsolattal rendelkezik abból az SMB-megosztásból, ahová a naplókat mentette, a következő paranccsal küldheti el a naplókat a Microsoftnak:
Send-DiagnosticData NoLogCollection -SupplementaryLogs <path-to-share> -ShareCredentail $shareCredential
Send-DiagnosticData parancshivatkozás
Ez a szakasz a paraméterekre, szintaxisra és használati példákra Send-DiagnosticDatavonatkozó referenciainformációkat tartalmaz.
FromDate és ToDate
Ezek a paraméterek lehetővé teszik, hogy naplókat gyűjtsön egy adott időszakra.
Szintaxis
Send-DiagnosticData [[-FilterByRole] <string[]>] [[-FromDate] <datetime>] [[-ToDate] <datetime>] [[-CollectSddc] <bool>] [<CommonParameters>]
Példa
$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
Bővítmény verziója
Mind
FilterByRole
Ez a paraméter lehetővé teszi, hogy eldöntse, mely szerepkörök naplóit szeretné összegyűjteni. Több szerepkört is megadhat. A naplók szűréséhez elérhető szerepkörök listáját a naplók szűréséhez elérhető szerepkörök című témakörben találja.
Szintaxis
Send-DiagnosticData [[-FilterByRole] <string[]>]
Példa
Send-DiagnosticData –FilterByRole “ALM” -CollectSddc $false
Bővítmény verziója
Mind
CollectSddc
Ez a paraméter segít meghatározni, hogy szoftveralapú adatközpont-naplókat (SDDC- vagy SDDC-naplókat) tartalmaz-e vagy zárjon ki. Alapértelmezés szerint az SDDC-naplók is szerepelnek benne. Ha ki szeretné zárni őket, állítsa $false. Az SDDC diagnosztikai eszközeinek használatáról további információt a fürtök diagnosztikai adatainak összegyűjtése című témakörben talál.
Szintaxis
Send-DiagnosticData [-CollectSddc <bool>]
Példa
Send-DiagnosticData –CollectSddc $false
Bővítmény verziója
Mind
BypassObsAgent
A megfigyelhetőségi ügynök megkerülésekor a rendszer csak azon a csomóponton gyűjt naplókat, ahol a naplógyűjtést kezdeményezték. A gyűjteményről nincs feljegyzés az előzményekben.
Szintaxis
Send-DiagnosticData [-BypassObsAgent]
Példa
Send-DiagnosticData –BypassObsAgent
Bővítmény verziója
Mind
SaveToPath
Ez a paraméter lehetővé teszi a diagnosztikai naplók mentését a gazdaszámítógép megadott elérési útjára ahelyett, hogy a Microsoftnak továbbítanák őket.
Szintaxis
Send-DiagnosticData -SaveToPath <string> [-FilterByRole <string[]>] [-FromDate <datetime>] [-ToDate <datetime>] [-CollectSddc <bool>] [-SupplementaryLogs <string>] [-ShareCredential <pscredential>] [-BypassObsAgent] [<CommonParameters>]
Példák
Megadhat egy megosztási útvonalat vagy egy kimeneti elérési utat a gazdagépen a SaveToPath paraméternek.
Send-DiagnosticData –SaveToPath <output path>
Send-DiagnosticData –SaveToPath <share path>
Ha nem leképezett megosztási útvonalat használ, akkor a paramétert -ShareCredential is használnia kell.
Send-DiagnosticData –SaveToPath <share path> -ShareCredential <credentials for share path>
Más paraméterekkel is használhatóSaveToPath, például FilterByRole, , ToDateFromDate, CollectSddc, SupplementaryLogs, ShareCredentialés BypassObsAgent.
Send-DiagnosticData –SaveToPath <output path> -FIlterByRole <role>
Bővítmény verziója
1.0.2.0-s és újabb verziók
NoLogCollection
A NoLogCollection kapcsolóparaméter lehetővé teszi, hogy alkalmi naplókat küldjön a Microsoftnak. A paraméter használatakor vegye figyelembe a következő részleteket:
- A paraméterrel kombinálhatja a
SupplementaryLogs, ShareCredentialés BypassObsAgent a NoLogCollection paramétereket.
- A
SupplementaryLogs paraméter használata kötelező NoLogCollection. Meghatározza a Microsoftnak küldendő naplók elérési útját.
- Rugalmasan adhat át egy megosztási útvonalat vagy egy kimeneti útvonalat a gazdagépen a
SupplementaryLogs paraméternek. Ha nem megfeleltetett megosztási útvonalat használ, a paramétert -ShareCredential is használnia kell.
Szintaxis
Send-DiagnosticData -SupplementaryLogs <string> -NoLogCollection [-ShareCredential <pscredential>] [-BypassObsAgent] [<CommonParameters>]
Példák
Használja –NoLogCollection a kötelező SupplementaryLogs paraméterrel:
Send-DiagnosticData –NoLogCollection –SupplementaryPath <output path>
Kihasználatlan –NoLogCollection megosztási útvonal használata:
Send-DiagnosticData –NoLogCollection –SupplementaryPath <share path>
-ShareCredential <credential to share path>
Bővítmény verziója
1.0.2.0-s és újabb verziók
Kiegészítő naplók
A Kiegészítőnaplók paraméter lehetővé teszi, hogy alkalmi naplókat küldjön a Microsoftnak.
Szintaxis
A következő módokon használható:
Ebben a forgatókönyvben SaveToPatha rendszer a diagnosztikai naplókat és az alkalmi naplókat is összegyűjti és egy megadott elérési útra menti.
Send-DiagnosticData [-SupplementaryLogs <string>] -SaveToPath <path>
NoLogCollectionItt csak alkalmi naplókat gyűjtünk össze és küldünk el a Microsoftnak. A rendszer nem gyűjt diagnosztikai naplókat.
Send-DiagnosticData -SupplementaryLogs <string> -NoLogCollection
Nélkül SaveToPath vagy NoLogCollection. Ez azt jelenti, hogy a rendszer a diagnosztikai naplókat és az alkalmi naplókat is összegyűjti és elküldi a Microsoftnak.
Send-DiagnosticData [-SupplementaryLogs <string>]
A diagnosztikai és az alkalmi naplók gyűjtésekor a SupplementaryLogs paramétert más paraméterekkel is használhatja, például FilterByRole, FromDate, ToDateés CollectSddc.
Példák
Nélkül SaveToPath vagy NoLogCollection:
Send-DiagnosticData –SupplementaryLogs <path to adhoc logs to collect>
A következővel SaveToPath:
Send-DiagnosticData –SaveToPath <path> -SupplementaryLogs <path to adhoc logs to collect>
A következővel NoLogCollection:
Send-DiagnosticData –NoLogCollection –SupplementaryLogs <path to adhoc logs to collect>
Bővítmény verziója
1.0.2.0-s és újabb verziók
ShareCredential
Ez a paraméter lehetővé teszi a naplók gyűjtését és mentését egy megosztási útvonalra, vagy közvetlenül a megosztási útvonalról a Microsoftnak küldött naplókat.
Szintaxis
Naplók mentése elérési útra:
Send-DiagnosticData [-ShareCredential <pscredential>] -SaveToPath <path>
Naplók küldése megosztási útvonalon a Microsoftnak:
Send-DiagnosticData [-ShareCredential <pscredential>] -SupplementaryLogs <path> -NoLogCollection;
Példák
Naplók mentése elérési útra:
Send-DiagnosticData –SaveToPath <share path> -ShareCredential <credential to share path>
Naplók küldése megosztási útvonalon a Microsoftnak:
Send-DiagnosticData –NoLogCollection –SupplementaryLogs <share path> –ShareCredential <credential to the share path>
Bővítmény verziója
Mind
(Az elavulás megtervezése) ToSMBShare
Ez a paraméter lehetővé teszi a naplók mentését kimeneti vagy megosztási útvonalra. Ha nem leképezett megosztási útvonalat használt, a ShareCredential paramétert is használnia kellett. Mivel ez a paraméter el lesz távolítva a bővítmény későbbi verzióiban, használja inkább a -SaveToPath paramétert.
Szintaxis
Send-DiagnosticData –ToSMBShare –SharePath <path> [-ShareCredential <pscredential>]
Példák
Naplók mentése kimeneti elérési útra vagy megosztási útvonalra:
Send-DiagnosticData –ToSMBShare –SharePath <output path or share path>
Naplók mentése olyan megosztási útvonalra, amely nincs megfeleltetve:
Send-DiagnosticData –ToSMBShare –SharePath <share path> -ShareCredential <credential for the share path>
Bővítmény verziója
Kezdetben az összes verzióban elérhető, de ez a paraméter végül a 0.1.42-s és korábbi verziókra lesz korlátozva.
(Az elavulás megtervezése) FromSMBShare
Ez a paraméter lehetővé teszi, hogy naplókat küldjön egy kimeneti útvonalról, vagy ossza meg az elérési utat közvetlenül a Microsoftnak. Ha nem leképezett megosztási útvonalat használt, a ShareCredential paramétert is használnia kellett. Mivel ez a paraméter el lesz távolítva a bővítmény későbbi verzióiban, használja inkább a -NoLogCollection paramétert.
Szintaxis
Send-DiagnosticData –FromSMBShare –SharePath <path> [-ShareCredential <pscredential>]
Példák
Send-DiagnosticData –FromSMBShare –SharePath <output path or share path>
Send-DiagnosticData –FromSMBShare –SharePath <share path>
Bővítmény verziója
Kezdetben az összes verzióban elérhető, de ez a paraméter végül a 0.1.42-s és korábbi verziókra lesz korlátozva.
(Az elavulás megtervezése) SharePath
A SharePath paraméter az alábbi célok egyikére használható:
- Diagnosztikai naplók mentése megosztási útvonalra vagy kimeneti útvonalra.
- Naplók küldése a Microsoftnak megosztási útvonalról vagy kimeneti útvonalról. Ha megosztási útvonalat használ, és a megosztási útvonal nincs megfeleltetve, akkor a
ShareCredential paramétert is használni kell.
Mivel ez a paraméter el lesz távolítva a bővítmény későbbi verzióiban, használja a –SaveToPath naplók elérési útra való mentését, vagy –SupplementaryLogs ha alkalmi naplókat küld a Microsoftnak.
Szintaxis
Send-DiagnosticData –ToSMBShare –SharePath <path> [-ShareCredential <pscredential>];
Send-DiagnosticData –FromSMBShare –SharePath <path> [-ShareCredential <pscredential>];
Példák
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>
Bővítmény verziója
Kezdetben az összes verzióban elérhető, de ez a paraméter végül a 0.1.42-s és korábbi verziókra lesz korlátozva.
A naplók szűréséhez elérhető szerepkörök
A FilterByRole paraméter szerinti szűréshez az alábbi szerepkörök érhetők el. A rendelkezésre álló szerepkörök egy későbbi kiadásban eltérőek lehetnek.
| Szerepkör neve |
Leírás |
| ALM |
Az alkalmazáséletciklus-kezelés (ALM) magában foglalja a szoftveralkalmazások fejlesztésének, tesztelésének, üzembe helyezésének és karbantartásának kezelését. |
| ArcAgent |
Olyan ügynök, amely lehetővé teszi a Windows Server Azure Arcon keresztüli kezelését. Tekintse meg az Azure Connected Machine-ügynök áttekintését. |
| Csupasz |
Infrastruktúra-szerepkör, amely lehetővé teszi, hogy virtualizálási réteg nélkül futtasson szolgáltatásokat operációs rendszer nélküli kiszolgálókon. Teljes hozzáféréssel és vezérléssel rendelkezhet az operációs rendszer és a hardver felett. |
| CommonInfra |
Naplókat gyűjt a gyakori infrastruktúra-összetevőkhöz, például a hálózatkezeléshez, a tároláshoz és a biztonsághoz. |
| Üzembe helyezési naplók |
Rögzíti az üzembehelyezési folyamat részleteit, beleértve a végrehajtott lépéseket, a hibákat és a művelet állapotát. |
| ECE |
Kezeli az életciklus-munkafolyamatokat, beleértve az üzembe helyezést, a frissítést, a csomópont-bővítményt és a csomópont cseréjét. |
| Mellék |
Az Azure által felügyelt bővítményekkel kapcsolatos adatok. |
| FleetDiagnosticsAgent |
Figyeli, hogy az állapotindítók elindítsák-e a naplógyűjtést. Ezek a naplók a FleetDiagnosticsAgent és a naplógyűjtés problémáinak diagnosztizálására szolgálnak. |
| HCICloudService |
Az Azure Stack HCI alapvető funkcióit biztosító Azure-felhőszolgáltatás. Egyesíti az Azure-teljesítményt a helyszíni kiszolgálók rugalmasságával. |
| DownloadService |
Az infraszolgáltatás része a frissítési tartalom letöltéséhez. |
| Egészségügy |
Állapot-, teljesítmény- és használati adatokat gyűjt különböző forrásokból, például eseménynaplókból és teljesítményszámlálókból. |
| HostNetwork |
A hálózati ATC, a gazdagépek hálózatkezelésének konfigurálásához használt mögöttes operációsrendszer-összetevő hibaelhárításához használt naplók. |
| MOC_ARB |
Felügyeleti verem, amely lehetővé teszi a virtuális gépek felhőalapú kezelését az Azure Stack HCI-n és a Windows Serveren. |
| NC |
A hálózati infrastruktúrával kapcsolatos információk. |
| ObservabilityLogmanTraces |
Naplókat gyűjt a megfigyelhetőségi nyomkövetésekhez. Ezek a naplók segítenek a diagnosztikai adatok küldésével kapcsolatos problémák elhárításában. |
| ObservabilityVolume |
Naplókat gyűjt a megfigyelhetőségi kötethez. |
| OEMDiagnostics |
Naplókat gyűjt az OEM-diagnosztikához, amelyek segítenek azonosítani és megoldani a kiszolgáló hardverével kapcsolatos problémákat, például a BIOS-t, az illesztőprogramokat, az érzékelőket stb. |
| OSUpdateLogs |
Az Azure Stack HCI-csomópontokon az operációs rendszer frissítéseivel kapcsolatos naplókat gyűjtő szerepkör hasznos a frissítéssel kapcsolatos problémák elhárításához. |
| RemoteSupportAgent |
A távoli támogatási munkamenetekkel kapcsolatos problémák elhárítását segítő naplók, amelyek az ügyfélszolgálati esetek kezelésére szolgálnak. |
| TestObservability |
Naplókat gyűjt a Test-Observability parancsmagból, amely annak ellenőrzésére szolgál, hogy a TelemetryAndDiagnostics bővítmény megfelelően működik-e. |
| URP |
Az ECE-szerepkör eseményeihez UpdateService OsUpdate kapcsolódó naplókból áll. Az Update Service Azure Stack HCI-rendszerek frissítéseit kezeli. Az OsUpdate ECE-szerepkör az operációsrendszer-frissítések beszerzésére és telepítésére szolgál olyan gépeken (fizikai gazdagépeken és InfraVM-eken), amelyek nem részei a fürtnek az üzembe helyezés során, csomópont hozzáadása, csomópont javítása és Infra virtuális gépek frissítési forgatókönyvei. A két összetevőből származó nyomkövetések a URP szerepkör részét képezik. |
