Als u PowerShell wilt gebruiken voor het verzamelen van logboeken, voert u de Send-DiagnosticData
cmdlet uit vanaf elk knooppunt in het lokale Azure-exemplaar. Met deze cmdlet worden de logboeken tijdelijk lokaal gekopieerd. De gekopieerde logboeken worden geparseerd, naar Microsoft verzonden en vervolgens verwijderd uit uw systeem.
Hier volgen enkele belangrijke punten die u moet overwegen bij het verzamelen van logboeken met behulp van PowerShell:
- De voltooiingstijd van de
Send-DiagnosticData
cmdlet is afhankelijk van factoren, zoals de rollen waarvoor logboeken worden verzameld, de opgegeven tijdsduur en het aantal knooppunten in uw lokale Azure-omgeving.
- Als u geen parameters opgeeft, verzamelt de
Send-DiagnosticData
cmdlet gegevens van alle knooppunten voor de afgelopen duur van één uur.
Dit is de syntaxis van Send-DiagnosticData
:
Send-DiagnosticData [[-FilterByRole] <string[]>] [[-FromDate] <datetime>] [[-ToDate] <datetime>] [[-CollectSddc] <bool>] [<CommonParameters>]
Zie de Send-DiagnosticData
sectie met opdrachtreferenties verderop in dit artikel voor naslaginformatie Send-DiagnosticData
over de opdracht.
Voorbeelden en voorbeelduitvoer
Hier volgen enkele voorbeeldopdrachten met voorbeelduitvoer die laten zien hoe u de Send-DiagnosticData
cmdlet gebruikt met verschillende parameters.
Diagnostische gegevens verzenden met datumfiltering
In dit voorbeeld verzendt u diagnostische gegevens met datumfiltering voor logboekbestanden voor de afgelopen twee uur:
Send-DiagnosticData -FromDate (Get-Date).AddHours(-2) -ToDate (Get-Date)
Hier volgt een voorbeelduitvoer van deze opdracht:
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>
Diagnostische gegevens verzenden voor opgegeven rollen
In dit voorbeeld verzendt u diagnostische gegevens met rolfilters voor BareMetal en ECE:
Send-DiagnosticData -FilterByRole BareMetal, ECE –CollectSddc $false
Hier volgt een voorbeelduitvoer van deze opdracht:
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>
Een geschiedenis van logboekverzameling ophalen
U kunt een geschiedenis ophalen van alle logboekverzamelingen die u hebt uitgevoerd. Deze geschiedenis helpt u meer te weten te komen over de soorten logboekverzamelingen, de grootte van logboekverzamelingen, de tijdstippen waarop logboeken zijn verzameld en de methoden voor het verzamelen van logboeken.
Als u een geschiedenis van logboekverzamelingen voor de afgelopen 90 dagen wilt ophalen, voert u het volgende in:
Get-LogCollectionHistory
Hier volgt een voorbeelduitvoer van de Get-LogCollectionHistory
cmdlet. De datetime
parameters bevinden zich in de UTC-tijdzone.
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>
Logboeken opslaan in een lokale bestandsshare
U kunt diagnostische logboeken opslaan op een lokale SMB-share (Server Message Block) als u netwerkproblemen ondervindt of gegevens liever lokaal opslaat in plaats van deze naar Azure te verzenden.
Volg deze stappen om logboeken op te slaan in een lokale share:
Voer de volgende opdracht uit om een share te maken:
New-SMBShare -Name <share-name> -Path <path-to-share> -FullAccess Users -ChangeAccess 'Server Operators'
Voer de volgende opdrachten uit om PSCredentials te maken voor de share:
$user = "<username>"
$pass = "<password>"
$sec=ConvertTo-SecureString -String $pass -AsPlainText -Force
$shareCredential = New-Object System.Management.Automation.PSCredential ($user, $sec)
Voer de volgende opdracht uit op elk knooppunt van het systeem om logboeken te verzamelen en lokaal op te slaan:
Send-DiagnosticData -SaveToPath <path to share> -ShareCredential $shareCredential
Als u uitgaande connectiviteit hebt vanuit de SMB-share waarin u de logboeken hebt opgeslagen, kunt u de volgende opdracht uitvoeren om de logboeken naar Microsoft te verzenden:
Send-DiagnosticData NoLogCollection -SupplementaryLogs <path-to-share> -ShareCredentail $shareCredential
Send-DiagnosticData
naslaginformatie over opdrachten
Deze sectie bevat naslaginformatie over Send-DiagnosticData
, inclusief de parameters, syntaxis en gebruiksvoorbeelden.
FromDate en ToDate
Met deze parameters kunt u logboeken verzamelen voor een specifieke periode.
Syntaxis
Send-DiagnosticData [[-FilterByRole] <string[]>] [[-FromDate] <datetime>] [[-ToDate] <datetime>] [[-CollectSddc] <bool>] [<CommonParameters>]
Voorbeeld
$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
Extensieversie
Alle
FilterByRole
Met deze parameter kunt u kiezen welke rollenlogboeken u wilt verzamelen. U kunt meerdere rollen opgeven. Zie Rollen die beschikbaar zijn voor het filteren van logboeken voor een lijst met beschikbare rollen waarop u logboeken kunt filteren.
Syntaxis
Send-DiagnosticData [[-FilterByRole] <string[]>]
Voorbeeld
Send-DiagnosticData –FilterByRole “ALM” -CollectSddc $false
Extensieversie
Alle
CollectSddc
Bepaalt of u SDDC-logboeken (Software Defined Data Center) wilt opnemen of uitsluiten. SDDC-logboeken zijn standaard opgenomen. Stel deze in op $false als u ze wilt uitsluiten. Zie Diagnostische hulpprogramma's voor SDDC verzamelen voor systemen voor meer informatie over het gebruik van diagnostische HULPPROGRAMMA's voor SDDC.
Syntaxis
Send-DiagnosticData [-CollectSddc <bool>]
Voorbeeld
Send-DiagnosticData –CollectSddc $false
Extensieversie
Alle
BypassObsAgent
Bij het omzeilen van de waarneembaarheidsagent worden logboeken alleen verzameld op het knooppunt waar de logboekverzameling is gestart. Er wordt geen record van de verzameling bewaard in de geschiedenis.
Syntaxis
Send-DiagnosticData [-BypassObsAgent]
Voorbeeld
Send-DiagnosticData –BypassObsAgent
Extensieversie
Alle
SaveToPath
Met deze parameter kunt u de diagnostische logboeken opslaan in een opgegeven pad op de hostcomputer in plaats van ze naar Microsoft te verzenden.
Syntaxis
Send-DiagnosticData -SaveToPath <string> [-FilterByRole <string[]>] [-FromDate <datetime>] [-ToDate <datetime>] [-CollectSddc <bool>] [-SupplementaryLogs <string>] [-ShareCredential <pscredential>] [-BypassObsAgent] [<CommonParameters>]
Voorbeelden
U kunt een sharepad of een uitvoerpad op de host opgeven voor de SaveToPath
parameter.
Send-DiagnosticData –SaveToPath <output path>
Send-DiagnosticData –SaveToPath <share path>
Als u een sharepad gebruikt dat niet is toegewezen, moet u ook de -ShareCredential
parameter gebruiken.
Send-DiagnosticData –SaveToPath <share path> -ShareCredential <credentials for share path>
U kunt SaveToPath
met andere parameters, zoals FilterByRole
, FromDate
, ToDate
, CollectSddc
, , , SupplementaryLogs
en ShareCredential
BypassObsAgent
.
Send-DiagnosticData –SaveToPath <output path> -FIlterByRole <role>
Extensieversie
Versies 1.0.2.0 en hoger
NoLogCollection
Met de NoLogCollection
switchparameter kunt u een ad-hocset logboeken naar Microsoft verzenden. Houd bij het gebruik van deze parameter rekening met de volgende details:
- U kunt de
SupplementaryLogs
, ShareCredential
en BypassObsAgent
parameters combineren met de NoLogCollection
parameter.
- De
SupplementaryLogs
parameter is verplicht wanneer u deze gebruikt NoLogCollection
. Hiermee geeft u het pad op naar de logboeken die naar Microsoft moeten worden verzonden.
- U hebt de flexibiliteit om een sharepad of een uitvoerpad op de host door te geven aan de
SupplementaryLogs
parameter. Als u een niet-toegewezen sharepad gebruikt, moet u ook de -ShareCredential
parameter gebruiken.
Syntaxis
Send-DiagnosticData -SupplementaryLogs <string> -NoLogCollection [-ShareCredential <pscredential>] [-BypassObsAgent] [<CommonParameters>]
Voorbeelden
Gebruiken –NoLogCollection
met de verplichte SupplementaryLogs
parameter:
Send-DiagnosticData –NoLogCollection –SupplementaryPath <output path>
Gebruiken –NoLogCollection
met niet-toegewezen sharepad:
Send-DiagnosticData –NoLogCollection –SupplementaryPath <share path>
-ShareCredential <credential to share path>
Extensieversie
Versies 1.0.2.0 en hoger
Aanvullende logboeken
Met de parameter SupplementaryLogs kunt u ad-hoclogboeken naar Microsoft verzenden.
Syntaxis
U kunt deze op de volgende manieren gebruiken:
Met SaveToPath
. In dit scenario worden zowel diagnostische logboeken als ad-hoclogboeken verzameld en opgeslagen in een opgegeven pad.
Send-DiagnosticData [-SupplementaryLogs <string>] -SaveToPath <path>
Met NoLogCollection
. Hier worden alleen ad-hoclogboeken verzameld en naar Microsoft verzonden. Er worden geen diagnostische logboeken verzameld.
Send-DiagnosticData -SupplementaryLogs <string> -NoLogCollection
Zonder SaveToPath
of NoLogCollection
. Dit betekent dat zowel diagnostische logboeken als ad-hoclogboeken worden verzameld en naar Microsoft worden verzonden.
Send-DiagnosticData [-SupplementaryLogs <string>]
Wanneer u zowel diagnostische als ad-hoclogboeken verzamelt, kunt u de SupplementaryLogs
parameter gebruiken met andere parameters, zoals FilterByRole
, FromDate
en ToDate
CollectSddc
.
Voorbeelden
Zonder SaveToPath
of NoLogCollection
:
Send-DiagnosticData –SupplementaryLogs <path to adhoc logs to collect>
Met SaveToPath
:
Send-DiagnosticData –SaveToPath <path> -SupplementaryLogs <path to adhoc logs to collect>
Met NoLogCollection
:
Send-DiagnosticData –NoLogCollection –SupplementaryLogs <path to adhoc logs to collect>
Extensieversie
Versies 1.0.2.0 en hoger
ShareCredential
Deze parameter biedt de flexibiliteit om logboeken te verzamelen en op te slaan in een sharepad of logboeken rechtstreeks vanuit een sharepad naar Microsoft te verzenden.
Syntaxis
Logboeken opslaan in een pad:
Send-DiagnosticData [-ShareCredential <pscredential>] -SaveToPath <path>
Logboeken verzenden op een sharepad naar Microsoft:
Send-DiagnosticData [-ShareCredential <pscredential>] -SupplementaryLogs <path> -NoLogCollection;
Voorbeelden
Logboeken opslaan in een pad:
Send-DiagnosticData –SaveToPath <share path> -ShareCredential <credential to share path>
Logboeken verzenden op een sharepad naar Microsoft:
Send-DiagnosticData –NoLogCollection –SupplementaryLogs <share path> –ShareCredential <credential to the share path>
Extensieversie
Alle
(Plan om af te schaven) ToSMBShare
Met deze parameter kunt u logboeken opslaan in een uitvoerpad of een sharepad. Als u een sharepad gebruikte dat niet is toegewezen, moest u ook de ShareCredential
parameter gebruiken. Omdat deze parameter wordt verwijderd in toekomstige versies van de extensie, gebruikt u in plaats daarvan de -SaveToPath
parameter.
Syntaxis
Send-DiagnosticData –ToSMBShare –SharePath <path> [-ShareCredential <pscredential>]
Voorbeelden
Sla logboeken op in een uitvoerpad of deelpad:
Send-DiagnosticData –ToSMBShare –SharePath <output path or share path>
Sla logboeken op in een sharepad dat niet is toegewezen:
Send-DiagnosticData –ToSMBShare –SharePath <share path> -ShareCredential <credential for the share path>
Extensieversie
In eerste instantie toegankelijk voor alle versies, is deze parameter uiteindelijk beperkt tot versie 0.1.42 en eerder.
(Plan om af te schaven) FromSMBShare
Met deze parameter kunt u logboeken verzenden vanaf een uitvoerpad of het pad rechtstreeks naar Microsoft delen. Als u een sharepad gebruikte dat niet is toegewezen, moest u ook de ShareCredential
parameter gebruiken. Omdat deze parameter wordt verwijderd in toekomstige versies van de extensie, gebruikt u in plaats daarvan de -NoLogCollection
parameter.
Syntaxis
Send-DiagnosticData –FromSMBShare –SharePath <path> [-ShareCredential <pscredential>]
Voorbeelden
Send-DiagnosticData –FromSMBShare –SharePath <output path or share path>
Send-DiagnosticData –FromSMBShare –SharePath <share path>
Extensieversie
In eerste instantie toegankelijk voor alle versies, is deze parameter uiteindelijk beperkt tot versie 0.1.42 en eerder.
(Plan om af te schaven) SharePath
De SharePath-parameter kan worden gebruikt voor een van de volgende doeleinden:
- Sla diagnostische logboeken op in een sharepad of uitvoerpad.
- Logboeken verzenden naar Microsoft vanuit een sharepad of uitvoerpad. Als u een sharepad gebruikt en het sharepad niet is toegewezen, moet de
ShareCredential
parameter ook worden gebruikt.
Omdat deze parameter wordt verwijderd in toekomstige versies van de extensie, gebruikt u de –SaveToPath
parameter om logboeken op te slaan in een pad of –SupplementaryLogs
wanneer u in plaats daarvan ad-hoclogboeken naar Microsoft verzendt.
Syntaxis
Send-DiagnosticData –ToSMBShare –SharePath <path> [-ShareCredential <pscredential>];
Send-DiagnosticData –FromSMBShare –SharePath <path> [-ShareCredential <pscredential>];
Voorbeelden
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>
Extensieversie
In eerste instantie toegankelijk voor alle versies, is deze parameter uiteindelijk beperkt tot versie 0.1.42 en eerder.
Beschikbare rollen voor het filteren van logboeken
De volgende rollen zijn beschikbaar voor filteren op de parameter FilterByRole . De beschikbare rollen kunnen verschillen in een toekomstige release.
Rolnaam |
Beschrijving |
ALM |
Application Lifecycle Management (ALM) omvat het beheren van de ontwikkeling, testen, implementatie en onderhoud voor softwaretoepassingen. |
ArcAgent |
Een agent die beheer van Windows Server via Azure Arc toestaat. Zie Overzicht van de Azure Connected Machine-agent. |
BareMetal |
Infrastructuurrol waarmee u services kunt uitvoeren op bare-metalservers zonder een virtualisatielaag. U kunt volledige toegang en controle hebben over het besturingssysteem en de hardware. |
CommonInfra |
Verzamelt logboeken voor algemene infrastructuuronderdelen, zoals netwerken, opslag en beveiliging. |
DeploymentLogs |
Registreert details van het implementatieproces, inclusief de stappen die zijn uitgevoerd, er zijn fouten opgetreden en de bewerkingsstatus. |
ECE |
Beheert levenscycluswerkstromen, waaronder implementatie, update, add-node en knooppuntvervanging. |
Toestel |
Gegevens met betrekking tot beheerde Azure-extensies. |
FleetDiagnosticsAgent |
Luistert naar statustriggers om de logboekverzameling te starten. Deze logboeken worden gebruikt om problemen met FleetDiagnosticsAgent en logboekverzameling vast te stellen. |
HCICloudService |
Een Azure-cloudservice die kernfunctionaliteit biedt voor Azure Local. Het combineert Azure-kracht met de flexibiliteit van on-premises machines. |
DownloadService |
Onderdeel van infraservice om update-inhoud te downloaden. |
Gezondheidszorg |
Verzamelt status-, prestatie- en gebruiksgegevens uit verschillende bronnen, zoals gebeurtenislogboeken en prestatiemeteritems. |
HostNetwork |
Logboeken die worden gebruikt om problemen met Network ATC op te lossen, het onderliggende besturingssysteemonderdeel dat wordt gebruikt voor het configureren van hostnetwerken. |
MOC_ARB |
Beheerstack die cloudbeheer van virtuele machines in Azure lokaal en Windows Server mogelijk maakt. |
NC |
Informatie met betrekking tot de netwerkinfrastructuur. |
WaarneembaarheidLogmanTraces |
Verzamelt logboeken voor de waarneembaarheidstraceringen. Deze logboeken helpen bij het oplossen van problemen met het verzenden van diagnostische gegevens. |
WaarneembaarheidVolume |
Verzamelt logboeken voor het waarneembaarheidsvolume. |
OEMDiagnostics |
Verzamelt logboeken voor OEM-diagnostische gegevens, die kunnen helpen bij het identificeren en oplossen van problemen met uw serverhardware, zoals BIOS, stuurprogramma's, sensoren en meer. |
OSUpdateLogs |
Rol die logboeken verzamelt met betrekking tot besturingssysteemupdates op lokale Azure-knooppunten, handig voor het oplossen van problemen met betrekking tot updates. |
RemoteSupportAgent |
Logboeken die helpen bij het oplossen van problemen met externe ondersteuningssessies, die worden gebruikt om klantondersteuningscases aan te pakken. |
TestObservability |
Verzamelt logboeken van de Test-Observability cmdlet, die wordt gebruikt om te testen of de TelemetryAndDiagnostics extensie goed werkt. |
URP |
Bestaat uit logboeken met betrekking tot de UpdateService en OsUpdate ECE-rol gebeurtenissen. Hiermee Update Service worden updates voor Azure Local beheerd. De OsUpdate ECE-rol wordt gebruikt voor het verkrijgen en installeren van besturingssysteemupdates op computers (fysieke hosts en InfraVM's) die geen deel uitmaken van het systeem tijdens de implementatie, het toevoegen van knooppunten, reparatieknooppunten en infrastructuur-VM-updatescenario's. Traceringen van deze twee onderdelen maken deel uit van de URP rol. |