Чтобы использовать 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параметрах, синтаксисе и примерах использования.
Дата начала и Дата окончания
Эти параметры позволяют собирать журналы за определенный период времени.
Синтаксис
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
Версия расширения
Все
ФильтрПоРоли
Этот параметр позволяет выбрать журналы ролей, которые требуется собрать. Можно указать несколько ролей. Список доступных ролей, на которых можно фильтровать журналы, см. в разделе "Роли", доступные для фильтрации журналов.
Синтаксис
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и SupplementaryLogsShareCredentialBypassObsAgent.
Send-DiagnosticData –SaveToPath <output path> -FIlterByRole <role>
Версия расширения
Версии 1.0.2.0 и более поздних версий
NoLogCollection
Параметр NoLogCollection switch позволяет отправлять в Microsoft произвольный набор журналов. При использовании этого параметра рассмотрите следующие сведения:
- Можно объединить параметры
SupplementaryLogs, ShareCredential и 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 и более поздних версий
Дополнительные журналы
Параметр Дополнительные журналы позволяет отправлять пользовательские журналы в Microsoft.
Синтаксис
Его можно использовать следующим образом:
С SaveToPath. В этом сценарии журналы диагностики и нерегламентированные журналы собираются и сохраняются по указанному пути.
Send-DiagnosticData [-SupplementaryLogs <string>] -SaveToPath <path>
С NoLogCollection. Здесь собираются и отправляются только специальные журналы в корпорацию Майкрософт. Журналы диагностики не собираются.
Send-DiagnosticData -SupplementaryLogs <string> -NoLogCollection
Без SaveToPath или NoLogCollection. Это означает, что и диагностические, и нерегламентированные журналы собираются и отправляются в корпорацию Майкрософт.
Send-DiagnosticData [-SupplementaryLogs <string>]
При сборе диагностических и ситуативных журналов можно использовать параметр SupplementaryLogs с другими параметрами, такими как FilterByRole, FromDate, ToDate и CollectSddc.
Примеры
Без SaveToPath или NoLogCollection
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>
Отправка журналов по пути к общей папке в Microsoft:
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 можно использовать для одного из следующих целей:
- Сохраните журналы диагностики на общий или выходной путь.
- Отправьте журналы в Microsoft из общего или выходного пути. Если вы используете путь к общей папке и он не сопоставлен, то параметр
ShareCredential также должен использоваться.
Поскольку этот параметр будет удален в будущих версиях расширения, вместо этого используйте –SaveToPath для сохранения журналов по пути или –SupplementaryLogs, когда отправляете нерегламентированные журналы в Microsoft.
Синтаксис
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 . Доступные роли могут отличаться в будущем выпуске.
| Имя роли |
Описание |
| ALM |
Управление жизненным циклом приложений (ALM) включает управление разработкой, тестированием, развертыванием и обслуживанием приложений программного обеспечения. |
| ArcAgent |
Агент, позволяющий управлять Windows Server с помощью Azure Arc. Общие сведения об агенте подключенного компьютера Azure. |
| BareMetal |
Роль инфраструктуры, которая позволяет запускать службы на серверах без уровня виртуализации. Вы можете иметь полный доступ и контроль над операционной системой и оборудованием. |
| CommonInfra |
Собирает журналы для общих компонентов инфраструктуры, таких как сеть, хранилище и безопасность. |
| DeploymentLogs |
Записывает сведения о процессе развертывания, включая шаги, возникшие ошибки и состояние операции. |
| ECE |
Управляет рабочими процессами жизненного цикла, включая развертывание, обновление, добавление узлов и замену узлов. |
| Расширение |
Данные, связанные с управляемыми расширениями Azure. |
| АгентДиагностикиАвтопарка |
Прослушивает триггеры состояния здоровья, чтобы начать сбор журналов. Эти журналы используются для диагностики проблем с агентом FleetDiagnosticsAgent и для сбора журналов. |
| HCICloudService |
Облачная служба Azure, которая предоставляет основные функциональные возможности для локальной службы Azure. Она объединяет возможности Azure с гибкостью локальных компьютеров. |
| DownloadService |
Часть инфраструктурной службы для загрузки обновлений контента. |
| Здоровье |
Собирает данные о работоспособности, производительности и использовании из различных источников, таких как журналы событий и счетчики производительности. |
| HostNetwork |
Журналы, используемые для устранения неполадок Network ATC, базового компонента операционной системы, используемого для настройки сетевого подключения хоста. |
| MOC_ARB |
Стек управления, обеспечивающий облачное управление виртуальными машинами на Azure Local и Windows Server. |
| NC |
Сведения, связанные с сетевой инфраструктурой. |
| ObservabilityLogmanTraces |
Собирает журналы для трассировок наблюдаемости. Эти журналы помогают устранить неполадки при отправке диагностических данных. |
| Объём Наблюдаемости |
Собирает логи для объёма данных наблюдаемости. |
| Диагностика OEM |
Собирает журналы для OEM-диагностики, которые могут помочь определить и устранить проблемы с оборудованием сервера. Это включает в себя такие компоненты, как BIOS, драйверы, датчики и многое другое. |
| OSUpdateLogs |
Роль, которая собирает журналы, связанные с обновлениями операционной системы на локальных узлах Azure, полезна для устранения неполадок, связанных с обновлениями. |
| Агент удаленной поддержки |
Журналы, помогающие устранять проблемы с удаленными сеансами поддержки, которые используются для решения проблем поддержки клиентов. |
| TestObservability |
Собирает журналы из командлета Test-Observability, который используется для проверки работоспособности расширения TelemetryAndDiagnostics. |
| УРП |
Состоит из журналов, связанных с событиями роли ECE, обозначенными UpdateService и OsUpdate.
Update Service управляет обновлениями для локальной среды Azure. Роль OsUpdate ECE используется для получения и установки обновлений операционной системы на машинах (физических хостах и инфраструктурных виртуальных машинах), которые не являются частью системы во время выполнения сценариев развертывания, добавления узла, восстановления узла и обновления инфраструктурных виртуальных машин. Следы из этих двух компонентов являются частью URP роли. |
