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 voor naslaginformatie over Send-DiagnosticData de sectie met opdrachtreferenties Send-DiagnosticData verderop in dit artikel.
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 PSCredential 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)
Als u logboeken wilt verzamelen en lokaal wilt opslaan, voert u de volgende opdracht uit op elk knooppunt van het systeem:
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> -ShareCredential $shareCredential
Send-DiagnosticData opdrachtenreferentie
Deze sectie bevat naslaginformatie over Send-DiagnosticData, inclusief de parameters, syntaxis en gebruiksvoorbeelden.
VanDatum en TotDatum
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
Filter op rol
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. Voor meer informatie over het gebruik van diagnostische hulpprogramma's voor SDDC, zie Diagnostische gegevens voor systemen verzamelen.
Syntaxis
Send-DiagnosticData [-CollectSddc <bool>]
Voorbeeld
Send-DiagnosticData -CollectSddc $false
Extensieversie
Alle
BypassObsAgent
Wanneer de waarneembaarheidsagent wordt overgeslagen, 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
OpslaanNaarPad
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 gedeeld pad of een uitvoerpad op de host opgeven voor de SaveToPath-parameter.
Send-DiagnosticData -SaveToPath <output path>
Send-DiagnosticData -SaveToPath <share path>
Als u een gedeeld pad gebruikt dat niet is aangekoppeld, moet u ook de -ShareCredential-parameter gebruiken.
Send-DiagnosticData -SaveToPath <share path> -ShareCredential <credentials for share path>
U kunt SaveToPath gebruiken met andere parameters, zoals FilterByRole, FromDate, ToDate, CollectSddc, SupplementaryLogs, ShareCredential, en BypassObsAgent.
Send-DiagnosticData -SaveToPath <output path> -FilterByRole <role>
Extensieversie
Versies 1.0.2.0 en hoger
GeenLogverzameling
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, ShareCredentialen BypassObsAgent parameters combineren met de NoLogCollection parameter.
- De
SupplementaryLogs-parameter is verplicht wanneer NoLogCollection wordt gebruikt. 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 ongemapte gedeeld pad gebruikt, moet u ook de -ShareCredential-parameter gebruiken.
Syntaxis
Send-DiagnosticData [-SupplementaryLogs <string>] -NoLogCollection [-ShareCredential <pscredential>] [-BypassObsAgent] [<CommonParameters>]
Voorbeelden
Gebruik -NoLogCollection met de verplichte SupplementaryLogs-parameter:
Send-DiagnosticData -NoLogCollection -SupplementaryLogs <output path>
Gebruik -NoLogCollection met een ongemapte gedeelde pad:
Send-DiagnosticData -NoLogCollection -SupplementaryLogs <share path>
-ShareCredential <credential to share path>
Extensieversie
Versies 1.0.2.0 en hoger
Aanvullende logboeken
Met de SupplementaryLogs parameter 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, FromDateen ToDateCollectSddc.
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
Referentie delen
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 gedeeld pad gebruikte dat niet was 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
Momenteel ondersteund in versies tot 0.1.42; afgeschaft in latere versies.
(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 gedeeld pad gebruikte dat niet was 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
Momenteel ondersteund in versies tot 0.1.42; afgeschaft in latere versies
(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 gedeeld pad gebruikt en het gedeelde pad niet is toegewezen, moet ook de parameter
ShareCredential worden gebruikt.
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>];
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
Momenteel ondersteund in versies tot 0.1.42; afgeschaft in latere versies.
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) |
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. |
| Gemene infrastructuur |
Verzamelt logboeken voor algemene infrastructuuronderdelen, zoals netwerken, opslag en beveiliging. |
| Inzetlogboeken |
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. |
| Uitbreiding |
Gegevens met betrekking tot beheerde Azure-extensies. |
| VlootDiagnostiekAgent |
Luistert naar gezondheidstriggers voor het verzamelen van logboeken. 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. |
| HostNetwerk |
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. |
| Volume van Waarneembaarheid |
Verzamelt logboeken voor het waarneembaarheidsvolume. |
| OEMDiagnostiek |
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. |
| ExterneOndersteuningsAgent |
Logboeken die helpen bij het oplossen van problemen met externe ondersteuningssessies, die worden gebruikt om klantondersteuningscases aan te pakken. |
| Testobservabiliteit |
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 rolgebeurtenissen.
Update Service beheert updates voor Azure Local. 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. Sporen van deze twee onderdelen maken deel uit van de URP rol. |
