Чтобы использовать PowerShell для сбора журналов, запустите Send-DiagnosticData командлет из любого узла в локальном экземпляре Azure. Этот командлет временно копирует журналы локально. Скопированные журналы анализируются, отправляются в Корпорацию Майкрософт, а затем удаляются из системы.
Ниже приведены некоторые важные моменты, которые следует учитывать при сборе журналов с помощью PowerShell:
- Время завершения
Send-DiagnosticData командлета зависит от факторов, таких как роли, для которых собираются журналы, время и количество узлов в локальной среде Azure.
- Если параметры не указаны,
Send-DiagnosticData командлет собирает данные со всех узлов за предыдущую продолжительность одного часа.
Ниже приведен синтаксис Send-DiagnosticData:
Send-DiagnosticData [[-FilterByRole] <string[]>] [[-FromDate] <datetime>] [[-ToDate] <datetime>] [[-CollectSddc] <bool>] [<CommonParameters>]
Справочные сведения Send-DiagnosticDataсм. в разделе справочника по командам Send-DiagnosticData далее в этой статье.
Примеры и примеры выходных данных
Ниже приведены некоторые примеры команд с примерами выходных данных, которые показывают, как использовать Send-DiagnosticData командлет с разными параметрами.
Отправка диагностика данных с фильтрацией дат
В этом примере вы отправляете диагностика данные с фильтрацией дат для файлов журналов за последние два часа:
Send-DiagnosticData -FromDate (Get-Date).AddHours(-2) -ToDate (Get-Date)
Ниже приведен пример выходных данных этой команды:
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>
Отправка диагностических данных для указанных ролей
В этом примере вы отправляете диагностические данные с фильтрацией ролей для BareMetal и ECE:
Send-DiagnosticData -FilterByRole BareMetal, ECE –CollectSddc $false
Ниже приведен пример выходных данных этой команды:
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>
Получение журнала сбора журналов
Вы можете получить журнал всех выполненных коллекций журналов. Эта история помогает узнать о типах коллекций журналов, размерах коллекций журналов, времени сбора журналов и методах сбора журналов.
Чтобы получить журнал коллекций журналов за последние 90 дней, введите:
Get-LogCollectionHistory
Ниже приведен пример выходных данных командлета Get-LogCollectionHistory . Параметры datetime находятся в часовом поясе 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>
Сохранение журналов в локальной общей папке
Журналы диагностики можно хранить в локальной общей папке "Блок сообщений сервера" (SMB), если у вас возникли проблемы с сетью или вы предпочитаете сохранять данные локально, а не отправлять их в Azure.
Выполните следующие действия, чтобы сохранить журналы в локальной общей папке:
Выполните следующую команду, чтобы создать общую папку:
New-SMBShare -Name <share-name> -Path <path-to-share> -FullAccess Users -ChangeAccess 'Server Operators'
Выполните следующие команды, чтобы создать PSCredentials в общую папку:
$user = "<username>"
$pass = "<password>"
$sec=ConvertTo-SecureString -String $pass -AsPlainText -Force
$shareCredential = New-Object System.Management.Automation.PSCredential ($user, $sec)
Выполните следующую команду на каждом узле системы, чтобы собирать журналы и сохранять их локально:
Send-DiagnosticData -SaveToPath <path to share> -ShareCredential $shareCredential
Если у вас есть исходящее подключение из общей папки SMB, в которой вы сохранили журналы, выполните следующую команду, чтобы отправить журналы в Корпорацию Майкрософт:
Send-DiagnosticData NoLogCollection -SupplementaryLogs <path-to-share> -ShareCredentail $shareCredential
Send-DiagnosticData Справочник по командам
В этом разделе содержатся справочные сведения о Send-DiagnosticDataпараметрах, синтаксисе и примерах использования.
FromDate и ToDate
Эти параметры позволяют собирать журналы за определенный период времени.
Синтаксис
Send-DiagnosticData [[-FilterByRole] <string[]>] [[-FromDate] <datetime>] [[-ToDate] <datetime>] [[-CollectSddc] <bool>] [<CommonParameters>]
Пример
$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
Версия расширения
Все
FilterByRole
Этот параметр позволяет выбрать журналы ролей, которые требуется собрать. Можно указать несколько ролей. Список доступных ролей, на которых можно фильтровать журналы, см. в разделе "Роли", доступные для фильтрации журналов.
Синтаксис
Send-DiagnosticData [[-FilterByRole] <string[]>]
Пример
Send-DiagnosticData –FilterByRole “ALM” -CollectSddc $false
Версия расширения
Все
CollectSddc
Определяет, следует ли включать или исключать журналы программно-определяемого центра обработки данных (SDDC). По умолчанию журналы SDDC включаются. Установите для него значение $false, если вы хотите исключить их. Дополнительные сведения об использовании средств диагностики SDDC см. в разделе "Сбор диагностических данных для систем".
Синтаксис
Send-DiagnosticData [-CollectSddc <bool>]
Пример
Send-DiagnosticData –CollectSddc $false
Версия расширения
Все
BypassObsAgent
При обходе агента наблюдаемости журналы собираются только на узле, где была инициирована коллекция журналов. Запись коллекции не хранится в журнале.
Синтаксис
Send-DiagnosticData [-BypassObsAgent]
Пример
Send-DiagnosticData –BypassObsAgent
Версия расширения
Все
SaveToPath
Этот параметр позволяет сохранять журналы диагностики в указанный путь на хост-компьютере, а не передавать их в Корпорацию Майкрософт.
Синтаксис
Send-DiagnosticData -SaveToPath <string> [-FilterByRole <string[]>] [-FromDate <datetime>] [-ToDate <datetime>] [-CollectSddc <bool>] [-SupplementaryLogs <string>] [-ShareCredential <pscredential>] [-BypassObsAgent] [<CommonParameters>]
Примеры
Можно указать путь к общей папке или выходной путь на узле параметру SaveToPath .
Send-DiagnosticData –SaveToPath <output path>
Send-DiagnosticData –SaveToPath <share path>
Если вы используете путь к общей папке, который не сопоставлен, необходимо также использовать -ShareCredential этот параметр.
Send-DiagnosticData –SaveToPath <share path> -ShareCredential <credentials for share path>
Можно использовать SaveToPath с другими параметрами, такими как FilterByRole, FromDate, ToDate, , CollectSddcи ShareCredentialSupplementaryLogsBypassObsAgent.
Send-DiagnosticData –SaveToPath <output path> -FIlterByRole <role>
Версия расширения
Версии 1.0.2.0 и более поздних версий
NoLogCollection
Параметр NoLogCollection switch позволяет отправлять в Корпорацию Майкрософт нерегламентированный набор журналов. При использовании этого параметра рассмотрите следующие сведения:
- Можно объединить
SupplementaryLogsShareCredentialпараметры и BypassObsAgent параметры с параметромNoLogCollection.
- Параметр
SupplementaryLogs является обязательным при использовании NoLogCollection. Он указывает путь к журналам, которые необходимо отправить в Корпорацию Майкрософт.
- У вас есть гибкость, чтобы передать путь к общей папке или выходной путь на узле в
SupplementaryLogs параметр. Если вы используете путь к общей папке без сопоставления, необходимо также использовать -ShareCredential этот параметр.
Синтаксис
Send-DiagnosticData -SupplementaryLogs <string> -NoLogCollection [-ShareCredential <pscredential>] [-BypassObsAgent] [<CommonParameters>]
Примеры
Используйте –NoLogCollection обязательный SupplementaryLogs параметр:
Send-DiagnosticData –NoLogCollection –SupplementaryPath <output path>
Используйте –NoLogCollection с несопоставленным путем к общей папке:
Send-DiagnosticData –NoLogCollection –SupplementaryPath <share path>
-ShareCredential <credential to share path>
Версия расширения
Версии 1.0.2.0 и более поздних версий
Дополнительные журналы
Параметр "Дополнительные журналы" позволяет отправлять нерегламентированные журналы в Корпорацию Майкрософт.
Синтаксис
Его можно использовать следующим образом:
С SaveToPath. В этом сценарии журналы диагностики и нерегламентированные журналы собираются и сохраняются в указанном пути.
Send-DiagnosticData [-SupplementaryLogs <string>] -SaveToPath <path>
С NoLogCollection. Здесь собираются и отправляются только нерегламентированные журналы в корпорацию Майкрософт. Журналы диагностики не собираются.
Send-DiagnosticData -SupplementaryLogs <string> -NoLogCollection
Без SaveToPath или NoLogCollection. Это означает, что собираются и отправляются в корпорацию Майкрософт как журналы диагностики, так и нерегламентированные журналы.
Send-DiagnosticData [-SupplementaryLogs <string>]
При сборе диагностических и нерегламентированных журналов можно использовать SupplementaryLogs параметр с другими параметрами, такими как FilterByRole, FromDateи CollectSddcToDate.
Примеры
Без илиNoLogCollection:SaveToPath
Send-DiagnosticData –SupplementaryLogs <path to adhoc logs to collect>
С:SaveToPath
Send-DiagnosticData –SaveToPath <path> -SupplementaryLogs <path to adhoc logs to collect>
С:NoLogCollection
Send-DiagnosticData –NoLogCollection –SupplementaryLogs <path to adhoc logs to collect>
Версия расширения
Версии 1.0.2.0 и более поздних версий
ShareCredential
Этот параметр обеспечивает гибкость в сборе журналов и их сохранении в пути к общей папке или непосредственной отправке журналов из пути к общей папке в Корпорацию Майкрософт.
Синтаксис
Сохраните журналы в пути:
Send-DiagnosticData [-ShareCredential <pscredential>] -SaveToPath <path>
Отправка журналов в путь к общей папке в Корпорацию Майкрософт:
Send-DiagnosticData [-ShareCredential <pscredential>] -SupplementaryLogs <path> -NoLogCollection;
Примеры
Сохраните журналы в пути:
Send-DiagnosticData –SaveToPath <share path> -ShareCredential <credential to share path>
Отправка журналов в путь к общей папке в Корпорацию Майкрософт:
Send-DiagnosticData –NoLogCollection –SupplementaryLogs <share path> –ShareCredential <credential to the share path>
Версия расширения
Все
(План нерекомендуемого) ToSMBShare
Этот параметр позволяет сохранять журналы в выходной путь или путь к общей папке. Если вы использовали путь к общей папке, который не был сопоставлен, необходимо также использовать ShareCredential параметр. Так как этот параметр будет удален в будущих версиях расширения, используйте -SaveToPath этот параметр.
Синтаксис
Send-DiagnosticData –ToSMBShare –SharePath <path> [-ShareCredential <pscredential>]
Примеры
Сохраните журналы в выходной путь или путь к общей папке:
Send-DiagnosticData –ToSMBShare –SharePath <output path or share path>
Сохраните журналы в пути к общей папке, который не сопоставлен:
Send-DiagnosticData –ToSMBShare –SharePath <share path> -ShareCredential <credential for the share path>
Версия расширения
Первоначально доступные для всех версий, однако этот параметр в конечном итоге будет ограничен версиями 0.1.42 и более ранними версиями.
(План нерекомендуемого) FromSMBShare
Этот параметр позволяет отправлять журналы из выходного пути или делиться путьом непосредственно в Корпорацию Майкрософт. Если вы использовали путь к общей папке, который не был сопоставлен, необходимо также использовать ShareCredential параметр. Так как этот параметр будет удален в будущих версиях расширения, используйте -NoLogCollection этот параметр.
Синтаксис
Send-DiagnosticData –FromSMBShare –SharePath <path> [-ShareCredential <pscredential>]
Примеры
Send-DiagnosticData –FromSMBShare –SharePath <output path or share path>
Send-DiagnosticData –FromSMBShare –SharePath <share path>
Версия расширения
Первоначально доступные для всех версий, однако этот параметр в конечном итоге будет ограничен версиями 0.1.42 и более ранними версиями.
(План нерекомендуемого) SharePath
Параметр SharePath можно использовать для одного из следующих целей:
- Сохраните журналы диагностики в пути общего ресурса или пути вывода.
- Отправка журналов в Корпорацию Майкрософт из пути к общей папке или пути вывода. Если вы используете путь к общей папке и путь к общей папке не сопоставлен,
ShareCredential то этот параметр также должен использоваться.
Так как этот параметр будет удален в будущих версиях расширения, используйте –SaveToPath его для сохранения журналов в пути или –SupplementaryLogs при отправке нерегламентированных журналов в корпорацию Майкрософт.
Синтаксис
Send-DiagnosticData –ToSMBShare –SharePath <path> [-ShareCredential <pscredential>];
Send-DiagnosticData –FromSMBShare –SharePath <path> [-ShareCredential <pscredential>];
Примеры
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>
Версия расширения
Первоначально доступные для всех версий, однако этот параметр в конечном итоге будет ограничен версиями 0.1.42 и более ранними версиями.
Роли, доступные для фильтрации журналов
Следующие роли доступны для фильтрации по параметру FilterByRole . Доступные роли могут отличаться в будущем выпуске.
| Имя роли |
Description |
| ALM |
Управление жизненным циклом приложений (ALM) включает управление разработкой, тестированием, развертыванием и обслуживанием приложений программного обеспечения. |
| ArcAgent |
Агент, позволяющий управлять Windows Server с помощью Azure Arc. Общие сведения об агенте подключенного компьютера Azure. |
| BareMetal |
Роль инфраструктуры, которая позволяет запускать службы на серверах без виртуализации без уровня виртуализации. Вы можете иметь полный доступ и контроль над операционной системой и оборудованием. |
| CommonInfra |
Собирает журналы для общих компонентов инфраструктуры, таких как сеть, хранилище и безопасность. |
| DeploymentLogs |
Записывает сведения о процессе развертывания, включая шаги, возникшие ошибки и состояние операции. |
| ECE |
Управляет рабочими процессами жизненного цикла, включая развертывание, обновление, замену надстроек и узлов. |
| Расширение |
Данные, связанные с управляемыми расширениями Azure. |
| FleetDiagnosticsAgent |
Прослушивает триггеры работоспособности, чтобы начать сбор журналов. Эти журналы используются для диагностики проблем с Коллекцией журналов FleetDiagnosticsAgent и сбора журналов. |
| HCICloudService |
Облачная служба Azure, которая предоставляет основные функциональные возможности для локальной службы Azure. Она объединяет возможности Azure с гибкостью локальных компьютеров. |
| DownloadService |
Часть инфракрасной службы для скачивания содержимого обновления. |
| Работоспособность |
Собирает данные о работоспособности, производительности и использовании из различных источников, таких как журналы событий и счетчики производительности. |
| HostNetwork |
Журналы, используемые для устранения неполадок Сетевого ATC, базового компонента операционной системы, используемого для настройки сети узлов. |
| MOC_ARB |
Стек управления, обеспечивающий облачное управление виртуальными машинами на локальном компьютере Azure и Windows Server. |
| NC |
Сведения, связанные с сетевой инфраструктурой. |
| ObservabilityLogmanTraces |
Собирает журналы для трассировок наблюдаемости. Эти журналы помогают устранить неполадки при отправке диагностических данных. |
| ObservabilityVolume |
Собирает журналы для тома наблюдаемости. |
| OEMDiagnostics |
Собирает журналы для OEM-диагностика, которые могут помочь определить и устранить проблемы с оборудованием сервера, такими как BIOS, драйверы, датчики и многое другое. |
| OSUpdateLogs |
Роль, которая собирает журналы, связанные с обновлениями операционной системы на локальных узлах Azure, полезной для устранения неполадок, связанных с обновлением. |
| RemoteSupportAgent |
Журналы, помогающие устранять проблемы с удаленными сеансами поддержки, которые используются для решения проблем поддержки клиентов. |
| TestObservability |
Собирает журналы из командлета Test-Observability , который используется для проверки правильности TelemetryAndDiagnostics работы расширения. |
| URP |
Состоит из журналов, связанных с UpdateService OsUpdate событиями роли и ролью ECE. Управление Update Service обновлениями для локальной среды Azure. Роль OsUpdate ECE используется для получения и установки обновлений операционной системы на компьютерах (физических узлах и инфракрасных виртуальных машинах), которые не являются частью системы во время развертывания, добавления узла, узла восстановления и сценариев обновления инфракрасных виртуальных машин. Трассировки из этих двух компонентов являются частью URP роли. |
