Сбор журналов диагностики

  • Статья

Вы можете предоставлять общий доступ к журналам диагностики, созданным Azure Stack Hub. Эти журналы создаются компонентами Windows и локальными службами Azure. служба поддержки Майкрософт могут использовать журналы для устранения или выявления проблем с экземпляром Azure Stack Hub.

Чтобы приступить к сбору журналов диагностики Azure Stack Hub, необходимо зарегистрировать экземпляр. Если вы еще не зарегистрировали Azure Stack Hub, используйте привилегированную конечную точку (PEP) для предоставления общего доступа к журналам.

Отправить журналы диагностики службе поддержки Майкрософт можно несколькими способами. В зависимости от подключения к Azure, доступны следующие варианты:

На блок-схеме показано, какой параметр следует использовать для отправки журналов диагностики. Если Azure Stack Hub подключается к Azure, включите упреждающий сбор журналов. Упреждающий сбор журналов автоматически отправляет журналы диагностики в большой двоичный объект хранилища, контролируемый корпорацией Майкрософт, в Azure при возникновении критического оповещения. Вы также можете собирать журналы по запросу с помощью команды Отправить журналы сейчас. Для Azure Stack Hub, работающего в отключенной среде или при возникновении проблем с подключением, выберите Сохранить журналы локально.

Блок-схема: отправка журналов в корпорацию Майкрософт

Заблаговременная отправка журналов

Заблаговременный сбор журналов позволяет автоматически собирать и отправлять журналы диагностики из Azure Stack Hub в Майкрософт перед отправкой обращения в службу поддержки. Эти журналы собираются только при появлении оповещения о работоспособности системы. служба поддержки Майкрософт обращается к этим журналам только в контексте обращения в службу поддержки.

Начиная с Azure Stack Hub версии 2008, в упреждающем сборе журналов используется улучшенный алгоритм для записи журналов даже при возникновении ошибок, которые не видны оператору. Это улучшение помогает обеспечить сбор правильных диагностических сведений в нужное время без необходимости взаимодействия с оператором. В некоторых случаях служба поддержки Майкрософт может сразу же приступить к устранению неполадок и решению проблем. Первоначальные улучшения алгоритма сосредоточены на операциях исправления и обновления.

Когда такие оповещения срабатывают в результате события, Azure Stack Hub заранее отправляет журналы в корпорацию Майкрософт. Кроме того, Azure Stack Hub отправляет в корпорацию Майкрософт журналы, активируемые в результате других событий сбоя. Эти события не видны оператору.

Настоятельно рекомендуется включить упреждающий сбор журналов. Это позволяет команде разработчиков диагностировать проблемы, связанные с событиями сбоя, и повысить качество продукта.

Примечание

Если включен упреждающий сбор журналов и вы обновляете или изменяете регистрацию Azure Stack Hub, как описано в разделе Продление или изменение регистрации, необходимо повторно включить упреждающий сбор журналов.

Azure Stack Hub заблаговременно собирает журналы для таких событий:

Предупреждение Тип идентификатора сбоя
Обновление требует внимания Urp.UpdateWarning
Сбой обновления Urp.UpdateFailure
Предупреждение Тип идентификатора сбоя
Повреждение данных сервера таблиц StorageService.Table.server.data.corruption-Critical
"Node inaccessible for virtual machine placement" (Узел недоступен для замены виртуальной машины); AzureStack.ComputeController.HostUnresponsive
Данные службы BLOB-объектов повреждены StorageService.Blob.service.data.is.corrupted-Critical
"Account and Container Service data corruption" (Повреждение данных учетной записи и службы контейнеров) StorageService.Account.and.Container.Service.data.corruption-Critical

Начиная с Azure Stack Hub версии 2108, если упреждающий сбор журналов отключен, журналы записываются и хранятся локально для упреждающих событий сбоя. Корпорация Майкрософт обращается к локальным журналам только в контексте обращения в службу поддержки.

Упреждающий сбор журналов можно отключить и снова включить в любое время. Чтобы настроить заблаговременный сбор журналов, выполните следующие действия.

  1. Войдите на портал администратора Azure Stack Hub.
  2. Откройте окно Обзор в колонке "Справка и поддержка".
  3. Если появится баннер, выберите Enable proactive log collection (Включить упреждающий сбор журналов). Также можно выбрать Параметры и задать для параметра Proactive log collection (Упреждающий сбор журналов) значение Включить, затем выбрать Сохранить.

Примечание

Если в параметрах расположения журнала указана локальная общая папка, убедитесь, что политики управления жизненным циклом предотвращают достижение квоты на размер общего хранилища. Azure Stack Hub не отслеживает локальную общую папку и не применяет политики хранения.

Как обрабатываются эти данные

Вы подтверждаете согласие с тем, что корпорация Майкрософт периодически будет автоматически собирать журналы по оповещениям о работоспособности системы Azure Stack Hub. Вы также подтверждаете согласие на передачу и хранение этих журналов в учетной записи хранения Azure, которой управляет корпорация Майкрософт.

Данные используются для устранения неполадок с оповещениями о работоспособности системы и не используются для маркетинга, рекламы или любых других коммерческих целей без вашего согласия. Эти данные могут храниться до 90 дней, а корпорация Майкрософт обрабатывает все данные, собранные в соответствии с нашими стандартными методиками конфиденциальности.

Отзыв вашего разрешения не влияет на данные, ранее собранные с вашего согласия.

Журналы, собранные в режиме упреждающего сбора журналов, передаются в учетную запись хранения Azure, которой управляет корпорация Майкрософт. Корпорация Майкрософт может получить доступ к этим журналам в контексте обращения в службу поддержки и для улучшения работоспособности Azure Stack Hub.

Немедленная отправка журналов

Совет

Экономьте время с помощью упреждающей отправки журналов вместо отправки журналов сейчас.

Отправить журналы теперь — это вариант, при котором вы вручную собираете и отправляете журналы диагностики из Azure Stack Hub, как правило, перед тем, как отправить обращение в службу поддержки.

Отправить журналы диагностики вручную в службу поддержки Майкрософт можно двумя способами:

Если Azure Stack Hub подключен к Azure, мы рекомендуем использовать портал администрирования, так как это самый простой способ отправки журналов напрямую в корпорацию Майкрософт. Если портал недоступен, следует отправлять журналы с помощью PowerShell.

Примечание

Если вы отправляете журналы с помощью портала администрирования или командлета PowerShell, Test-AzureStack автоматически запускается в фоновом режиме для сбора диагностических сведений.

Немедленная отправка журналов с помощью портала администрирования

Чтобы немедленно отправить журналы с помощью портала администрирования, сделайте следующее:

  1. Откройте раздел Справка и поддержка Сбор журналов > Немедленная отправка журналов.
  2. Укажите время начала и окончания сбора журналов.
  3. Выберите местный часовой пояс.
  4. Щелкните Collect and Upload (Собрать и отправить).

Если вы отключены от Интернета или хотите сохранять журналы только локально, используйте метод Get-AzureStackLog для отправки журналов.

Немедленная отправка журналов с помощью PowerShell

Если вы используете метод Немедленная отправка журналов и хотите воспользоваться PowerShell вместо портала администрирования, для получения и отправки конкретных журналов вы можете применить командлет .

  • Параметры FromDate и ToDate можно использовать для сбора журналов за конкретный период времени. Если эти параметры не указаны, по умолчанию журналы собираются за последние четыре часа.

  • Чтобы фильтровать журналы по имени компьютера, используйте параметр FilterByNode. Пример.

    Send-AzureStackDiagnosticLog -FilterByNode azs-xrp01

  • Используйте параметр FilterByLogType для фильтрации журналов по типу. Доступна фильтрация по файлу, общему ресурсу или по событию Windows. Пример.

    Send-AzureStackDiagnosticLog -FilterByLogType File

  • Используйте параметр FilterByResourceProvider, чтобы отправить журналы диагностики для поставщиков дополнительных ресурсов. Далее приводится общий синтаксис ограничений.

    Send-AzureStackDiagnosticLog -FilterByResourceProvider <<value-add RP name>>

    Отправка журналов диагностики для поставщика ресурсов SQL:

    Send-AzureStackDiagnosticLog -FilterByResourceProvider SQLAdapter

    Отправка журналов диагностики для поставщика ресурсов MySQL:

    Send-AzureStackDiagnosticLog -FilterByResourceProvider MySQLAdapter

    Отправка журналов диагностики для Центров событий:

    Send-AzureStackDiagnosticLog -FilterByResourceProvider eventhub

    Отправка журналов диагностики для Azure Stack Edge:

    Send-AzureStackDiagnosticLog -FilterByResourceProvide databoxedge

  • Для отправки журналов диагностики из ролей VirtualMachines и BareMetal используйте параметр FilterByRole:

    Send-AzureStackDiagnosticLog -FilterByRole VirtualMachines,BareMetal

  • Отправка журналов диагностики из ролей VirtualMachines и BareMetal с фильтром по дате для файлов журналов за последние 8 часов:

    $fromDate = (Get-Date).AddHours(-8)
Invoke-Command -Session $pepsession -ScriptBlock {Send-AzureStackDiagnosticLog -FilterByRole VirtualMachines,BareMetal -FromDate $using:fromDate}

  • Отправка журналов диагностики из ролей VirtualMachines и BareMetal с фильтром по дате для файлов журналов за период времени между последними 8 и 2 часами:

    $fromDate = (Get-Date).AddHours(-8)
$toDate = (Get-Date).AddHours(-2)
Invoke-Command -Session $pepsession -ScriptBlock {Send-AzureStackDiagnosticLog -FilterByRole VirtualMachines,BareMetal -FromDate $using:fromDate -ToDate $using:toDate}

Примечание

Если у вас нет подключения к Интернету или вы хотите сохранить журналы локально, используйте для отправки журналов метод Get-AzureStackLog.

Как обрабатываются эти данные

Запуская сбор журналов диагностики в Azure Stack Hub, вы подтверждаете согласие на отправку этих журналов и их хранение в учетной записи хранения Azure, которой управляет корпорация Майкрософт. Специалисты службы поддержки Майкрософт смогут сразу же получить эти журналы вместе с обращением пользователя, и им не придется обращаться к нему для сбора журналов.

Сохранение журналов локально.

Вы можете сохранять журналы в локальной общей папке SMB, если Azure Stack Hub отключен от Azure. Например, можно запустить отключенную среду. Если вы обычно подключены, но у вас возникли проблемы с подключением, вы можете сохранить журналы локально, чтобы помочь в устранении неполадок.

В колонке Параметры введите путь, имя пользователя и пароль с разрешением на запись в общую папку. Во время обращения в службу поддержки служба поддержки Майкрософт предоставляет подробные инструкции по передаче этих локальных журналов. Если портал администрирования недоступен, можно использовать Get-AzureStackLog для локального сохранения журналов.

Снимок экрана параметров сбора журналов диагностики

Рекомендации по пропускной способности

Средний размер коллекции журналов диагностики зависит от того, собраны ли они упреждающе или вручную. Средний размер коллекции с упреждающим сбором составляет около 2 ГБ. Размер коллекции для отправки журналов теперь зависит от количества часов (до 4 часов) сбора и количества физических узлов в единице масштабирования Azure Stack Hub (от 4 до 16 узлов).

В следующей таблице приведены рекомендации для сред с ограниченными или лимитными подключениями к Azure.

Сетевое подключение Влияние
Подключение с низкой пропускной способностью и высокой задержкой Отправка журнала занимает длительное время.
Общее подключение Отправка также может повлиять на другие приложения или пользователей, совместно использующие сетевое подключение.
Лимитное подключение С вашего поставщика услуг Интернета может взиматься дополнительная плата за дополнительное использование сети.

Например, если скорость подключения к Интернету или канала из Azure Stack Hub составляет 5 Мбит/с (низкая пропускная способность), для отправки 2 ГБ данных журнала диагностики в службу поддержки Майкрософт потребуется около 57 минут. Для ручного сбора журналов размером 8 ГБ со скоростью 5 Мбит/с для передачи данных потребуется около 3 часов и 49 минут. Этот длительный период времени для отправки диагностических данных может задержать или повлиять на работу службы поддержки.

Просмотр коллекции журналов

Журнал сбора журналов из Azure Stack Hub отображается на странице Log collection (Сбор журналов) в колонке Справка и поддержка со следующими значениями даты и времени:

  • Time Collected (Время сбора): Время начала операции сбора журналов.
  • Состояние: "Выполняется" или "Завершено".
  • Logs start (Начало сбора журналов): Начало периода времени сбора журналов.
  • Logs end (Конец сбора журналов): Конец выбранного периода времени.
  • Тип. Тип сбора журналов: manual (вручную) или proactive (упреждающий).

Сбор журналов в колонке

См. также раздел

Обработка журнала Azure Stack Hub и данных клиента