Pour utiliser PowerShell pour la collecte de journaux, exécutez l’applet Send-DiagnosticData de commande à partir de n’importe quel nœud dans l’instance locale Azure. Cette applet de commande copie temporairement les journaux localement. Les journaux copiés sont analysés, envoyés à Microsoft, puis supprimés de votre système.
Voici quelques points importants à prendre en compte lors de la collecte des journaux à l’aide de PowerShell :
- Le temps d’achèvement de l’applet
Send-DiagnosticData de commande varie en fonction de facteurs, tels que les rôles pour lesquels les journaux sont collectés, la durée spécifiée et le nombre de nœuds dans votre environnement local Azure.
- Si vous ne spécifiez aucun paramètre, l’applet
Send-DiagnosticData de commande collecte les données de tous les nœuds pour la durée d’une heure précédente.
Voici la syntaxe de Send-DiagnosticData:
Send-DiagnosticData [[-FilterByRole] <string[]>] [[-FromDate] <datetime>] [[-ToDate] <datetime>] [[-CollectSddc] <bool>] [<CommonParameters>]
Pour plus d’informations sur Send-DiagnosticDatales informations de référence, consultez la Send-DiagnosticData section référence de commande plus loin dans cet article.
Exemples et exemples de sorties
Voici quelques exemples de commandes avec des exemples de sorties qui montrent comment utiliser l’applet Send-DiagnosticData de commande avec différents paramètres.
Envoyer des données de diagnostic avec filtrage de date
Dans cet exemple, vous envoyez des données de diagnostic avec filtrage de date pour les fichiers journaux au cours des deux dernières heures :
Send-DiagnosticData -FromDate (Get-Date).AddHours(-2) -ToDate (Get-Date)
Voici un exemple de sortie de cette commande :
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>
Envoyer des données de diagnostic pour les rôles spécifiés
Dans cet exemple, vous envoyez des données de diagnostic avec le filtrage de rôle pour BareMetal et LE SYSTÈME d’administration :
Send-DiagnosticData -FilterByRole BareMetal, ECE –CollectSddc $false
Voici un exemple de sortie de cette commande :
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>
Obtenir un historique de la collection de journaux
Vous pouvez obtenir un historique de toutes les collections de journaux que vous avez effectuées. Cet historique vous aide à découvrir les types de collections de journaux, les tailles des collections de journaux, les heures de collecte des journaux et les méthodes de collecte de journaux.
Pour obtenir un historique des collections de journaux pour les 90 derniers jours, entrez :
Get-LogCollectionHistory
Voici un exemple de sortie de l’applet Get-LogCollectionHistory de commande. Les datetime paramètres se trouvent dans le fuseau horaire 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>
Enregistrer les journaux dans un partage de fichiers local
Vous pouvez stocker les journaux de diagnostic sur un partage SMB (Server Message Block) local si vous rencontrez des problèmes réseau ou préférez enregistrer des données localement au lieu de les envoyer à Azure.
Procédez comme suit pour enregistrer les journaux dans un partage local :
Exécutez la commande suivante pour créer un partage :
New-SMBShare -Name <share-name> -Path <path-to-share> -FullAccess Users -ChangeAccess 'Server Operators'
Exécutez les commandes suivantes pour créer des psCredentials sur le partage :
$user = "<username>"
$pass = "<password>"
$sec=ConvertTo-SecureString -String $pass -AsPlainText -Force
$shareCredential = New-Object System.Management.Automation.PSCredential ($user, $sec)
Exécutez la commande suivante sur chaque nœud du système pour collecter les journaux et les enregistrer localement :
Send-DiagnosticData -SaveToPath <path to share> -ShareCredential $shareCredential
Si vous disposez d’une connectivité sortante à partir du partage SMB où vous avez enregistré les journaux, vous pouvez exécuter la commande suivante pour envoyer les journaux à Microsoft :
Send-DiagnosticData NoLogCollection -SupplementaryLogs <path-to-share> -ShareCredentail $shareCredential
Send-DiagnosticData informations de référence sur les commandes
Cette section fournit des informations de référence sur Send-DiagnosticData, notamment ses paramètres, sa syntaxe et ses exemples d’utilisation.
FromDate et ToDate
Ces paramètres vous permettent de collecter des journaux pour une période spécifique.
Syntaxe
Send-DiagnosticData [[-FilterByRole] <string[]>] [[-FromDate] <datetime>] [[-ToDate] <datetime>] [[-CollectSddc] <bool>] [<CommonParameters>]
Exemple
$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
Version d’extension
Tous
FilterByRole
Ce paramètre vous permet de choisir les journaux des rôles que vous souhaitez collecter. Vous pouvez spécifier plusieurs rôles. Pour obtenir la liste des rôles disponibles sur lesquels vous pouvez filtrer les journaux, consultez Rôles disponibles pour le filtrage des journaux.
Syntaxe
Send-DiagnosticData [[-FilterByRole] <string[]>]
Exemple
Send-DiagnosticData –FilterByRole “ALM” -CollectSddc $false
Version d’extension
Tous
CollectSddc
Détermine s’il faut inclure ou exclure des journaux de centre de données définis par logiciel (SDDC). Par défaut, les journaux SDDC sont inclus. Définissez-la sur $false si vous souhaitez les exclure. Pour plus d’informations sur l’utilisation des outils de diagnostic SDDC, consultez Collecter des données de diagnostic pour les systèmes.
Syntaxe
Send-DiagnosticData [-CollectSddc <bool>]
Exemple
Send-DiagnosticData –CollectSddc $false
Version d’extension
Tous
BypassObsAgent
Lors du contournement de l’agent d’observabilité, les journaux d’activité sont collectés uniquement sur le nœud où la collection de journaux a été lancée. Aucun enregistrement de la collection n’est conservé dans l’historique.
Syntaxe
Send-DiagnosticData [-BypassObsAgent]
Exemple
Send-DiagnosticData –BypassObsAgent
Version d’extension
Tous
SaveToPath
Ce paramètre vous permet d’enregistrer les journaux de diagnostic dans un chemin d’accès spécifié sur l’ordinateur hôte, plutôt que de les transmettre à Microsoft.
Syntaxe
Send-DiagnosticData -SaveToPath <string> [-FilterByRole <string[]>] [-FromDate <datetime>] [-ToDate <datetime>] [-CollectSddc <bool>] [-SupplementaryLogs <string>] [-ShareCredential <pscredential>] [-BypassObsAgent] [<CommonParameters>]
Exemples
Vous pouvez fournir un chemin d’accès de partage ou un chemin de sortie sur l’hôte au SaveToPath paramètre.
Send-DiagnosticData –SaveToPath <output path>
Send-DiagnosticData –SaveToPath <share path>
Si vous utilisez un chemin de partage qui n’est pas mappé, vous devez également utiliser le -ShareCredential paramètre.
Send-DiagnosticData –SaveToPath <share path> -ShareCredential <credentials for share path>
Vous pouvez utiliser SaveToPath avec d’autres paramètres, tels que FilterByRole, , FromDateToDate, CollectSddc, SupplementaryLogs, , ShareCredential, et BypassObsAgent.
Send-DiagnosticData –SaveToPath <output path> -FIlterByRole <role>
Version d’extension
Versions 1.0.2.0 et ultérieures
NoLogCollection
Le NoLogCollection paramètre switch vous permet d’envoyer un ensemble ad hoc de journaux à Microsoft. Lorsque vous utilisez ce paramètre, tenez compte des détails suivants :
- Vous pouvez combiner les paramètres et
BypassObsAgent les SupplementaryLogsparamètres ShareCredentialavec le NoLogCollection paramètre.
- Le
SupplementaryLogs paramètre est obligatoire lors de l’utilisation NoLogCollection. Il spécifie le chemin d’accès aux journaux qui doivent être envoyés à Microsoft.
- Vous avez la possibilité de transmettre un chemin de partage ou un chemin de sortie sur l’hôte au
SupplementaryLogs paramètre. Si vous utilisez un chemin de partage non mappé, vous devez également utiliser le -ShareCredential paramètre.
Syntaxe
Send-DiagnosticData -SupplementaryLogs <string> -NoLogCollection [-ShareCredential <pscredential>] [-BypassObsAgent] [<CommonParameters>]
Exemples
Utiliser –NoLogCollection avec le paramètre obligatoire SupplementaryLogs :
Send-DiagnosticData –NoLogCollection –SupplementaryPath <output path>
Utiliser –NoLogCollection avec le chemin d’accès de partage non mappé :
Send-DiagnosticData –NoLogCollection –SupplementaryPath <share path>
-ShareCredential <credential to share path>
Version d’extension
Versions 1.0.2.0 et ultérieures
Autres journaux
Le paramètre SupplementLogs vous permet d’envoyer des journaux ad hoc à Microsoft.
Syntaxe
Vous pouvez l’utiliser de la manière suivante :
Avec SaveToPath. Dans ce scénario, les journaux de diagnostic et les journaux ad hoc sont collectés et enregistrés dans un chemin d’accès spécifié.
Send-DiagnosticData [-SupplementaryLogs <string>] -SaveToPath <path>
Avec NoLogCollection. Ici, seuls les journaux ad hoc sont collectés et envoyés à Microsoft. Aucun journal de diagnostic n’est collecté.
Send-DiagnosticData -SupplementaryLogs <string> -NoLogCollection
Sans SaveToPath ou NoLogCollection. Cela signifie que les journaux de diagnostic et les journaux ad hoc sont collectés et envoyés à Microsoft.
Send-DiagnosticData [-SupplementaryLogs <string>]
Lors de la collecte des journaux de diagnostic et ad hoc, vous pouvez utiliser le SupplementaryLogs paramètre avec d’autres paramètres tels que FilterByRole, , FromDateToDate, et CollectSddc.
Exemples
Sans SaveToPath ou NoLogCollection:
Send-DiagnosticData –SupplementaryLogs <path to adhoc logs to collect>
Avec SaveToPath :
Send-DiagnosticData –SaveToPath <path> -SupplementaryLogs <path to adhoc logs to collect>
Avec NoLogCollection :
Send-DiagnosticData –NoLogCollection –SupplementaryLogs <path to adhoc logs to collect>
Version d’extension
Versions 1.0.2.0 et ultérieures
ShareCredential
Ce paramètre offre la possibilité de collecter des journaux et de les enregistrer dans un chemin d’accès de partage ou d’envoyer directement des journaux à partir d’un chemin de partage à Microsoft.
Syntaxe
Enregistrez les journaux dans un chemin d’accès :
Send-DiagnosticData [-ShareCredential <pscredential>] -SaveToPath <path>
Envoyer des journaux sur un chemin d’accès de partage à Microsoft :
Send-DiagnosticData [-ShareCredential <pscredential>] -SupplementaryLogs <path> -NoLogCollection;
Exemples
Enregistrez les journaux dans un chemin d’accès :
Send-DiagnosticData –SaveToPath <share path> -ShareCredential <credential to share path>
Envoyer des journaux sur un chemin d’accès de partage à Microsoft :
Send-DiagnosticData –NoLogCollection –SupplementaryLogs <share path> –ShareCredential <credential to the share path>
Version d’extension
Tous
(Planifier la dépréciation) ToSMBShare
Ce paramètre vous permet d’enregistrer les journaux dans un chemin de sortie ou un chemin d’accès de partage. Si vous utilisiez un chemin de partage qui n’était pas mappé, vous deviez également utiliser le ShareCredential paramètre. Étant donné que ce paramètre sera supprimé dans les futures versions de l’extension, utilisez le paramètre à la -SaveToPath place.
Syntaxe
Send-DiagnosticData –ToSMBShare –SharePath <path> [-ShareCredential <pscredential>]
Exemples
Enregistrez les journaux dans un chemin d’accès de sortie ou un chemin de partage :
Send-DiagnosticData –ToSMBShare –SharePath <output path or share path>
Enregistrez les journaux dans un chemin d’accès de partage qui n’est pas mappé :
Send-DiagnosticData –ToSMBShare –SharePath <share path> -ShareCredential <credential for the share path>
Version d’extension
Toutefois, ce paramètre sera limité à versions 0.1.42 et antérieures.
(Planifier la dépréciation) FromSMBShare
Ce paramètre vous permet d’envoyer des journaux d’activité à partir d’un chemin de sortie ou d’un chemin de partage directement à Microsoft. Si vous utilisiez un chemin de partage qui n’était pas mappé, vous deviez également utiliser le ShareCredential paramètre. Étant donné que ce paramètre sera supprimé dans les futures versions de l’extension, utilisez le paramètre à la -NoLogCollection place.
Syntaxe
Send-DiagnosticData –FromSMBShare –SharePath <path> [-ShareCredential <pscredential>]
Exemples
Send-DiagnosticData –FromSMBShare –SharePath <output path or share path>
Send-DiagnosticData –FromSMBShare –SharePath <share path>
Version d’extension
Toutefois, ce paramètre sera limité à versions 0.1.42 et antérieures.
(Planifier la dépréciation) SharePath
Le paramètre SharePath peut être utilisé à l’une des fins suivantes :
- Enregistrez les journaux de diagnostic dans un chemin d’accès de partage ou un chemin de sortie.
- Envoyez des journaux à Microsoft à partir d’un chemin d’accès de partage ou d’un chemin de sortie. Si vous utilisez un chemin de partage et que le chemin d’accès au partage n’est pas mappé, le
ShareCredential paramètre doit également être utilisé.
Étant donné que ce paramètre sera supprimé dans les futures versions de l’extension, utilisez-le –SaveToPath pour enregistrer les journaux dans un chemin d’accès ou –SupplementaryLogs lors de l’envoi de journaux ad hoc à Microsoft à la place.
Syntaxe
Send-DiagnosticData –ToSMBShare –SharePath <path> [-ShareCredential <pscredential>];
Send-DiagnosticData –FromSMBShare –SharePath <path> [-ShareCredential <pscredential>];
Exemples
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>
Version d’extension
Toutefois, ce paramètre sera limité à versions 0.1.42 et antérieures.
Rôles disponibles pour le filtrage des journaux
Les rôles suivants sont disponibles pour le filtrage par le paramètre FilterByRole . Les rôles disponibles peuvent être différents dans une prochaine version.
| Nom de rôle |
Description |
| ALM |
La gestion du cycle de vie des applications (ALM) implique la gestion du développement, des tests, du déploiement et de la maintenance pour les applications logicielles. |
| ArcAgent |
Agent qui permet la gestion de Windows Server via Azure Arc. Consultez la vue d’ensemble de l’agent Azure Connected Machine. |
| BareMetal |
Rôle d’infrastructure qui vous permet d’exécuter des services sur des serveurs nus sans couche de virtualisation. Vous pouvez disposer d’un accès et d’un contrôle complets sur le système d’exploitation et le matériel. |
| CommonInfra |
Collecte les journaux pour les composants d’infrastructure courants, tels que la mise en réseau, le stockage et la sécurité. |
| DeploymentLogs |
Enregistre les détails du processus de déploiement, y compris les étapes effectuées, les erreurs rencontrées et l’état de l’opération. |
| ECE |
Gère les workflows de cycle de vie, notamment le déploiement, la mise à jour, le nœud de complément et le remplacement de nœud. |
| Extension |
Données liées aux extensions managées Azure. |
| FleetDiagnosticsAgent |
Écoute les déclencheurs d’intégrité pour démarrer la collecte de journaux. Ces journaux sont utilisés pour diagnostiquer les problèmes liés à FleetDiagnosticsAgent et à la collecte des journaux. |
| HCICloudService |
Un service cloud Azure qui fournit des fonctionnalités de base pour Azure Local. Il combine la puissance Azure avec la flexibilité des machines locales. |
| DownloadService |
Partie du service infra pour télécharger le contenu de mise à jour. |
| Intégrité |
Collecte les données d’intégrité, de performances et d’utilisation à partir de différentes sources, telles que les journaux d’événements et les compteurs de performances. |
| HostNetwork |
Journaux utilisés pour résoudre les problèmes d’ATC réseau, composant du système d’exploitation sous-jacent utilisé pour configurer la mise en réseau hôte. |
| MOC_ARB |
Pile de gestion qui permet la gestion basée sur le cloud des machines virtuelles sur Azure Local et Windows Server. |
| NC |
Informations relatives à l’infrastructure réseau. |
| ObservabilityLogmanTraces |
Collecte les journaux pour les traces d’observabilité. Ces journaux aident à résoudre les problèmes liés à l’envoi de données de diagnostic. |
| ObservabilityVolume |
Collecte les journaux d’activité pour le volume d’observabilité. |
| OEMDiagnostics |
Collecte les journaux des diagnostics OEM, qui peuvent aider à identifier et résoudre les problèmes liés à votre matériel serveur, tels que BIOS, pilotes, capteurs, etc. |
| OSUpdateLogs |
Rôle qui collecte les journaux liés aux mises à jour du système d’exploitation sur les nœuds locaux Azure, utile pour résoudre les problèmes liés aux mises à jour. |
| RemoteSupportAgent |
Journaux qui aident à résoudre les problèmes liés aux sessions de support à distance, qui sont utilisés pour résoudre les cas de support client. |
| TestObservability |
Collecte les journaux à partir de l’applet Test-Observability de commande, qui est utilisé pour tester que l’extension TelemetryAndDiagnostics fonctionne correctement. |
| URP |
Se compose des journaux d’activité liés aux événements de rôle DE L’AE et OsUpdate à ceux-ciUpdateService. Gère les Update Service mises à jour pour Azure Local. Le OsUpdate rôle ECM est utilisé pour acquérir et installer des mises à jour du système d’exploitation sur des machines (hôtes physiques et InfraVMs) qui ne font pas partie du système pendant le déploiement, ajouter un nœud, un nœud de réparation et des scénarios de mise à jour de machines virtuelles Infra. Les traces de ces deux composants font partie du URP rôle. |
