Windows Setup Log Files and Event Logs

Windows® Setup creates log files for all actions that occur during installation. If you are experiencing problems installing Windows, consult the log files to troubleshoot the installation.

WindowsВ Setup log files are available in the following directories:

Log location before Setup can access the drive.

Log location when Setup rolls back in the event of a fatal error.

Log location of Setup actions after disk configuration.

Used to log Plug and Play device installations.

Location of memory dump from bug checks.

Location of log minidumps from bug checks.

Location of Sysprep logs.

WindowsВ Setup Event Logs

WindowsВ Setup includes the ability to review the WindowsВ Setup performance events in the Windows Event Log viewer. This enables you to more easily review the actions that occurred during WindowsВ Setup and to review the performance statistics for different parts of WindowsВ Setup. You can filter the log so as to view only relevant items that you are interested in. The WindowsВ Setup performance events are saved into a log file that is named Setup.etl, which is available in the %WINDIR%\Panther directory of all installations. To view the logs, you must use the Event Viewer included with the Windows media that corresponds to the version of the customized image that you are building.

To view the logs on a computer that does not include the corresponding kit, you must run a script from the root of the media that installs the Event Trace for Windows (ETW) provider. From the command line, type:

where D is the drive letter of the Windows DVD media.

To view the WindowsВ Setup event logs

Start the Event Viewer, expand the Windows Logs node, and then click System.

In the Actions pane, click Open Saved Log and then locate the Setup.etl file. By default, this file is available in the %WINDIR%\Panther directory.

The log file contents appear in the Event Viewer.

To Export the log to a file

From the command line, use the Wevtutil or Tracerpt commands to save the log to an .xml or text file. For information about how to use these tools, see the command-line Help. The following commands show examples of how to use the tools:

Windows Vista, Windows 7, Windows Server 2008 R2, Windows 8.1, and Windows 10 setup log file locations

This article describes where to locate these log files and which log files are most useful for troubleshooting each setup phase of Windows 7, of Windows Server 2008 R2, and of Windows Vista.

Original product version: В Windows 10 — all editions, Windows Server 2019, Windows Server 2016
Original KB number: В 927521

Introduction

Windows setup log files are in different locations on the hard disk. These locations depend on the setup phase.

Support for Windows Vista without any service packs installed ended on April 13, 2010. To continue receiving security updates for Windows, make sure you’re running Windows Vista with Service Pack 2 (SP2). For more information, see Windows XP support has ended.

Down-level phase

The downlevel phase is the Windows setup phase that is running within the previous operating system. The following table lists important log files in this setup phase.

Log file location	Description

Log file	Description
C:\WINDOWS\setupapi.log	Contains information about device changes, driver changes, and major system changes, such as service pack installations and hotfix installations. This log file is used only by Microsoft Windows XP and earlier versions.
C:$WINDOWS. BT\Sources\Panther\setupact.log	Contains information about setup actions during the installation.
C:$WINDOWS. BT\Sources\Panther\setuperr.log	Contains information about setup errors during the installation.
C:$WINDOWS. BT\Sources\Panther\miglog.xml	Contains information about the user directory structure. This information includes security identifiers (SIDs).
C:$WINDOWS. BT\Sources\Panther\PreGatherPnPList.log	Contains information about the initial capture of devices that are on the system during the downlevel phase.

Windows Preinstallation Environment phase

The Windows Preinstallation Environment (Windows PE or WinPE) phase is the Windows setup phase that occurs after the restart at the end of the downlevel phase, or when you start the computer by using the Windows installation media. The following table lists important log files in this setup phase.

Log file	Description
X:$WINDOWS. BT\Sources\Panther\setupact.log	Contains information about setup actions during the installation.
X:$WINDOWS. BT\Sources\Panther\setuperr.log	Contains information about setup errors during the installation.
X:$WINDOWS. BT\Sources\Panther\miglog.xml	Contains information about the user directory structure. This information includes security identifiers (SIDs).
X:$WINDOWS. BT\Sources\Panther\PreGatherPnPList.log	Contains information about the initial capture of devices that are on the system during the downlevel phase.
or
C:$WINDOWS. BT\Sources\Panther\setupact.log	Contains information about setup actions during the installation.
C:$WINDOWS. BT\Sources\Panther\setuperr.log	Contains information about setup errors during the installation.
C:$WINDOWS. BT\Sources\Panther\miglog.xml	Contains information about the user directory structure. This information includes security identifiers (SIDs).
C:$WINDOWS. BT\Sources\Panther\PreGatherPnPList.log	Contains information about the initial capture of devices that are on the system during the downlevel phase.

You may also see a log file in the X:\WINDOWS directory. The Setupact.log file in this directory contains information about the progress of the initial options that are selected on the Windows installation screen. The Windows installation screen appears when you start the computer by using the Windows installation media. After you select Install now from the Windows installation screen, the Setup.exe file starts, and this log file is no longer used.

Online configuration phase

The online configuration phase (the first boot phase) starts when you receive the following message:

Please wait a moment while Windows prepares to start for the first time.

During this phase, basic hardware support is installed. If it’s an upgrade installation, data and programs are also migrated. The following table lists important log files in this setup phase.

Log file	Description
C:\WINDOWS\PANTHER\setupact.log	Contains information about setup actions during the installation.
C:\WINDOWS\PANTHER\setuperr.log	Contains information about setup errors during the installation.
C:\WINDOWS\PANTHER\miglog.xml	Contains information about the user directory structure. This information includes security identifiers (SIDs).
C:\WINDOWS\INF\setupapi.dev.log	Contains information about Plug and Play devices and driver installation.
C:\WINDOWS\INF\setupapi.app.log	Contains information about application installation.
C:\WINDOWS\Panther\PostGatherPnPList.log	Contains information about the capture of devices that are on the system after the online configuration phase.
C:\WINDOWS\Panther\PreGatherPnPList.log	Contains information about the initial capture of devices that are on the system during the downlevel phase.

Windows Welcome phase

The Windows Welcome phase includes the following options and events:

• It provides the options to create user accounts.
• It provides the option to specify a name for the computer.
• The Windows System Assessment Tool (Winsat.exe) finishes performance testing to determine the Windows Experience Index rating.

The Windows Welcome phase is the final setup phase before a user signs in. The following table lists important log files in this setup phase.

Log file	Description
C:\WINDOWS\PANTHER\setupact.log	Contains information about setup actions during the installation.
C:\WINDOWS\PANTHER\setuperr.log	Contains information about setup errors during the installation.
C:\WINDOWS\PANTHER\miglog.xml	Contains information about the user directory structure. This information includes security identifiers (SIDs).
C:\WINDOWS\INF\setupapi.dev.log	Contains information about Plug and Play devices and driver installation.
C:\WINDOWS\INF\setupapi.app.log	Contains information about application installation.
C:\WINDOWS\Panther\PostGatherPnPList.log	Contains information about the capture of devices that are on the system after the online configuration phase.
C:\WINDOWS\Panther\PreGatherPnPList.log	Contains information about the initial capture of devices that are on the system during the downlevel phase.
C:\WINDOWS\Performance\Winsat\winsat.log	Contains information about the Windows System Assessment Tool performance testing results.

Rollback phase

If a Windows upgrade installation fails, and you’ve successfully rolled back the installation to the previous operating system desktop, there are several log files that you can use for troubleshooting. The following table lists important log files in this phase.

Файлы журнала Центра обновления Windows Windows Update log files

Применимо к: Windows10 Applies to: Windows 10

В следующей таблице описаны файлы журналов, созданные Windows Update. The following table describes the log files created by Windows Update.

Файл журнала Log file	Расположение Location	Описание Description	Варианты использования When to use
windowsupdate.log windowsupdate.log	C:\Windows\Logs\WindowsUpdate C:\Windows\Logs\WindowsUpdate	Начиная с Windows 8.1 и продолжая работать в Windows 10, клиент Windows Update использует трассировку событий для Windows (ETW) для создания журналов диагностики. Starting in Windows 8.1 and continuing in Windows 10, Windows Update client uses Event Tracing for Windows (ETW) to generate diagnostic logs.	Если при запуске обновления Windows вы получаете сообщение об ошибке, для устранения неполадок можно использовать сведения, включенные в файл журнала журнала Windowsupdate.log. If you receive an error message when you run Windows Update, you can use the information that is included in the Windowsupdate.log log file to troubleshoot the issue.
UpdateSessionOrchestration.etl UpdateSessionOrchestration.etl	C:\ProgramData\USOShared\Logs C:\ProgramData\USOShared\Logs	Начиная с Windows 10, оркестратор обновления отвечает за последовательность скачивания и установки различных типов обновлений из Windows Update. Starting Windows 10, the Update Orchestrator is responsible for sequence of downloading and installing various update types from Windows Update. И события регистрируются в эти .etl-файлы. And the events are logged to these .etl files.	Когда вы видите, что обновления доступны, но загрузка не запускается. When you see that the updates are available but download is not getting triggered. При загрузке обновлений, но установка не запускается. When Updates are downloaded but installation is not triggered. При установке обновлений, но перезагрузка не запускается. When Updates are installed but reboot is not triggered.
NotificationUxBroker.etl NotificationUxBroker.etl	C:\ProgramData\USOShared\Logs C:\ProgramData\USOShared\Logs	Начиная с Windows 10, всплывающее уведомление или баннер запускается NotificationUxBroker.exe. Starting Windows 10, the notification toast or the banner is triggered by NotificationUxBroker.exe.	Если вы хотите проверить, было ли вызвано уведомление или нет. When you want to check whether the notification was triggered or not.
CBS.log CBS.log	%systemroot%\Logs\CBS %systemroot%\Logs\CBS	В этом журнале содержится представление об установке обновления в стеке обслуживания. This log provides insight on the update installation part in the servicing stack.	Устранение неполадок, связанных с установкой обновления Windows. To troubleshoot the issues related to Windows Update installation.

Создание WindowsUpdate.log Generating WindowsUpdate.log

Чтобы объединить и преобразовать файлы трассировки Windows Update (.etl files) в один читаемый файл WindowsUpdate.log, см. в материале Get-WindowsUpdateLog. To merge and convert Windows Update trace files (.etl files) into a single readable WindowsUpdate.log file, see Get-WindowsUpdateLog.

При запуске комлета Get-WindowsUpdateLog создается копия файла WindowsUpdate.log в виде статичного файла журнала. When you run the Get-WindowsUpdateLog cmdlet, an copy of WindowsUpdate.log file is created as a static log file. Он не обновляется как старый WindowsUpdate.log, если вы не запустите Get-WindowsUpdateLog снова. It does not update as the old WindowsUpdate.log unless you run Get-WindowsUpdateLog again.

Компоненты журнала обновления Windows Windows Update log components

В движке Обновления Windows есть разные имена компонентов. The Windows Update engine has different component names. Ниже приводится ряд наиболее распространенных компонентов, которые отображаются в файле WindowsUpdate.log: The following are some of the most common components that appear in the WindowsUpdate.log file:

• АГЕНТ- Агент обновления Windows AGENT- Windows Update agent
• AU . Автоматические обновления выполняют эту задачу AU — Automatic Updates is performing this task
• AUCLNT- Взаимодействие между AU и зарегистрированным пользователем AUCLNT- Interaction between AU and the logged-on user
• Диспетчер cdM-device CDM- Device Manager
• Агент сжатия CMPRESS- CMPRESS- Compression agent
• API обновления ДЛЯ COMAPI-Windows COMAPI- Windows Update API
• Сведения о драйвере DRIVER-Device DRIVER- Device driver information
• DTASTOR- Обрабатывает транзакции баз данных DTASTOR- Handles database transactions
• Обработитель EEHNDLER-Expression, используемый для оценки применимости обновления EEHNDLER- Expression handler that’s used to evaluate update applicability
• HANDLER- Управляет установщиками обновления HANDLER- Manages the update installers
• Сведения об общих службах MISC MISC- General service information
• OFFLSNC— обнаружение доступных обновлений без подключения к сети OFFLSNC- Detects available updates without network connection
• Сведения о выражении PARSER-Parses PARSER- Parses expression information
• PT- Синхронизирует обновления сведений в локальном магазине данных PT- Synchronizes updates information to the local datastore
• REPORT- Собирает сведения о отчетности REPORT- Collects reporting information
• SERVICE-Startup/shutdown of the Automatic Updates service SERVICE- Startup/shutdown of the Automatic Updates service
• SETUP- Устанавливает новые версии клиента обновления Windows, когда он доступен SETUP- Installs new versions of the Windows Update client when it is available
• SHUTDWN-Install at shutdown feature SHUTDWN- Install at shutdown feature
• WUREDIR— файлы перенаправления обновления Windows WUREDIR- The Windows Update redirector files
• WUWEB— управление обновлением Windows ActiveX WUWEB- The Windows Update ActiveX control
• ProtocolTalker — синхронизация с клиентом-сервером ProtocolTalker — Client-server sync
• DownloadManager — создает и отслеживает загрузки полезной нагрузки DownloadManager — Creates and monitors payload downloads
• Обработчик, установка — обработчики установки (CBS и т. п.) Handler, Setup — Installer handlers (CBS, and so on)
• EEHandler — оценка правил применимости к обновлению EEHandler — Evaluating update applicability rules
• DataStore — локальное обновление данных кэшинга DataStore — Caching update data locally
• IdleTimer — отслеживание активных вызовов, остановка службы IdleTimer — Tracking active calls, stopping a service

Многие сообщения журнала компонентов неоценимы, если вы ищете проблемы в этой области. Many component log messages are invaluable if you are looking for problems in that specific area. Однако они могут быть бесполезными, если не фильтровать, чтобы исключить нерелевантные компоненты, чтобы можно было сосредоточиться на важных компонентах. However, they can be useless if you don’t filter to exclude irrelevant components so that you can focus on what’s important.

Структура журнала обновления Windows Windows Update log structure

Структура журнала обновления Windows разделена на четыре основных удостоверения: The Windows update log structure is separated into four main identities:

• Отметки времени Time Stamps
• Process ID and Thread ID Process ID and Thread ID
• Имя компонента Component Name
• Идентификаторы обновления Update Identifiers
  • Update ID and Revision Number Update ID and Revision Number
  • Изменение ID Revision ID
  • Локальный ID Local ID
  • Несогласованная терминология Inconsistent terminology

Структура WindowsUpdate.log обсуждается в следующих разделах. The WindowsUpdate.log structure is discussed in the following sections.

Штампы времени Time stamps

Отметка времени указывает время ведения журнала. The time stamp indicates the time at which the logging occurs.

• Обычно сообщения находятся в хронологическом порядке, но могут быть исключения. Messages are usually in chronological order, but there may be exceptions.
• Пауза во время синхронизации может указывать на проблему сети, даже если проверка будет успешной. A pause during a sync can indicate a network problem, even if the scan succeeds.
• Длинная пауза в конце сканирования может указывать на проблему цепи суперсемейки. A long pause near the end of a scan can indicate a supersedence chain issue.
  

ID процесса и нить ID Process ID and thread ID

ID-данные процесса и потоковые ИД являются случайными, и они могут отличаться от журнала к журналу и даже от сеанса службы до сеанса службы в одном журнале. The Process IDs and Thread IDs are random, and they can vary from log to log and even from service session to service session within the same log.

• Первые четыре двузначные цифры — это код процесса. The first four hex digits are the process ID.
• Следующие четыре двузначные цифры — это код потока. The next four hex digits are the thread ID.
• Каждый компонент, например usO, двигатель обновления Windows, вызыватели API COM и обработчики установщика обновления Windows, имеет свой собственный ID процесса. Each component, such as the USO, Windows Update engine, COM API callers, and Windows Update installer handlers, has its own process ID.
  

Имя компонента Component name

Поиск и определение компонентов, связанных с идентификацией. Search for and identify the components that are associated with the IDs. Различные части двигателя обновления Windows имеют разные имена компонентов. Different parts of the Windows Update engine have different component names. Некоторые из них являются следующими: Some of them are as follows:

• ProtocolTalker — синхронизация с клиентом-сервером ProtocolTalker — Client-server sync
• DownloadManager — создает и отслеживает загрузки полезной нагрузки DownloadManager — Creates and monitors payload downloads
• Обработчик, установка — обработчики установки (CBS и т.д.) Handler, Setup — Installer handlers (CBS, etc.)
• EEHandler — оценка правил применимости к обновлению EEHandler — Evaluating update applicability rules
• DataStore — локальное обновление данных кэшинга DataStore — Caching update data locally
• IdleTimer — отслеживание активных вызовов, остановка службы IdleTimer — Tracking active calls, stopping service

Идентификаторы обновления Update identifiers

Update ID and revision number Update ID and revision number

Существуют различные идентификаторы для одного и того же обновления в разных контекстах. There are different identifiers for the same update in different contexts. Важно знать схемы идентификаторов. It’s important to know the identifier schemes.

• Update ID: GUID (указанный на предыдущем скриншоте), который назначен заданным обновлениям во время публикации Update ID: A GUID (indicated in the previous screenshot) that’s assigned to a given update at publication time
• Номер версии. Число, приращенное каждый раз при внесении изменения и переопубликовки данного обновления (с заданным ИД обновления) в службе. Revision number: A number incremented every time that a given update (that has a given update ID) is modified and republished on a service
• Номера версий повторно будут повторноиспользоваться из одного обновления в другое (а не уникальный идентификатор). Revision numbers are reused from one update to another (not a unique identifier).
• ID обновления и номер ревизии часто показаны вместе как «.revision». The update ID and revision number are often shown together as «.revision.»

Изменение ID Revision ID

• Update ID (не путайте это значение с «номером ревизии») — это серийный номер, который выдается при первоначальном опубликовании или исправлении обновления в данной службе. A Revision ID (don’t confuse this value with «revision number») is a serial number that’s issued when an update is initially published or revised on a given service.
• В обновленном обновлении сохраняется один и тот же ID обновления (GUID), увеличивается число его изменений (например, от 100 до 101), но он получает новый ИД,не связанный с предыдущим ID. An existing update that’s revised keeps the same update ID (GUID), has its revision number incremented (for example, from 100 to 101), but gets a new revision ID that is not related to the previous ID.
• Коды ревизии уникальны для данного источника обновления, но не для нескольких источников. Revision IDs are unique on a given update source, but not across multiple sources.
• Один и тот же вариант обновления может иметь различные ID-версии в Windows Update и WSUS. The same update revision might have different revision IDs on Windows Update and WSUS.
• Один и тот же ID-версии может представлять различные обновления в Windows Update и WSUS. The same revision ID might represent different updates on Windows Update and WSUS.

Локальный ID Local ID

• Локальный ID — это серийный номер, выданный при получении обновления от службы заданным клиентом Обновления Windows Local ID is a serial number issued when an update is received from a service by a given Windows Update client
• Обычно в журналах отключки, особенно с использованием локального кэша для обновления информации (Datastore) Typically seen in debug logs, especially involving the local cache for update info (Datastore)
• Различные клиентские компьютеры назначят разные локальные ID-документы одному обновлению Different client PCs will assign different Local IDs to the same update
• Локальные ID,которые клиент использует, можно найти, получив файл %WINDIR%\SoftwareDistribution\Datastore\Datastore.edb You can find the local IDs that a client is using by getting the client’s %WINDIR%\SoftwareDistribution\Datastore\Datastore.edb file

Несогласованная терминология Inconsistent terminology

Иногда журналы используют термины несогласованно. Sometimes the logs use terms inconsistently. Например, в списке InstalledNonLeafUpdateIDs фактически содержатся измененные ИД, а не обновленные. For example, the InstalledNonLeafUpdateIDs list actually contains revision IDs, not update IDs.

Распознавание ID-данных по форме и контексту: Recognize IDs by form and context:

• GUID — это обновленные ID-интерфейсы GUIDs are update IDs
• Небольшие integers, которые отображаются рядом с обновлением ID являются номерами ревизии Small integers that appear alongside an update ID are revision numbers
• Крупные integers, как правило, являются ID-версии Large integers are typically revision IDs
• Небольшими наборами (особенно в Datastore) могут быть локальные ID-версии Windows Update, несовершенная Small integers (especially in Datastore) can be local IDs

Анализ файлов журнала установки Windows с помощью средства SetupDiag Windows Setup log files analysis using SetupDiag tool

SetupDiag — это диагностический инструмент, который можно использовать для анализа журналов, связанных с установкой обновлений Windows. SetupDiag is a diagnostic tool that can be used for analysis of logs related to installation of Windows Updates. Подробные сведения см. в инструкции SetupDiag. For detailed information, see SetupDiag.