Ведение журналов в службах Integration Services (SSIS)Integration Services (SSIS) Logging

Применимо к:Applies to: даSQL ServerSQL Server (все поддерживаемые версии) yesSQL ServerSQL Server (all supported versions) да Azure-SSIS Integration Runtime в Фабрике данных AzureSSIS Integration Runtime in Azure Data Factoryyes Azure-SSIS Integration Runtime в Фабрике данных AzureSSIS Integration Runtime in Azure Data FactoryПрименимо к:Applies to: даSQL ServerSQL Server (все поддерживаемые версии) yesSQL ServerSQL Server (all supported versions) да Azure-SSIS Integration Runtime в Фабрике данных AzureSSIS Integration Runtime in Azure Data Factoryyes Azure-SSIS Integration Runtime в Фабрике данных AzureSSIS Integration Runtime in Azure Data Factory

Службы SQL ServerSQL Server Службы Integration ServicesIntegration Services содержат регистраторы, которые могут использоваться для реализации ведения журналов в пакетах, контейнерах и задачах.SQL ServerSQL Server Службы Integration ServicesIntegration Services includes log providers that you can use to implement logging in packages, containers, and tasks. При ведении журнала можно записать текущие сведения о пакете, что поможет при каждом выполнении пакета проводить его аудит и устранять неисправности.With logging, you can capture run-time information about a package, helping you audit and troubleshoot a package every time it is run. Например, журнал может записать имя оператора, запускающего пакет, и время, в которое пакет был начат или завершен.For example, a log can capture the name of the operator who ran the package and the time the package began and finished.

Вы можете настроить область ведения журнала на время выполнения пакета на сервере Службы Integration ServicesIntegration Services .You can configure the scope of logging that occurs during a package execution on the Службы Integration ServicesIntegration Services server. Дополнительные сведения см. в разделе Включение ведения журналов при выполнении пакета на сервере служб SSIS.For more information, see Enable Logging for Package Execution on the SSIS Server.

Можно также включить ведение журнала при выполнении пакета из командной строки с помощью программы dtexec .You can also include logging when you run a package using the dtexec command prompt utility. Дополнительные сведения об аргументах командной строки, относящихся к ведению журналов, см. в разделе служебная программа dtexec.For more information about the command prompt arguments that support logging, see dtexec Utility.

Настройка ведения журналов в SQL Server Data ToolsConfigure Logging in SQL Server Data Tools

Журналы ассоциируются с пакетами и настраиваются на уровне пакета.Logs are associated with packages and are configured at the package level. Каждая задача или контейнер пакета может вести журнал в любом журнале пакета.Each task or container in a package can log information to any package log. Можно включить ведение журналов задач и контейнеров пакета, даже если ведение журнала содержащего их пакета не включено.The tasks and containers in a package can be enabled for logging even if the package itself is not. Например, можно включить ведение журнала задачи «Выполнение SQL», не включая ведение журнала ее родительского пакета.For example, you can enable logging on an Execute SQL task without enabling logging on the parent package. Пакет, контейнер и задача могут делать записи в нескольких журналах.A package, container, or task can write to multiple logs. Можно включить ведение журнала только для пакета либо для любой индивидуальной задачи или контейнера, содержащегося в пакете.You can enable logging on the package only, or you can choose to enable logging on any individual task or container that the package includes.

При добавлении журнала к пакету выберите регистратор и место расположения журнала.When you add the log to a package, you choose the log provider and the location of the log. Регистратор указывает формат для журнальных данных: например, база данных служб SQL ServerSQL Server или текстовый файл.The log provider specifies the format for the log data: for example, a SQL ServerSQL Server database or text file.

Службы Integration ServicesIntegration Services включают следующие регистраторы.includes the following log providers:

  • Поставщики журналов текстовых файлов, которые ведут журнальные записи в текстовых файлах ASCII в формате значений, разделенных запятыми (CSV).The Text File log provider, which writes log entries to ASCII text files in a comma-separated value (CSV) format. По умолчанию для имени файла для данного регистратора используется расширение LOG.The default file name extension for this provider is .log.

  • Поставщик журнала Приложение SQL Server ProfilerSQL Server Profiler , который записывает трассировки, которые могут быть просмотрены с использованием приложения SQL ServerSQL Server Profiler.The Приложение SQL Server ProfilerSQL Server Profiler log provider, which writes traces that you can view using SQL ServerSQL Server Profiler. По умолчанию для имени файла данного регистратора используется расширение TRC.The default file name extension for this provider is .trc.

    Примечание

    Нельзя использовать регистратор Приложение SQL Server ProfilerSQL Server Profiler в пакете, работающем в 64-разрядном режиме.You cannot use the Приложение SQL Server ProfilerSQL Server Profiler log provider in a package that is running in 64-bit mode.

  • Регистратор SQL ServerSQL Server , который записывает элементы журнала в таблицу sysssislog базы данных SQL ServerSQL Server .The SQL ServerSQL Server log provider, which writes log entries to the sysssislog table in a SQL ServerSQL Server database.

  • Поставщик службы Windows «Журнал событий», который ведет журнальные записи в прикладном журнале службы Windows «Журнал событий» на локальном компьютере.The Windows Event log provider, which writes entries to the Application log in the Windows Event log on the local computer.

  • Поставщик журнала XML File, который записывает журнальные файлы в XML-файл.The XML File log provider, which writes log files to an XML file. По умолчанию для имени файла данного регистратора используется расширение XML.The default file name extension for this provider is .xml.

При добавлении регистратора к пакету или программной настройке ведения журнала для идентификации регистратора используйте или ProgID, или ClassID. Это делается вместо использования имен, которые конструктор служб Integration ServicesSSIS отображает в диалоговом окне Настройка журналов служб SSIS .If you add a log provider to a package or configure logging programmatically, you can use either a ProgID or ClassID to identify the log provider, instead of using the names that Integration ServicesSSIS Designer displays in the Configure SSIS Logs dialog box.

В следующей таблице перечислены идентификаторы ProgID и ClassID для регистраторов, содержащихся в службах Службы Integration ServicesIntegration Services , а также указано расположение журналов, в которые регистраторы записывают данные.The following table lists the ProgID and ClassID for the log providers that Службы Integration ServicesIntegration Services includes, and the location of the logs to which log providers write.

РегистраторLog provider ProgID:ProgID ClassID:ClassID LocationLocation
текстовый файлText file DTS.LogProviderTextFileDTS.LogProviderTextFile {0A039101-ACC1-4E06-943F-279948323883}{0A039101-ACC1-4E06-943F-279948323883} Используемый регистратором диспетчер подключения файлов определяет путь к текстовому файлу.The File connection manager that the log provider uses specifies the path of the text file.
Приложение SQL Server ProfilerSQL Server Profiler DTS.LogProviderSQLProfilerDTS.LogProviderSQLProfiler {E93F6300-AE0C-4916-A7BF-A8D0CE12C77A}{E93F6300-AE0C-4916-A7BF-A8D0CE12C77A} Используемый регистратором диспетчер подключения файлов определяет путь к текстовому файлу, необходимому для Приложение SQL Server ProfilerSQL Server Profiler.The File connection manager that the log provider uses specifies the path of the file used by Приложение SQL Server ProfilerSQL Server Profiler.
SQL ServerSQL Server DTS.LogProviderSQLServerDTS.LogProviderSQLServer {94150B25-6AEB-4C0D-996D-D37D1C4FDEDA}{94150B25-6AEB-4C0D-996D-D37D1C4FDEDA} Используемый регистратором диспетчер соединений с OLE DB определяет базу данных SQL ServerSQL Server , содержащую таблицу sysssislog с записями журнала.The OLE DB connection manager that the log provider uses specifies the SQL ServerSQL Server database that contains the sysssislog table with the log entries.
Журнал событий WindowsWindows Event Log DTS.LogProviderEventLogDTS.LogProviderEventLog {071CC8EB-C343-4CFF-8D58-564B92FCA3CF}{071CC8EB-C343-4CFF-8D58-564B92FCA3CF} Журнал приложений в средстве просмотра событий Windows содержит сведения о событиях служб Службы Integration ServicesIntegration Services .The Application log in Windows Event Viewer contains the Службы Integration ServicesIntegration Services log information.
XML-файлXML File DTS.LogProviderXMLFileDTS.LogProviderXMLFile {440945A4-2A22-4F19-B577-EAF5FDDC5F7A}{440945A4-2A22-4F19-B577-EAF5FDDC5F7A} Используемый регистратором диспетчер соединения файлов определяет путь к XML-файлу.The File connection manager that the log provider uses specifies the path of the XML file.

Возможно также создание пользовательских регистраторов.You can also create custom log providers. Дополнительные сведения см. в разделе Creating a Custom Log Provider.For more information, see Creating a Custom Log Provider.

Регистраторы в пакете являются элементами коллекции регистраторов пакета.The log providers in a package are members of the log providers collection of the package. При создании пакета и реализации ведения журналов с использованием конструктора служб Integration ServicesSSIS вы можете видеть список элементов коллекции в папках Регистратор на вкладке Обозреватель пакетов конструктора служб Integration ServicesSSIS .When you create a package and implement logging by using Integration ServicesSSIS Designer, you can see a list of the collection members in the Log Provider folders on the Package Explorer tab of Integration ServicesSSIS Designer.

Настройте регистратор путем предоставления имени и описания для регистратора и указания диспетчера соединений, который используется данным регистратором.You configure a log provider by providing a name and description for the log provider and specifying the connection manager that the log provider uses. Регистратор SQL ServerSQL Server использует диспетчер соединений OLE DB.The SQL ServerSQL Server log provider uses an OLE DB connection manager. Регистраторы текстового файла, приложения Приложение SQL Server ProfilerSQL Server Profilerи XML-файла используют диспетчеры подключения файлов.The Text File, Приложение SQL Server ProfilerSQL Server Profiler, and XML File log providers all use File connection managers. Регистратор журнала событий Windows не использует диспетчер соединений, потому что он напрямую обращается к журналу регистрации событий Windows.The Windows Event log provider does not use a connection manager, because it writes directly to the Windows Event log. Дополнительные сведения см. в разделах Диспетчер соединений OLE DB и диспетчер подключения файлов.For more information, see OLE DB Connection Manager and File Connection Manager.

Настройка ведения журналовLogging Customization

Чтобы настроить ведение журнала для события или пользовательского сообщения, службы Службы Integration ServicesIntegration Services предоставляют схему общих записываемых данных для включения в записи журнала.To customize the logging of an event or custom message, Службы Integration ServicesIntegration Services provides a schema of commonly logged information to include in log entries. Схема журнала служб Службы Integration ServicesIntegration Services определяет данные, которые можно сохранить в журнал.The Службы Integration ServicesIntegration Services log schema defines the information that you can log. Можно выбрать элементы схемы журнала для каждой записи.You can select elements from the log schema for each log entry.

Пакету и его контейнерам и задачам не требуется производить запись одних и тех же данных, и задачи одного пакета или контейнера могут производить запись различных данных.A package and its containers and tasks do not have to log the same information, and tasks within the same package or container can log different information. Например, пакет может производить запись сведений об операторе при запуске, одна задача может производить запись об источнике ошибки, а другая задача может производить запись о времени этой ошибки.For example, a package can log operator information when the package starts, one task can log the source of the task's failure, and another task can log information when errors occur. Если пакет и его задачи, а также контейнеры используют несколько журналов, то одни и те же данные записываются во все журналы.If a package and its containers and tasks use multiple logs, the same information is written to all the logs.

Можно выбрать необходимый уровень ведения журналов, указав события и данные каждого события для записи.You can select a level of logging that suits your needs by specifying the events to log and the information to log for each event. Можно обнаружить, что одни события предоставляют более полезные сведения, чем другие.You may find that some events provide more useful information than others. Например, можно записывать в журнал не только имена компьютеров и операторов для события PreExecute , но и все доступные данные о событии Error .For example, you might want to log only the computer and operator names for the PreExecute event but all available information for the Error event.

Для предотвращения использования журналами больших объемов дискового пространства или во избежание избыточного ведения журналов, которое может уменьшить производительность, можно ограничить ведение журналов, выбрав отдельные события и элементы данных для записи.To prevent log files from using large amounts of disk space, or to avoid excessive logging, which could degrade performance, you can limit logging by selecting specific events and information items to log. Например, можно настроить журнал на запись только даты и имени компьютера для каждой ошибки.For example, you can configure a log to capture only the date and the computer name for each error.

В конструкторе служб Integration ServicesSSIS можно определить параметры ведения журналов с помощью диалогового окна Настройка журналов служб SSIS .In Integration ServicesSSIS Designer, you define the logging options by using the Configure SSIS Logs dialog box.

Схема журналаLog Schema

Следующая таблица описывает элементы схемы журнала.The following table describes the elements in the log schema.

ЭлементElement ОписаниеDescription
КомпьютерComputer Имя компьютера, на котором произошло событие журнала.The name of the computer on which the log event occurred.
ОператорOperator Удостоверение пользователя, выполнившего запуск пакета.The identity of the user who launched the package.
SourceNameSourceName Имя контейнера или задачи, где произошло событие журнала.The name of the container or task in which the log event occurred.
SourceIDSourceID Уникальный идентификатор пакета контейнеров «цикл по элементам», «цикл по каждому элементу» или контейнера последовательности; или задача, в которой произошло событие журнала.The unique identifier of the package; the For Loop, Foreach Loop, or Sequence container; or the task in which the log event occurred.
ExecutionIDExecutionID Идентификатор GUID экземпляра выполнения пакета.The GUID of the package execution instance.

Примечание. Запуск одного пакета может создать записи в журнале с разными значениями для элемента ExecutionID.Note: Running a single package might create log entries with different values for the ExecutionID element. Например, при запуске пакета в среде SQL Server Data ToolsSQL Server Data Toolsна этапе проверки могут быть созданы записи в журнале с элементом ExecutionID, который соответствует среде SQL Server Data ToolsSQL Server Data Tools.For example, when you run a package in SQL Server Data ToolsSQL Server Data Tools, the validation phase might create log entries with an ExecutionID element that corresponds to SQL Server Data ToolsSQL Server Data Tools. Однако на этапе выполнения могут быть созданы записи журнала с элементом ExecutionID, соответствующим файлу dtshost.exe.However, the execution phase might create log entries with an ExecutionID element that corresponds to dtshost.exe. Другой пример, когда запускается пакет, содержащий задачи «Выполнение пакета», каждая из этих задач запускается в дочернем пакете.For another example, when you run a package that contains Execute Package tasks, each of these tasks runs a child package. Эти дочерние пакеты могут создавать записи в журнале, имеющие отличные элементы ExecutionID от тех, что создаются в родительском пакете.These child packages might create log entries that have a different ExecutionID element than the log entries that the parent package creates.
MessageTextMessageText Сообщение, связанное с записью журнала.A message associated with the log entry.
DataBytesDataBytes Байтовый массив, специфичный для записи журнала.A byte array specific to the log entry. Значение этого поля изменяется в зависимости от записи журнала.The meaning of this field varies by log entry.

В следующей таблице описываются три дополнительных элемента схемы журнала, которые недоступны во вкладке Подробные сведения диалогового окна Настройка журналов служб SSIS .The following table describes three additional elements in the log schema that are not available on the Details tab of the Configure SSIS Logs dialog box.

ЭлементElement DescriptionDescription
StartTimeStartTime Время начала работы контейнера или задачи.The time at which the container or task starts to run.
EndTimeEndTime Время прекращения работы контейнера или задачи.The time at which the container or task stops running.
DataCodeDataCode Необязательное целочисленное значение, которое обычно содержит значение из перечисления DTSExecResult , показывающее результат выполнения контейнера или задачи:An optional integer value that typically contains a value from the DTSExecResult enumeration that indicates the result of running the container or task:

0 — успешное завершение;0 - Success

1 — неуспешное завершение;1 - Failure

2 — завершено;2 - Completed

3 — отменено.3 - Canceled

Записи журналаLog Entries

Службы Integration ServicesIntegration Services поддерживают записи журнала для стандартных событий и предоставляют пользовательские записи журнала для многих объектов служб Службы Integration ServicesIntegration Services .supports log entries on predefined events and provides custom log entries for many Службы Integration ServicesIntegration Services objects. В конструкторе служб эти события и пользовательские записи журнала перечислены в диалоговом окне Настройка журналов служб SSIS Integration ServicesSSIS .The Configure SSIS Logs dialog box in Integration ServicesSSIS Designer lists these events and custom log entries.

В следующей таблице описаны стандартные события, которые могут быть включены для записи при возникновении событий времени выполнения.The following table describes the predefined events that can be enabled to write log entries when run-time events occur. Эти записи журнала относятся к исполняемым объектам, пакету, задачам и контейнерам, содержащимся в пакете.These log entries apply to executables, the package, and the tasks and containers that the package includes. Имя записи журнала события совпадает с именем произошедшего события выполнения, послужившего причиной записи в журнал.The name of the log entry is the same as the name of the run-time event that was raised and caused the log entry to be written.

СобытияEvents DescriptionDescription
OnErrorOnError Производит запись в журнал при возникновении ошибки.Writes a log entry when an error occurs.
OnExecStatusChangedOnExecStatusChanged Вносит запись журнала, если задача (не контейнер) приостанавливается или ее выполнение возобновляется во время отладки.Writes a log entry when a task (not a container) is suspended or resumed during debugging.
OnInformationOnInformation Производит запись в журнал во время проверки подлинности и выполнения исполняемого объекта.Writes a log entry during the validation and execution of an executable to report information.
OnPostExecuteOnPostExecute Производит запись немедленно после окончания выполнения исполняемого объекта.Writes a log entry immediately after the executable has finished running.
OnPostValidateOnPostValidate Производит запись в журнал при завершении проверки подлинности исполняемого объекта.Writes a log entry when the validation of the executable finishes.
OnPreExecuteOnPreExecute Производит запись сразу перед началом выполнения исполняемого объекта.Writes a log entry immediately before the executable runs.
OnPreValidateOnPreValidate Производит запись в журнал при начале проверки подлинности исполняемого объекта.Writes a log entry when the validation of the executable starts.
OnProgressOnProgress Производит запись в журнал в процессе выполнения исполняемого объекта.Writes a log entry when measurable progress is made by the executable.
OnQueryCancelOnQueryCancel Производит запись в журнал при любом присоединении к обработке задачи в тот момент, когда возможна отмена ее выполнения.Writes a log entry at any juncture in the task processing where it is feasible to cancel execution.
OnTaskFailedOnTaskFailed Производит запись в журнал при возникновении ошибки задачи.Writes a log entry when a task fails.
OnVariableValueChangedOnVariableValueChanged Производит запись в журнал при изменении значения переменной.Writes a log entry when the value of a variable changes.
OnWarningOnWarning Производит запись в журнал при возникновении предупреждения.Writes a log entry when a warning occurs.
PipelineComponentTimePipelineComponentTime Производит запись в журнал по каждой фазе проверки и выполнения каждого компонента потока данных.For each data flow component, writes a log entry for each phase of validation and execution. В записях журнала указывается время обработки каждой фазы.The log entry specifies the processing time for each phase.
ДиагностикаDiagnostic

DiagnosticExDiagnosticEx
Вносит в журнал запись, содержащую диагностические сведения.Writes a log entry that provides diagnostic information.

Например, возможно вносить запись в журнал до и после каждого вызова к внешнему поставщику данных.For example, you can log a message before and after every call to an external data provider. Дополнительные сведения см. в разделе Инструменты устранения неполадок при выполнении пакетов.For more information, see Troubleshooting Tools for Package Execution.

Записывайте в журнал событие DiagnosticEx , если необходимо найти имена столбцов в потоке данных, которые содержат ошибки.Log the DiagnosticEx event when you want to find the column names for columns in the data flow that have errors. Это событие записывает схему журнала преобразований потока данных в журнал.This event writes a data flow lineage map to the log. Потом вы сможете найти имя столбца в этой схеме журнала преобразований с помощью идентификатора столбца, записанного в выводе с ошибками.You can then look up the column name in this lineage map by using the column identifier captured by an error output. Дополнительные сведения см. в разделе Обработка ошибок в данных.For more info, see Error Handling in Data.

Обратите внимание, что событие DiagnosticEx не сохраняет пробелы в выводе XML, чтобы уменьшить размер журнала.Note that the DiagnosticEx event does not preserve whitespace in its XML output to reduce the size of the log. Для улучшения удобочитаемости скопируйте журнал (например, в решении Visual Studio) в редактор XML, поддерживающий форматирование XML и выделение синтаксиса.To improve readability, copy the log into an XML editor - in Visual Studio, for example - that supports XML formatting and syntax highlighting.

Примечание. При записи события DiagnosticEx в журнал с помощью регистратора SQL Server, отображаемый результат может быть усечен.Note: If you log the DiagnosticEx event with the SQL Server log provider, the output may be truncated. Поле message регистратора SQL Server имеет тип nvarchar(2048).The message field of the SQL Server log provider is of type nvarchar(2048). Во избежание усечения при записи события DiagnosticEx в журнал используйте другой регистратор.To avoid truncation, use a different log provider when you log the DiagnosticEx event.

В пакете и во многих задачах есть пользовательские записи журнала, которые можно включить для ведения журнала.The package and many tasks have custom log entries that can be enabled for logging. Например, задача "Отправка почты" предоставляет запись журнала SendMailTaskBegin , которая производит запись данных в начале выполнения задачи "Отправка почты", но перед тем, как задача осуществляет отправку почты.For example, the Send Mail task provides the SendMailTaskBegin custom log entry, which logs information when the Send Mail task starts to run, but before the task sends an e-mail message. Дополнительные сведения см. в разделе Custom Messages for Logging.For more information, see Custom Messages for Logging.

Различие копий пакетаDifferentiating Package Copies

Данные журнала содержат имя и идентификатор GUID пакета, которому принадлежит запись журнала.Log data includes the name and the GUID of the package to which the log entries belong. Для создания копии пакета путем копирования существующего пакета имя и идентификатор GUID существующего пакета тоже копируются.If you create a new package by copying an existing package, the name and the GUID of the existing package are also copied. Это приводит к появлению двух элементов с одинаковыми именами и идентификаторами GUID, что приводит к трудностям при выделении пакетов из данных журнала.As a result, you may have two packages that have the same GUID and name, making it difficult to differentiate between the packages in the log data.

Чтобы устранить неоднозначность, следует обновить имя и идентификатор GUID новых пакетов.To eliminate this ambiguity, you should update the name and the GUID of the new packages. В среде SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT)можно заново сформировать идентификатор GUID для свойства ID и обновить значение свойства Name в окне свойств.In SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT), you can regenerate the GUID in the ID property and update the value of the Name property in the Properties window. Можно также изменить имя и идентификатор GUID программно или с помощью команды dtutil .You can also change the GUID and the name programmatically, or by using the dtutil command prompt. Дополнительные сведения см. в разделах Установка свойств пакета и Программа dtutil.For more information, see Set Package Properties and dtutil Utility.

Параметры родительского ведения журналовParent Logging Options

Часто параметры ведения журналов задач и контейнеров «цикл по элементам» и «цикл по каждому элементу», а также контейнеров последовательности соответствуют параметрам пакета или родительского контейнера.Frequently, the logging options of tasks and For Loop, Foreach Loop, and Sequence containers match those of the package or a parent container. В этом случае можно настроить их для наследования настроек ведения журналов от родительского контейнера.In that case, you can configure them to inherit their logging options from their parent container. Например, в контейнере «цикл по элементам», включающем задачу «Выполнение SQL», эта задача может использовать параметры ведения журналов, установленные для контейнера «цикл по элементам».For example, in a For Loop container that includes an Execute SQL task, the Execute SQL task can use the logging options that are set on the For Loop container. Для использования родительских параметров ведения журналов установите для свойства контейнера LoggingMode значение UseParentSetting.To use the parent logging options, you set the LoggingMode property of the container to UseParentSetting. Можно установить это свойство в окне Свойства среды SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT) или через диалоговое окно Настройка журналов служб SSIS в конструкторе служб Integration ServicesSSIS .You can set this property in the Properties window of SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT) or through the Configure SSIS Logs dialog box in Integration ServicesSSIS Designer.

Шаблоны ведения журналовLogging Templates

В диалоговом окне Настройка журналов SSIS также можно создать и сохранить часто используемые параметры ведения журналов в качестве шаблонов, и затем использовать эти шаблоны во многих пакетах.In the Configure SSIS Logs dialog box, you can also create and save frequently used logging configurations as templates, and then use the templates in multiple packages. Это облегчает применение согласованной стратегии ведения журналов многочисленных пакетов и изменения параметров ведения журналов пакетов путем обновления шаблонов с последующим их применением.This makes it easy to apply a consistent logging strategy across multiple packages and to modify log settings on packages by updating and then applying the templates. Шаблоны хранятся в XML-файлах.The templates are stored in XML files.

Настройка ведения журналов с помощью диалогового окна «Конфигурация журналов служб SSIS»To configure logging using the Configure SSIS Logs dialog box

  1. Включите журналирование пакета и его задач.Enable the package and its tasks for logging. Журналирование может происходить на уровне пакета, контейнера или задачи.Logging can occur at the package, the container, and the task level. Можно указать различные журналы для пакетов, контейнеров и задач.You can specify different logs for packages, containers, and tasks.

  2. Выберите регистратора и добавьте журнал пакета.Select a log provider and add a log for the package. Журналы могут быть созданы только на уровне пакета, а задача или контейнер должны использовать один из журналов, созданных для пакета.Logs can be created only at the package level, and a task or container must use one of the logs created for the package. Каждый журнал связан с одним из следующих регистраторов: текстовый файл, Приложение SQL Server ProfilerSQL Server Profiler, SQL ServerSQL Server, журнал событий Windows или XML-файл.Each log is associated with one of the following log providers: Text file, Приложение SQL Server ProfilerSQL Server Profiler, SQL ServerSQL Server, Windows Event Log, or XML file. Дополнительные сведения см. в разделе Включение средств ведения журналов в SQL Server Data Tools.For more information, see Enable Package Logging in SQL Server Data Tools.

  3. Выберите события и схему данных журнала для этих событий, запись о которых должна содержаться в журнале.Select the events and the log schema information about each event you want to capture in the log. Дополнительные сведения см. в разделе Настройка ведения журналов с помощью сохраненного файла конфигурации.For more information, see Configure Logging by Using a Saved Configuration File.

Настройка регистратораConfiguration of Log Provider

Значения свойств можно задавать с помощью конструктора Integration ServicesSSIS или программными средствами.You can set properties through Integration ServicesSSIS Designer or programmatically.

Регистратор создается и настраивается как шаг в реализации регистрации в пакете.A log provider is created and configured as a step in implementing logging in a package.

Просмотреть и изменить свойства регистратора после его создания можно в окне «Свойства» среды SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT).After you create a log provider, you can view and modify its properties in the Properties window of SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT).

Дополнительные сведения о программной установке этих свойств см. в документации по классу LogProvider .For information about programmatically setting these properties, see the documentation for the LogProvider class.

Ведение журналов для задач потока данныхLogging for Data Flow Tasks

Задача потока данных предоставляет много пользовательских записей журнала, которые можно использовать для мониторинга и настройки производительности.The Data Flow task provides many custom log entries that can be used to monitor and adjust performance. Например, можно отслеживать компоненты, вызывающие утечку памяти, или следить за скоростью запуска отдельного компонента.For example, you can monitor components that might cause memory leaks, or keep track of how long it takes to run a particular component. Список пользовательских записей журнала и образец их вывода см. в разделе Задача потока данных.For a list of these custom log entries and sample logging output, see Data Flow Task.

Запись имен столбцов, в которых возникают ошибкиCapture the names of columns in which errors occur

При настройке вывода ошибок в потоке данных по умолчанию вывод ошибок отображает только числовой идентификатор столбца, в котором произошла ошибка.When you configure an error output in the data flow, by default the error output provides only the numeric identifier of the column in which the error occurred. Дополнительные сведения см. в разделе Обработка ошибок в данных.For more info, see Error Handling in Data.

Вы можете найти имена столбцов, включив ведение журнала и выбрав событие DiagnosticEx .You can find column names by enabling logging and selecting the DiagnosticEx event. Это событие записывает схему журнала преобразований потока данных в журнал.This event writes a data flow lineage map to the log. Затем можно найти имя столбца по его идентификатору в схеме журнала преобразований.You can then look up the column name from its identifier in this lineage map. Обратите внимание, что событие DiagnosticEx не сохраняет пробелы в выводе XML, чтобы уменьшить размер журнала.Note that the DiagnosticEx event does not preserve whitespace in its XML output to reduce the size of the log. Для улучшения удобочитаемости скопируйте журнал (например, в решении Visual Studio) в редактор XML, поддерживающий форматирование XML и выделение синтаксиса.To improve readability, copy the log into an XML editor - in Visual Studio, for example - that supports XML formatting and syntax highlighting.

Использование события PipelineComponentTimeUse the PipelineComponentTime Event

Возможно, самой полезной записью журнала является событие PipelineComponentTime.Perhaps the most useful custom log entry is the PipelineComponentTime event. Эта запись журнала сообщает о времени в миллисекундах, которое каждый компонент потока данных тратит на каждом из пяти основных шагов обработки.This log entry reports the number of milliseconds that each component in the data flow spends on each of the five major processing steps. В следующей таблице описываются эти шаги обработки.The following table describes these processing steps. Службы Integration ServicesIntegration Services Разработчикам эти шаги будут знакомы как основные методы класса PipelineComponent.developers will recognize these steps as the principal methods of a PipelineComponent.

ШагStep DescriptionDescription
ПроверитьValidate Компонент проверяется на допустимость значений свойств и параметров настройки.The component checks for valid property values and configuration settings.
PreExecutePreExecute Компонент выполняет однократную обработку перед началом обработки строк данных.The component performs one-time processing before it starts to process rows of data.
PostExecutePostExecute Компонент выполняет однократную обработку после обработки всех строк данных.The component performs one-time processing after it has processed all rows of data.
ProcessInputProcessInput Компонент преобразования или назначения обрабатывает входящие строки данных, которые передает ему вышестоящий источник или преобразование.The transformation or destination component processes the incoming rows of data that an upstream source or transformation has passed to it.
PrimeOutputPrimeOutput Компонент источника или преобразования заполняет буферы данных, которые должны передаваться в нижестоящий компонент преобразования или назначения.The source or transformation component fills the buffers of data to be passed to a downstream transformation or destination component.

При включении события PipelineComponentTime службы Службы Integration ServicesIntegration Services записывают в журнал одно сообщение для каждого шага обработки, выполненного каждым компонентом.When you enable the PipelineComponentTime event, Службы Integration ServicesIntegration Services logs one message for each processing step performed by each component. Следующие записи журнала показывают подмножество сообщений, которое регистрирует образец пакета CalculatedColumns служб Службы Integration ServicesIntegration Services .The following log entries show a subset of the messages that the Службы Integration ServicesIntegration Services CalculatedColumns package sample logs:

The component "Calculate LineItemTotalCost" (3522) spent 356 milliseconds in ProcessInput.

The component "Sum Quantity and LineItemTotalCost" (3619) spent 79 milliseconds in ProcessInput.

The component "Calculate Average Cost" (3662) spent 16 milliseconds in ProcessInput.

The component "Sort by ProductID" (3717) spent 125 milliseconds in ProcessInput.

The component "Load Data" (3773) spent 0 milliseconds in ProcessInput.

The component "Extract Data" (3869) spent 688 milliseconds in PrimeOutput filling buffers on output "OLE DB Source Output" (3879).

The component "Sum Quantity and LineItemTotalCost" (3619) spent 141 milliseconds in PrimeOutput filling buffers on output "Aggregate Output 1" (3621).

The component "Sort by ProductID" (3717) spent 16 milliseconds in PrimeOutput filling buffers on output "Sort Output" (3719).

Эти записи показывают, что задача потока данных затратила наибольшее время на следующие шаги, представленные ниже в убывающем порядке.These log entries show that the data flow task spent the most time on the following steps, shown here in descending order:

  • Источник OLE DB с именем «Извлечение данных» затратил 688 мсThe OLE DB source that is named "Extract Data" spent 688 ms. на загрузку данных.loading data.

  • Преобразование «Производный столбец» с именем «Вычисление LineItemTotalCost» затратило 356 мсThe Derived Column transformation that is named "Calculate LineItemTotalCost" spent 356 ms. на выполнение вычислений с входящими строками.performing calculations on incoming rows.

  • Преобразование "Статистическая обработка" с именем "Сложение Quantity и LineItemTotalCost" затратило в общей сложности 220 мс (141 на шаге PrimeOutput и 79 на шаге ProcessInput) на вычисление и передачу данных следующему преобразованию.The Aggregate transformation that is named "Sum Quantity and LineItemTotalCost" spent a combined 220 ms-141 in PrimeOutput and 79 in ProcessInput-performing calculations and passing the data to the next transformation.

Включение средств ведения журналов в SQL Server Data ToolsEnable Package Logging in SQL Server Data Tools

В этой процедуре описывается, как добавлять журналы в пакет, настраивать ведение журналов на уровне пакетов и сохранять настройку ведения журналов в XML-файле.This procedure describes how to add logs to a package, configure package-level logging, and save the logging configuration to an XML file. Журнал можно добавить только на уровне пакета, однако пакеты не обязаны осуществлять ведение журналов, чтобы включить ведение журналов в контейнерах, которые содержатся в этих пакетах.You can add logs only at the package level, but the package does not have to perform logging to enable logging in the containers that the package includes.

Важно!

При развертывании проекта Службы Integration ServicesIntegration Services на сервере Службы Integration ServicesIntegration Services уровень ведения журнала, заданный для выполнения пакета, переопределяет уровень, настраиваемый с помощью среды SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT).If you deploy the Службы Integration ServicesIntegration Services project to the Службы Integration ServicesIntegration Services server, the logging level that you set for the package execution overrides the package logging that you configure using SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT).

По умолчанию к контейнерам в пакете применяются те же самые настройки ведения журналов, что и к их родительскому контейнеру.By default, the containers in the package use the same logging configuration as their parent container. Дополнительные сведения об установке параметров ведения журналов для отдельных контейнеров см. в разделе Настройка ведения журналов с помощью сохраненного файла конфигурации.For information about setting logging options for individual containers, see Configure Logging by Using a Saved Configuration File.

Включение ведения журналов в пакетеTo enable logging in a package

  1. В среде SQL Server Data ToolsSQL Server Data Toolsоткройте проект служб Службы Integration ServicesIntegration Services , содержащий необходимый пакет.In SQL Server Data ToolsSQL Server Data Tools, open the Службы Integration ServicesIntegration Services project that contains the package you want.

  2. В меню Службы SSIS нажмите Ведение журнала.On the SSIS menu, click Logging.

  3. Выберите регистратор из списка Тип поставщика и щелкните Добавить.Select a log provider in the Provider type list, and then click Add.

  4. В столбце Конфигурация выберите диспетчер подключений или щелкните <New connection> , чтобы создать диспетчер подключений, соответствующий регистратору.In the Configuration column, select a connection manager or click <New connection> to create a new connection manager of the appropriate type for the log provider. В зависимости от выбранного регистратора может использоваться один из следующих диспетчеров соединений.Depending on the selected provider, use one of the following connection managers:

    • Для текстовых файлов используется диспетчер подключения файлов.For Text files, use a File connection manager. Дополнительные сведения см. в разделе диспетчер подключения файлов.For more information, see File Connection Manager

    • Для Приложение SQL Server ProfilerSQL Server Profilerиспользуется диспетчер подключения файлов.For Приложение SQL Server ProfilerSQL Server Profiler, use a File connection manager.

    • Для SQL ServerSQL Serverиспользуется диспетчер соединений OLE DB.For SQL ServerSQL Server, use an OLE DB connection manager. Дополнительные сведения см. в разделе Диспетчер соединений OLE DB.For more information, see OLE DB Connection Manager.

    • В журнале событий Windows выполнение действий не требуется.For Windows Event Log, do nothing. Integration ServicesSSIS автоматически создадут журнал.automatically creates the log.

    • Для XML-файлов используется диспетчер подключения файлов.For XML files, use a File connection manager.

  5. Для каждого журнала, используемого в пакете, повторите шаги 3 и 4.Repeat steps 3 and 4 for each log to use in the package.

    Примечание

    Пакет может задействовать более одного журнала каждого типа.A package can use more than one log of each type.

  6. При необходимости установите флажок уровня пакетов, выберите журналы для ведения на уровне пакетов и перейдите на вкладку Подробности .Optionally, select the package-level check box, select the logs to use for package-level logging, and then click the Details tab.

  7. На вкладке Подробности установите флажок События для сохранения всех записей журнала или снимите флажок События , чтобы выбрать отдельные события.On the Details tab, select Events to log all log entries, or clear Events to select individual events.

  8. При необходимости перейдите на вкладку Дополнительно , чтобы указать, какие именно данные следует вносить в журнал.Optionally, click Advanced to specify which information to log.

    Примечание

    По умолчанию в журнал вносятся все данные.By default, all information is logged.

  9. На вкладке Подробности нажмите кнопку Сохранить.On the Details tab, click Save. Отображается диалоговое окно Сохранить как .The Save As dialog box appears. Выберите папку для хранения настроек ведения журнала, введите имя файла для конфигурации нового журнала и щелкните Сохранить.Locate the folder in which to save the logging configuration, type a file name for the new log configuration, and then click Save.

  10. Нажмите кнопку ОК.Click OK.

  11. Чтобы сохранить обновленный пакет, выберите пункт Сохранить выбранные элементы в меню Файл .To save the updated package, click Save Selected Items on the File menu.

Диалоговое окно «Настройка журналов служб SSIS»Configure SSIS Logs Dialog Box

Используйте диалоговое окно Настройка журналов служб SSIS для настройки параметров ведения журнала для пакета.Use the Configure SSIS Logs dialog box to define logging options for a package.

Выбор действияWhat do you want to do?

  1. Откройте диалоговое окно «Настройка журналов служб SSIS»Open the Configure SSIS Logs Dialog Box

  2. Настройка параметров на панели «Контейнеры»Configure the Options in the Containers Pane

  3. Настройка параметров на вкладке «Поставщики и журналы»Configure the Options on the Providers and Logs Tab

  4. Настройка параметров на вкладке «Подробные сведения»Configure the Options on the Details Tab

Откройте диалоговое окно «Настройка журналов служб SSIS»Open the Configure SSIS Logs Dialog Box

Открытие диалогового окна «Настройка журналов служб SSIS»To open the Configure SSIS Logs dialog box

  • В конструкторе служб Integration ServicesSSIS выберите пункт Ведение журнала в меню SSIS .In the Integration ServicesSSIS Designer, click Logging on the SSIS menu.

Настройка параметров на панели «Контейнеры»Configure the Options in the Containers Pane

Используйте панель Контейнеры в диалоговом окне Настройка журналов служб SSIS для включения записи в журнал пакета и его контейнеров.Use the Containers pane of the Configure SSIS Logs dialog box to enable the package and its containers for logging.

ПараметрыOptions

КонтейнерыContainers
Установите флажки в иерархическом представлении, чтобы включить запись в журнал пакета и его контейнеров:Select the check boxes in the hierarchical view to enable the package and its containers for logging:

  • Если флажок снят, контейнеры недоступны для записи в журнал.If cleared, the container is not enabled for logging. Установите флажок для включения записи в журнал.Select to enable logging.

  • Если контейнер недоступен для выбора, используются параметры записи в журнал его родителя.If dimmed, the container uses the logging options of its parent. Данный параметр недоступен для пакетов.This option is not available for the package.

  • Если флажок установлен, контейнер определяет собственные параметры записи в журнал.If checked, the container defines its own logging options.

Если контейнер недоступен для выбора и для него требуется задать параметры записи в журнал, дважды щелкните флажок этого контейнера.If a container is dimmed and you want to set logging options on the container, click its check box twice. Первый щелчок снимает флажок, второй — устанавливает, позволяя выбрать регистраторы и данные, которые будут записываться в журналы.The first click clears the check box, and the second click selects it, enabling you to choose the log providers to use and select the information to log.

Настройка параметров на вкладке «Поставщики и журналы»Configure the Options on the Providers and Logs Tab

Используйте вкладку Поставщики и журналы диалогового окна Конфигурация журналов служб SSIS , чтобы создать и конфигурировать журналы, регистрирующие события выполнения.Use the Providers and Logs tab of the Configure SSIS Logs dialog box to create and configure logs for capturing run-time events.

ПараметрыOptions

Тип поставщикаProvider type
Выберите тип регистратора из списка.Select a type of log provider from the list.

ДобавлениеAdd
Добавьте журнал заданного типа к коллекции регистраторов пакета.Add a log of the specified type to the collection of log providers of the package.

НазваниеName
Включите или отключите журналы для контейнеров или задач, выбранных на панели Контейнеры диалогового окна Настройка журналов служб SSIS с помощью флажков.Enable or disable logs for containers or tasks selected in the Containers pane of the Configure SSIS Logs dialog box, by using the check boxes. Поле имени является редактируемым.The name field is editable. Используйте для поставщика имя по умолчанию или введите уникальное описательное имя.Use the default name for the provider, or type a unique descriptive name.

ОписаниеDescription
Поле описания является редактируемым.The description field is editable. Нажмите и отредактируйте описание журнала по умолчанию.Click and then modify the default description of the log.

КонфигурацияConfiguration
Выберите в списке существующий диспетчер подключений или щелкните <New connection...>, чтобы создать диспетчер подключений.Select an existing connection manager in the list, or click <New connection...> to create a new connection manager. В зависимости от типа регистратора можно настраивать диспетчер соединений OLE DB или диспетчер соединений файлов.Depending on the type of log provider, you can configure an OLE DB connection manager or a File connection manager. Регистратору журнала событий MicrosoftMicrosoft Windows не требуется соединение.The log provider for the MicrosoftMicrosoft Windows Event Log requires no connection.

См. также диспетчер Диспетчер соединений OLE DB , диспетчер подключения файловRelated Topics: OLE DB Connection Manager manager, File Connection Manager

УдалениеDelete
Выберите регистратор и нажмите Удалить.Select a log provider and then click Delete.

Настройка параметров на вкладке «Подробные сведения»Configure the Options on the Details Tab

Вкладка Подробности в диалоговом окне Настройка журналов служб SSIS позволяет задать события, по которым включается запись в журнал, и определить записываемые в журнал сведения.Use the Details tab of the Configure SSIS Logs dialog box to specify the events to enable for logging and the information details to log. Выбранные сведения записываются во все регистраторы, находящиеся в пакете.The information that you select applies to all the log providers in the package. Например, нельзя записать некоторые сведения в экземпляр SQL ServerSQL Server и другие сведения в текстовый файл.For example, you cannot write some information to the SQL ServerSQL Server instance and different information to a text file.

ПараметрыOptions

СобытияEvents
Включить или отключить события для записи в журнал.Enable or disable events for logging.

ОписаниеDescription
Просмотрите описание события.View a description of the event.

ДополнительноAdvanced
Выберите или удалите события для записи, выберите или удалите сведения, которые должны записываться в журнал для каждого события.Select or clear events to log, and select or clear information to log for each event. Чтобы скрыть сведения, записываемые в журнал, и оставить только список событий, нажмите кнопку Основной .Click Basic to hide all logging details, except the list of events. Записывать в журнал можно следующие сведения:The following information is available for logging:

ЗначениеValue DescriptionDescription
КомпьютерComputer Имя компьютера, на котором произошло записываемое в журнал событие.The name of the computer on which the logged event occurred.
ОператорOperator Имя пользователя, запустившего пакет.The user name of the person who started the package.
SourceNameSourceName Имя пакета, контейнера или задачи, в котором произошло записываемое в журнал событие.The name of the package, container, or task in which the logged event occurred.
SourceIDSourceID Глобальный уникальный идентификатор (GUID) пакета, контейнера или задачи, в котором произошло записываемое в журнал событие.The global unique identifier (GUID) of the package, container, or task in which the logged event occurred.
ExecutionIDExecutionID Глобальный уникальный идентификатор экземпляра выполнения пакета.The global unique identifier of the package execution instance.
MessageTextMessageText Сообщение, связанное с записью журнала.A message associated with the log entry.
DataBytesDataBytes Зарезервировано для последующего использования.Reserved for future use.

ОсновнойBasic
Выберите или удалите события для записи в журнал.Select or clear events to log. Этот параметр позволяет скрыть записываемые в журнал сведения, за исключением списка событий.This option hides logging details except the list of events. Если выбрать событие, то все записываемые в журнал сведения для события выбираются автоматически.If you select an event, all logging details are selected for the event by default. Чтобы просмотреть все записываемые в журнал сведения, выберите параметр Дополнительно .Click Advanced to show all logging details.

ЗагрузитьLoad
Укажите XML-файл, используемый в качестве шаблона настройки параметров журнала.Specify an existing XML file to use as a template for setting logging options.

СохранитьSave
Сохраните детализацию настройки в виде шаблона в XML-файл.Save configuration details as a template to an XML file.

Настройка ведения журналов с помощью сохраненного файла конфигурацииConfigure Logging by Using a Saved Configuration File

Эта процедура описывает, как настроить ведение журнала для новых контейнеров в пакете с помощью загрузки предварительно сохраненного файла конфигурации ведения журнала.This procedure describes how to configure logging for new containers in a package by loading a previously saved logging configuration file.

По умолчанию все контейнеры пакета используют такую же конфигурацию ведения журнала, что и родительский контейнер.By default, all containers in a package use the same logging configuration as their parent container. Например, задачи в контейнере «цикл по каждому элементу» используют такую же конфигурацию ведения журнала, какую использует контейнер «цикл по элементам».For example, the tasks in a Foreach Loop use the same logging configuration as the Foreach Loop.

Настройка ведения журнала для контейнераTo configure logging for a container

  1. В среде SQL Server Data ToolsSQL Server Data Toolsоткройте проект служб Службы Integration ServicesIntegration Services , содержащий необходимый пакет.In SQL Server Data ToolsSQL Server Data Tools, open the Службы Integration ServicesIntegration Services project that contains the package you want.

  2. В меню Службы SSIS нажмите Ведение журнала.On the SSIS menu, click Logging.

  3. Разверните представление пакета в виде дерева и выберите контейнер для настройки.Expand the package tree view and select the container to configure.

  4. На вкладке Поставщики и журналы выберите журналы, которые будут использоваться для контейнера.On the Providers and Logs tab, select the logs to use for the container.

    Примечание

    Создавать журналы можно только на уровне пакета.You can create logs only at the package level. Дополнительные сведения см. в разделе Включение средств ведения журналов в SQL Server Data Tools.For more information, see Enable Package Logging in SQL Server Data Tools.

  5. Перейдите на вкладку Подробности и нажмите кнопку Загрузить.Click the Details tab and click Load.

  6. Найдите файл конфигурации ведения журнала, который необходимо использовать, и нажмите кнопку Открыть.Locate the logging configuration file you want to use and click Open.

  7. Можно выбрать другую запись журнала, установив соответствующий ей флажок в столбце События .Optionally, select a different log entry to log by selecting its check box in the Events column. Нажмите кнопку Дополнительно , чтобы выбрать тип сведений для занесения в журнал для этой записи.Click Advanced to select the type of information to log for this entry.

    Примечание

    Новый контейнер может включать дополнительные записи журнала, которые недоступны для контейнера, изначально использованного для создания конфигурации ведения журнала.The new container may include additional log entries that are not available for the container originally used to create the logging configuration. Эти дополнительные записи журнала должны быть выбраны вручную, если необходимо их ведение.These additional log entries must be selected manually if you want them to be logged.

  8. Чтобы сохранить обновленную версию конфигурации ведения журнала, нажмите кнопку Сохранить.To save the updated version of the logging configuration, click Save.

  9. Чтобы сохранить обновленный пакет, выберите пункт Сохранить выбранные элементы в меню Файл .To save the updated package, click Save Selected Items on the File menu.

Включение ведения журналов при выполнении пакета на сервере служб SSISEnable Logging for Package Execution on the SSIS Server

В этой статье описывается, как задать или изменить уровень ведения журнала для пакета, когда выполняется пакет, развернутый на сервере Службы Integration ServicesIntegration Services .This topic describes how to set or change the logging level for a package when you run a package that you have deployed to the Службы Integration ServicesIntegration Services server. Уровень ведения журнала, задаваемый при выполнении пакета, переопределяет уровень, настроенный во время разработки с помощью SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT).The logging level you set when you run the package overrides the package logging you configure at design time in SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT). Дополнительные сведения см. в разделе Включение средств ведения журналов в SQL Server Data Tools .See Enable Package Logging in SQL Server Data Tools for more information.

В разделе Свойства серверав SQL Server вы можете выбрать ведение журнала на уровне сервера (вариант по умолчанию) для свойства Уровень ведения журнала сервера .In SQL Server Server Properties, under the Server logging level property, you can select a default server-wide logging level. Вы можете выбрать один из встроенных уровней ведения журнала, описанных в этой статье, или существующий пользовательский уровень.You can pick from one of the built-in logging levels described in this topic, or you can pick an existing customized logging level. Выбранный уровень применяется по умолчанию ко всем пакетам, развернутым в каталоге служб SSIS.The selected logging level applies by default to all packages deployed to the SSIS Catalog. По умолчанию этот уровень применяется также к заданию агента SQL Server, в рамках которого запущен пакет служб SSIS.It also applies by default to a SQL Agent job step that runs an SSIS package.

Кроме того, вы можете указать уровень ведения журнала для отдельного пакета с помощью одного из следующих методов.You can also specify the logging level for an individual package by using one of the following methods. Этот раздел охватывает первый метод.This topic covers the first method.

  • Настройка экземпляра выполнения пакета с помощью диалогового окна «Выполнение пакета»Configuring an instance of a package execution by using the Execute Package dialog box

  • Установка параметров для экземпляра выполнения с помощью catalog.set_execution_parameter_value (база данных SSISDB)Setting parameters for an instance of an execution by using the catalog.set_execution_parameter_value (SSISDB Database)

  • Настройка задания агента SQL Server для выполнения пакета с помощью диалогового окна «Новый шаг задания».Configuring a SQL Server Agent job for a package execution by using the New Job Step dialog box.

Задание уровня ведения журнала для пакета с помощью диалогового окна "Выполнение пакета"Set the logging level for a package by using the Execute Package dialog box

  1. В среде SQL Server Management StudioSQL Server Management Studioперейдите к пакету в обозревателе объектов.In SQL Server Management StudioSQL Server Management Studio, navigate to the package in Object Explorer.

  2. Щелкните пакет правой кнопкой мыши и выберите команду Выполнить.Right-click the package and select Execute.

  3. Выберите в диалоговом окне Выполнение пакета вкладку Дополнительно .Select the Advanced tab in the Execute Package dialog box.

  4. В разделе Уровень ведения журналавыберите уровень ведения журнала.Under Logging level, select the logging level. В этом разделе содержится описание доступных значений.This topic contains a description of available values.

  5. Настройте другие параметры пакета, а затем нажмите кнопку ОК , чтобы запустить пакет.Complete any other package configurations, then click OK to run the package.

Выбор уровня ведения журналаSelect a logging level

Доступны следующие встроенные уровни ведения журнала.The following built-in logging levels are available. Кроме того, вы можете выбрать существующий пользовательский уровень ведения журнала.You can also select an existing customized logging level. В этой статье содержится описание пользовательских уровней ведения журнала.This topic contains a description of customized logging levels.

Уровень ведения журналаLogging Level DescriptionDescription
NoneNone Ведение журнала выключено.Logging is turned off. Регистрируется только состояние выполнения пакета.Only the package execution status is logged.
BasicBasic Записываются все события, за исключением пользовательских и диагностических событий.All events are logged, except custom and diagnostic events. Это значение по умолчанию.This is the default value.
RuntimeLineageRuntimeLineage Собирает данные, необходимые для отслеживания сведений для журнала преобразований в потоке данных.Collects the data required to track lineage information in the data flow. Вы можете проанализировать эти сведения журнала преобразований, чтобы сопоставить отношение преобразований между задачами.You can parse this lineage information to map the lineage relationship between tasks. С помощью этой информации независимые поставщики программного обеспечения и разработчики могут создавать пользовательские средства сопоставления для журнала преобразований.ISVs and developers can build custom lineage mapping tools with this information.
ПроизводительностьPerformance Регистрируются только статистика производительности, а также события OnError и OnWarning.Only performance statistics, and OnError and OnWarning events, are logged.

Отчет Производительность выполнения показывает активное и общее время компонентов потока данных пакета.The Execution Performance report displays Active Time and Total Time for package data flow components. Эта информация доступна, если уровень ведения журнала выполнения последнего пакета был задан как Производительность или Подробно.This information is available when the logging level of the last package execution was set to Performance or Verbose. Дополнительные сведения см. в статье Reports for the Integration Services Server.For more information, see Reports for the Integration Services Server.

Представление catalog.execution_component_phases отображает время начала и время окончания для компонентов потока данных для каждого этапа выполнения.The catalog.execution_component_phases view displays the start and end times for the data flow components, for each phase of an execution. Это представление содержит данные для этих компонентов, только если в качестве уровня ведения журнала выполнения пакета установлено значение Производительность или Подробно.This view displays this information for these components only when the logging level of the package execution is set to Performance or Verbose.
ПодробныйVerbose Регистрируются все события, в том числе пользовательские и диагностические события.All events are logged, including custom and diagnostic events.

К пользовательским относятся события, записываемые задачами служб Службы Integration ServicesIntegration Services .Custom events include those events that are logged by Службы Integration ServicesIntegration Services tasks. Дополнительные сведения о пользовательских событиях см. в статье Custom Messages for Logging.For more information about custom events, see Custom Messages for Logging.

Пример диагностического события — событие DiagnosticEx .An example of a diagnostic event is the DiagnosticEx event. Когда задача "Выполнение пакета" выполняет дочерний пакет, это событие всегда записывает значения параметра, передаваемые в дочерние пакеты.Whenever an Execute Package task executes a child package, this event captures the parameter values passed to child packages.

Событие DiagnosticEx , кроме того, помогает получить имена столбцов, в которых на уровне строк происходят ошибки.The DiagnosticEx event also helps you to get the names of columns in which row-level errors occur. Это событие записывает схему журнала преобразований потока данных в журнал.This event writes a data flow lineage map to the log. Потом вы сможете найти имя столбца в этой схеме журнала преобразований с помощью идентификатора столбца, записанного в выводе с ошибками.You can then look up the column name in this lineage map by using the column identifier captured by an error output. Дополнительные сведения см. в разделе Обработка ошибок в данных.For more info, see Error Handling in Data.

Значение столбца сообщения для DiagnosticEx — это XML-текст.The value of the message column for DiagnosticEx is XML text. Для просмотра текста сообщения о выполнении пакета выполните запрос к представлению catalog.operation_messages (база данных SSISDB).To view the message text for a package execution, query the catalog.operation_messages (SSISDB Database) view. Обратите внимание, что событие DiagnosticEx не сохраняет пробелы в выводе XML, чтобы уменьшить размер журнала.Note that the DiagnosticEx event does not preserve whitespace in its XML output to reduce the size of the log. Для улучшения удобочитаемости скопируйте журнал (например, в решении Visual Studio) в редактор XML, поддерживающий форматирование XML и выделение синтаксиса.To improve readability, copy the log into an XML editor - in Visual Studio, for example - that supports XML formatting and syntax highlighting.

Представление catalog.execution_data_statistics отображает строку каждый раз, когда компонент потока данных передает данные в компонент, находящийся ниже в иерархии, для выполнения пакета.The catalog.execution_data_statistics view displays a row each time a data flow component sends data to a downstream component, for a package execution. Для сохранения этих данных в представлении уровень ведения журнала должен быть установлен в значение Подробно .The logging level must be set to Verbose to capture this information in the view.

Создание пользовательских уровней ведения журнала и управление ими с помощью диалогового окна "Управление пользовательскими уровнями ведения журнала"Create and manage customized logging levels by using the Customized Logging Level Management dialog box

Вы можете создавать пользовательские уровни ведения журнала, в рамках которых собираются только нужные вам события и статистика.You can create customized logging levels that collect only the statistics and events that you want. При необходимости можно записывать также контекст событий, который включает значения переменных, строки подключений и свойства компонентов.Optionally you can also capture the context of events, which includes variable values, connection strings, and component properties. При запуске пакета пользовательский уровень ведения журнала можно выбрать всегда, когда можно выбрать встроенный уровень.When you run a package, you can select a customized logging level wherever you can select a built-in logging level.

Совет

Чтобы записать значения переменных пакета, для свойства IncludeInDebugDump переменных следует задать значение True.To capture the values of package variables, the IncludeInDebugDump property of the variables must be set to True.

  1. Чтобы создать пользовательские уровни ведения журнала и управлять ими, в SQL Server Management StudioSQL Server Management Studioщелкните правой кнопкой мыши базу данных SSISDB и выберите Пользовательский уровень ведения журнала . Откроется диалоговое окно Управление пользовательскими уровнями ведения журнала .To create and manage customized logging levels, in SQL Server Management StudioSQL Server Management Studio, right-click on the SSISDB database and select Customized Logging Level to open the Customized Logging Level Management dialog box. Список Пользовательские уровни ведения журнала содержит все существующие пользовательские уровни.The Customized Logging Levels list contains all the existing customized logging levels.

  2. Чтобы создать пользовательский уровень, щелкните Создатьи введите имя и описание.To create a new customized logging level, click Create, and then provide a name and description. На вкладках Статистика и События выберите статистические данные и события, которые требуется собирать.On the Statistics and Events tabs, select the statistics and events that you want to collect. На вкладке События при необходимости выберите Включить контекст для определенных событий.On the Events tab, optionally select Include Context for individual events. Затем нажмите кнопку Сохранить.Then click Save.

  3. Чтобы обновить существующий пользовательский уровень ведения журнала, выберите его в списке, перенастройте, а затем нажмите кнопку Сохранить.To update an existing customized logging level, select it in the list, reconfigure it, and then click Save.

  4. Чтобы удалить существующий пользовательский уровень ведения журнала, выберите его в списке и нажмите кнопку Удалить.To delete an existing customized logging level, select it in the list, and then click Delete.

Разрешения для пользовательских уровней ведения журнала.Permissions for customized logging levels.

  • Когда пользователи базы данных SSISDB запускают пакеты, они видят пользовательские уровни ведения журнала и могут их выбирать.All users of the SSISDB database can see customized logging levels and select a customized logging level when they run packages.

  • Только пользователи с ролью ssis_admin или sysadmin могут создавать, обновлять и удалять пользовательские уровни ведения журнала.Only users in the ssis_admin or sysadmin role can create, update, or delete customized logging levels.

Custom Messages for LoggingCustom Messages for Logging

Службы SQL Server Integration Services предусматривают большой набор пользовательских событий, предполагающих добавление записей в журнал для пакетов и многих задач.SQL Server Integration Services provides a rich set of custom events for writing log entries for packages and many tasks. Записывая стандартные события или определенные пользователем сообщения с целью последующего анализа, можно сохранить подробные сведения о процессе выполнения, результатах и проблемах.You can use these entries to save detailed information about execution progress, results, and problems by recording predefined events or user-defined messages for later analysis. Например, можно записать, когда начинается и заканчивается массовая вставка, чтобы идентифицировать проблемы с производительностью при выполнении пакета.For example, you can record when a bulk insert begins and ends to identify performance issues when the package runs.

Пользовательские записи в журнале являются другим набором записей, отличным от стандартных событий ведения журнала, которые доступны для пакетов, всех контейнеров и задач.The custom log entries are a different set of entries than the set of standard logging events that are available for packages and all containers and tasks. Пользовательские записи в журнале приспособлены для записи полезных сведений о конкретной задаче или пакете.The custom log entries are tailored to capture useful information about a specific task in a package. Например, одна из пользовательских записей в журнале для задачи «Выполнение SQL» содержит инструкцию SQL, которая выполняется в задаче.For example, one of the custom log entries for the Execute SQL task records the SQL statement that the task executes in the log.

Все записи в журнале содержат сведения о дате и времени, в том числе записи, которые автоматически формируются в начале и в конце выполнения пакета.All log entries include date and time information, including the log entries that are automatically written when a package begins and finishes. Многие события журнала формируют несколько записей журнала.Many of the log events write multiple entries to the log. Это обычно происходит в том случае, когда событие состоит из нескольких стадий.This typically occurs when the event has different phases. Например, событие журнала ExecuteSQLExecutingQuery формирует три записи: одну запись после того, как задача устанавливает соединение с базой данных, вторую после того, как задача приступает к подготовке инструкции SQL, и еще одну после того, как выполнение инструкции SQL завершается.For example, the ExecuteSQLExecutingQuery log event writes three entries: one entry after the task acquires a connection to the database, another after the task starts to prepare the SQL statement, and one more after the execution of the SQL statement is completed.

Следующие объекты служб Службы Integration ServicesIntegration Services содержат пользовательские записи в журнале.The following Службы Integration ServicesIntegration Services objects have custom log entries:

ПакетPackage

Задача «Массовая вставка»Bulk Insert Task

Задача потока данныхData Flow Task

Задача «Выполнение пакета служб DTS 2000»Execute DTS 2000 Task

Задача «Выполнение процесса»Execute Process Task

Задача «Выполнение SQL»Execute SQL Task

Задача "Файловая система"File System Task

Задача «FTP»FTP Task

Задача «Очередь сообщений»Message Queue Task

Задача «Скрипт»Script Task

Задача «Отправка почты»Send Mail Task

Задача «Передача базы данных»Transfer Database Task

Задача «Передача сообщений об ошибках»Transfer Error Messages Task

Задача «Передача заданий»Transfer Jobs Task

Задача «Передача имен входа»Transfer Logins Task

Задача «Передача главных хранимых процедур»Transfer Master Stored Procedures Task

Задача «Передача объектов SQL Server»Transfer SQL Server Objects Task

Задача «Веб-служба»Web Services Task

Задача «Модуль чтения данных WMI»WMI Data Reader Task

Задача «Отслеживание событий WMI»WMI Event Watcher Task

Задача «XML»XML Task

Записи журналаLog Entries

ПакетPackage

В следующей таблице перечислены пользовательские записи в журнале для пакетов.The following table lists the custom log entries for packages.

Запись журналаLog entry DescriptionDescription
PackageStartPackageStart Указывает, что выполнение пакета началось.Indicates that the package began to run. Эта запись журнала формируется автоматически.This log entry is automatically written to the log. Ее нельзя исключить.You cannot exclude it.
PackageEndPackageEnd Указывает, что выполнение пакета завершено.Indicates that the package completed. Эта запись журнала формируется автоматически.This log entry is automatically written to the log. Ее нельзя исключить.You cannot exclude it.
ДиагностикаDiagnostic Предоставляет сведения о настройках системы, влияющих на выполнение пакета, таких как количество одновременно исполняемых объектов.Provides information about the system configuration that affects package execution such as the number executables that can be run concurrently.

Запись журнала Diagnostic также включает записи, сделанные до и после обращения к внешним поставщикам данных.The Diagnostic log entry also includes before and after entries for calls to external data providers.

Задача «Массовая вставка»Bulk Insert Task

В следующей таблице перечислены пользовательские записи в журнале для задачи «Массовая вставка».The following table lists the custom log entries for the Bulk Insert task.

Запись журналаLog entry DescriptionDescription
DTSBulkInsertTaskBeginDTSBulkInsertTaskBegin Указывает, что массовая вставка началась.Indicates that the bulk insert began.
DTSBulkInsertTaskEndDTSBulkInsertTaskEnd Указывает, что массовая вставка завершена.Indicates that the bulk insert finished.
DTSBulkInsertTaskInfosDTSBulkInsertTaskInfos Выводит описательные сведения об этой задаче.Provides descriptive information about the task.

Задача потока данныхData Flow Task

В следующей таблице перечислены пользовательские записи в журнале для задачи потока данных.The following table lists the custom log entries for the Data Flow task.

Запись журналаLog entry DescriptionDescription
BufferSizeTuningBufferSizeTuning Указывает, что задача потока данных изменила размер буфера.Indicates that the Data Flow task changed the size of the buffer. Эта запись журнала описывает причины изменения размера и фиксирует новый временный размер буфера.The log entry describes the reasons for the size change and lists the temporary new buffer size.
OnPipelinePostEndOfRowsetOnPipelinePostEndOfRowset Означает, что компонент получил сигнал конца набора строк, который устанавливается при последнем вызове метода ProcessInput .Denotes that a component has been given its end-of-rowset signal, which is set by the last call of the ProcessInput method. Запись делается для каждого компонента в потоке данных, который обрабатывает ввод.An entry is written for each component in the data flow that processes input. Запись включает имя компонента.The entry includes the name of the component.
OnPipelinePostPrimeOutputOnPipelinePostPrimeOutput Указывает, что компонент завершил последний вызов метода PrimeOutput .Indicates that the component has completed its last call to the PrimeOutput method. В зависимости от потока данных, возможно формирование нескольких записей в журнале.Depending on the data flow, multiple log entries may be written. Если компонент является источником, это означает, что компонент завершил обработку строк.If the component is a source, this means that the component has finished processing rows.
OnPipelinePreEndOfRowsetOnPipelinePreEndOfRowset Показывает, что компонент уже готов получить сигнал конца набора строк, который устанавливается при последнем вызове метода ProcessInput .Indicates that a component is about to receive its end-of-rowset signal, which is set by the last call of the ProcessInput method. Запись делается для каждого компонента в потоке данных, который обрабатывает ввод.An entry is written for each component in the data flow that processes input. Запись включает имя компонента.The entry includes the name of the component.
OnPipelinePrePrimeOutputOnPipelinePrePrimeOutput Показывает, что компонент готов получить свой вызов из метода PrimeOutput .Indicates that the component is about to receive its call from the PrimeOutput method. В зависимости от потока данных, возможно формирование нескольких записей в журнале.Depending on the data flow, multiple log entries may be written.
OnPipelineRowsSentOnPipelineRowsSent Сообщает количество строк, предоставленных входу компонента с помощью вызова метода ProcessInput .Reports the number of rows provided to a component input by a call to the ProcessInput method. Запись журнала включает имя компонента.The log entry includes the component name.
PipelineBufferLeakPipelineBufferLeak Предоставляет сведения обо всех компонентах, которые удерживают буферы от уничтожения после того, как диспетчер буферов завершил свое выполнение.Provides information about any component that kept buffers alive after the buffer manager goes away. Это означает, что ресурсы буферов не были освобождены и могут вызвать утечку памяти.This means that buffers resources were not released and may cause memory leaks. Запись журнала предоставляет имя компонента и идентификатор буфера.The log entry provides the name of the component and the ID of the buffer.
PipelineExecutionPlanPipelineExecutionPlan Сообщает о плане выполнения потока данных.Reports the execution plan of the data flow. Предоставляет сведения о том, как буферы будут отсылаться компонентам.It provides information about how buffers will be sent to components. Эти сведения в сочетании с записью PipelineExecutionTrees описывают, что происходит в задаче.This information, in combination with the PipelineExecutionTrees entry, describes what is occurring in the task.
PipelineExecutionTreesPipelineExecutionTrees Сообщает о дереве выполнения макета в потоке данных.Reports the execution trees of the layout in the data flow. Планировщик подсистемы обработки потока данных использует эти деревья для построения плана выполнения потока данных.The scheduler of the data flow engine use the trees to build the execution plan of the data flow.
PipelineInitializationPipelineInitialization Предоставляет сведения об инициализации задачи.Provides initialization information about the task. Эти сведения включают каталоги, используемые для временного хранения данных большого объема типа BLOB, размер буфера по умолчанию и количество строк в буфере.This information includes the directories to use for temporary storage of BLOB data, the default buffer size, and the number of rows in a buffer. В зависимости от настройки задачи потока данных, возможно формирование нескольких записей в журнале.Depending on the configuration of the Data Flow task, multiple log entries may be written.

Задача «Выполнение пакета служб DTS 2000»Execute DTS 2000 Task

В следующей таблице перечислены пользовательские записи в журнале для задачи «Выполнение пакета служб DTS 2000».The following table lists the custom log entries for the Execute DTS 2000 task.

Запись журналаLog entry DescriptionDescription
ExecuteDTS80PackageTaskBeginExecuteDTS80PackageTaskBegin Указывает, что задача приступила к выполнению пакета служб DTS 2000.Indicates that the task began to run a DTS 2000 package.
ExecuteDTS80PackageTaskEndExecuteDTS80PackageTaskEnd Указывает, что выполнение задачи завершено.Indicates that the task finished.

Примечание. Пакет служб DTS 2000 может продолжить свое выполнение после завершения задачи.Note: The DTS 2000 package may continue to run after the task ends.
ExecuteDTS80PackageTaskTaskInfoExecuteDTS80PackageTaskTaskInfo Выводит описательные сведения об этой задаче.Provides descriptive information about the task.
ExecuteDTS80PackageTaskTaskResultExecuteDTS80PackageTaskTaskResult Сообщает результаты выполнения пакета служб DTS 2000, запущенного задачей.Reports the execution result of the DTS 2000 package that the task ran.

Задача «Выполнение процесса»Execute Process Task

В следующей таблице перечислены пользовательские записи в журнале для задачи «Выполнение процесса».The following table lists the custom log entries for the Execute Process task.

Запись журналаLog entry ОписаниеDescription
ExecuteProcessExecutingProcessExecuteProcessExecutingProcess Предоставляет сведения о процессе выполнения исполняемого объекта, на запуск которого настроена задача.Provides information about the process of running the executable that the task is configured to run.

В журнале формируются две записи.Two log entries are written. Одна из них предоставляет сведения об имени и месте выполнения исполняемого объекта, на запуск которого настроена задача, другая фиксирует выход из исполняемого объекта.One contains information about the name and location of the executable that the task runs, and the other records the exit from the executable.
ExecuteProcessVariableRoutingExecuteProcessVariableRouting Предоставляет сведения о том, какие переменные направляются на вход и выходы исполняемого объекта.Provides information about which variables are routed to the input and outputs of the executable. Данные журнала записываются для потоков stdin (вход), stdout (выход) и stderr (вывод ошибок на выходе).Log entries are written for stdin (the input), stdout (the output), and stderr (the error output).

Задача «Выполнение SQL»Execute SQL Task

В следующей таблице перечислены пользовательские записи журнала для задачи «Выполнение SQL».The following table describes the custom log entry for the Execute SQL task.

Запись журналаLog entry ОписаниеDescription
ExecuteSQLExecutingQueryExecuteSQLExecutingQuery Предоставляет сведения об этапах выполнения инструкции SQL.Provides information about the execution phases of the SQL statement. Записи журнала формируются в тот момент, когда задача устанавливает соединение с базой данных, когда задача приступает к подготовке инструкции SQL, и после того, как завершается выполнение инструкции SQL.Log entries are written when the task acquires connection to the database, when the task starts to prepare the SQL statement, and after the execution of the SQL statement is completed. Запись журнала для этапа подготовки содержит инструкцию SQL, которая используется задачей.The log entry for the prepare phase includes the SQL statement that the task uses.

Задача "Файловая система"File System Task

В следующей таблице перечислены пользовательские записи журнала для задачи «Файловая система».The following table describes the custom log entry for the File System task.

Запись журналаLog entry ОписаниеDescription
FileSystemOperationFileSystemOperation Сообщает об операции, выполняемой задачей.Reports the operation that the task performs. Эта запись журнала формируется, когда операция файловой системы начинается и включает сведения об источнике и назначении.The log entry is written when the file system operation starts and includes information about the source and destination.

Задача «FTP»FTP Task

В следующей таблице перечислены пользовательские записи журнала для задачи «FTP».The following table lists the custom log entries for the FTP task.

Запись журналаLog entry ОписаниеDescription
FTPConnectingToServerFTPConnectingToServer Указывает, что задача инициализировала соединение с FTP-сервером.Indicates that the task initiated a connection to the FTP server.
FTPOperationFTPOperation Сообщает о начале FTP-операции, выполняемой задачей, и о типе этой операции.Reports the beginning of and the type of FTP operation that the task performs.

Задача «Очередь сообщений»Message Queue Task

В следующей таблице перечислены пользовательские записи в журнале для задачи «Очередь сообщений».The following table lists the custom log entries for the Message Queue task.

Запись журналаLog entry ОписаниеDescription
MSMQAfterOpenMSMQAfterOpen Указывает, что задача завершила открытие очереди сообщений.Indicates that the task finished opening the message queue.
MSMQBeforeOpenMSMQBeforeOpen Указывает, что задача приступила к открытию очереди сообщений.Indicates that the task began to open the message queue.
MSMQBeginReceiveMSMQBeginReceive Указывает, что задача приступила к получению сообщения.Indicates that the task began to receive a message.
MSMQBeginSendMSMQBeginSend Указывает, что задача приступила к отправке сообщения.Indicates that the task began to send a message.
MSMQEndReceiveMSMQEndReceive Указывает, что задача завершила прием сообщения.Indicates that the task finished receiving a message.
MSMQEndSendMSMQEndSend Указывает, что задача завершила отправку сообщения.Indicates that the task finished sending a message
MSMQTaskInfoMSMQTaskInfo Выводит описательные сведения об этой задаче.Provides descriptive information about the task.
MSMQTaskTimeOutMSMQTaskTimeOut Указывает, что время ожидания выполнения задачи истекло.Indicates that the task timed out.

Задача «Скрипт»Script Task

В следующей таблице перечислены пользовательские записи журнала для задачи «Скрипт».The following table describes the custom log entry for the Script task.

Запись журналаLog entry DescriptionDescription
ScriptTaskLogEntryScriptTaskLogEntry Сообщает о результатах выполнения операции ведения журнала в скрипте.Reports the results of implementing logging in the script. Запись журнала формируется для каждого вызова метода Log объекта Dts .A log entry is written for each call to the Log method of the Dts object. Эта запись формируется в момент запуска кода.The entry is written when the code is run. Дополнительные сведения см. в разделе ведения журналов в задаче «скрипт».For more information, see Logging in the Script Task.

Задача «Отправка почты»Send Mail Task

В следующей таблице перечислены пользовательские записи в журнале для задачи «Отправка почты».The following table lists the custom log entries for the Send Mail task.

Запись журналаLog entry ОписаниеDescription
SendMailTaskBeginSendMailTaskBegin Указывает, что задача приступила к отправке сообщения электронной почты.Indicates that the task began to send an e-mail message.
SendMailTaskEndSendMailTaskEnd Указывает, что задача завершила отправку сообщения электронной почты.Indicates that the task finished sending an e-mail message.
SendMailTaskInfoSendMailTaskInfo Выводит описательные сведения об этой задаче.Provides descriptive information about the task.

Задача «Передача базы данных»Transfer Database Task

В следующей таблице перечислены пользовательские записи в журнале для задачи «Передача базы данных».The following table lists the custom log entries for the Transfer Database task.

Запись журналаLog entry DescriptionDescription
SourceDBSourceDB Указывает базу данных, которая копируется задачей.Specifies the database that the task copied.
SourceSQLServerSourceSQLServer Указывает компьютер, с которого копируется база данных.Specifies the computer from which the database was copied.

Задача «Передача сообщений об ошибках»Transfer Error Messages Task

В следующей таблице перечислены пользовательские записи в журнале для задачи «Передача сообщений об ошибках».The following table lists the custom log entries for the Transfer Error Messages task.

Запись журналаLog entry DescriptionDescription
TransferErrorMessagesTaskFinishedTransferringObjectsTransferErrorMessagesTaskFinishedTransferringObjects Указывает, что задача завершила передачу сообщений об ошибках.Indicates that the task finished transferring error messages.
TransferErrorMessagesTaskStartTransferringObjectsTransferErrorMessagesTaskStartTransferringObjects Указывает, что задача приступила к передаче сообщений об ошибках.Indicates that the task started to transfer error messages.

Задача «Передача заданий»Transfer Jobs Task

В следующей таблице перечислены пользовательские записи в журнале для задачи «Передача заданий».The following table lists the custom log entries for the Transfer Jobs task.

Запись журналаLog entry DescriptionDescription
TransferJobsTaskFinishedTransferringObjectsTransferJobsTaskFinishedTransferringObjects Указывает, что задача завершила передачу заданий агента SQL ServerSQL Server .Indicates that the task finished transferring SQL ServerSQL Server Agent jobs.
TransferJobsTaskStartTransferringObjectsTransferJobsTaskStartTransferringObjects Указывает, что задача приступила к передаче заданий агента SQL ServerSQL Server .Indicates that the task started to transfer SQL ServerSQL Server Agent jobs.

Задача «Передача имен входа»Transfer Logins Task

В следующей таблице перечислены пользовательские записи в журнале для задачи «Передача имен входа».The following table lists the custom log entries for the Transfer Logins task.

Запись журналаLog entry DescriptionDescription
TransferLoginsTaskFinishedTransferringObjectsTransferLoginsTaskFinishedTransferringObjects Указывает, что задача завершила передачу имен входа.Indicates that the task finished transferring logins.
TransferLoginsTaskStartTransferringObjectsTransferLoginsTaskStartTransferringObjects Указывает, что задача приступила к передаче имен входа.Indicates that the task started to transfer logins.

Задача «Передача главных хранимых процедур»Transfer Master Stored Procedures Task

В следующей таблице перечислены пользовательские записи в журнале для задачи «Передача главных хранимых процедур».The following table lists the custom log entries for the Transfer Master Stored Procedures task.

Запись журналаLog entry DescriptionDescription
TransferStoredProceduresTaskFinishedTransferringObjectsTransferStoredProceduresTaskFinishedTransferringObjects Указывает, что задача завершила передачу пользовательских хранимых процедур, хранящихся в базе данных master .Indicates that the task finished transferring user-defined stored procedures that are stored in the master database.
TransferStoredProceduresTaskStartTransferringObjectsTransferStoredProceduresTaskStartTransferringObjects Указывает, что задача приступила к передаче пользовательских хранимых процедур, хранящихся в базе данных master .Indicates that the task started to transfer user-defined stored procedures that are stored in the master database.

Задача «Передача объектов SQL Server»Transfer SQL Server Objects Task

В следующей таблице перечислены пользовательские записи в журнале для задачи «Передача объектов SQL ServerSQL Server ».The following table lists the custom log entries for the Transfer SQL ServerSQL Server Objects task.

Запись журналаLog entry DescriptionDescription
TransferSqlServerObjectsTaskFinishedTransferringObjectsTransferSqlServerObjectsTaskFinishedTransferringObjects Указывает, что задача завершила передачу объектов базы данных SQL ServerSQL Server .Indicates that the task finished transferring SQL ServerSQL Server database objects.
TransferSqlServerObjectsTaskStartTransferringObjectsTransferSqlServerObjectsTaskStartTransferringObjects Указывает, что задача приступила к передаче объектов базы данных SQL ServerSQL Server .Indicates that the task started to transfer SQL ServerSQL Server database objects.

Задача «Веб-служба»Web Services Task

В следующей таблице перечислены пользовательские записи в журнале для задачи «Веб-служба».The following table lists the custom log entries that you can enable for the Web Services task.

Запись журналаLog entry ОписаниеDescription
WSTaskBeginWSTaskBegin Задача получила доступ к веб-службе.The task began to access a Web service.
WSTaskEndWSTaskEnd Задача завершила метод веб-службы.The task completed a Web service method.
WSTaskInfoWSTaskInfo Описательные сведения об этой задаче.Descriptive information about the task.

Задача «Модуль чтения данных WMI»WMI Data Reader Task

В следующей таблице перечислены пользовательские записи в журнале для задачи «Модуль чтения данных WMI».The following table lists the custom log entries for the WMI Data Reader task.

Запись журналаLog entry ОписаниеDescription
WMIDataReaderGettingWMIDataWMIDataReaderGettingWMIData Указывает, что задача приступила к чтению данных инструментария WMI.Indicates that the task began to read WMI data.
WMIDataReaderOperationWMIDataReaderOperation Сообщает о WQL-запросе, выполняемом задачей.Reports the WQL query that the task ran.

Задача «Отслеживание событий WMI»WMI Event Watcher Task

В следующей таблице перечислены пользовательские записи в журнале для задачи «Отслеживание событий WMI».The following table lists the custom log entries for the WMI Event Watcher task.

Запись журналаLog entry ОписаниеDescription
WMIEventWatcherEventOccurredWMIEventWatcherEventOccurred Сообщает, что произошло событие, отслеживаемое задачей.Denotes that the event occurred that the task was monitoring.
WMIEventWatcherTimedoutWMIEventWatcherTimedout Указывает, что время ожидания выполнения задачи истекло.Indicates that the task timed out.
WMIEventWatcherWatchingForWMIEventsWMIEventWatcherWatchingForWMIEvents Указывает, что задача приступила к выполнению WQL-запроса.Indicates that the task began to execute the WQL query. Эта запись содержит запрос.The entry includes the query.

Задача «XML»XML Task

В приведенной ниже таблице перечислены пользовательские записи журнала для задачи «XML».The following table describes the custom log entry for the XML task.

Запись журналаLog entry ОписаниеDescription
XMLOperationXMLOperation Предоставляет сведения об операции, выполняемой задачейProvides information about the operation that the task performs

В следующем списке приведены ссылки на разделы, в которых описывается выполнение задач, связанных с функцией ведения журналов.The following list contains links to topics that show how to perform tasks related to the logging feature.

Инструмент DTLoggedExec для полного и подробного ведения журнала (проект CodePlex)DTLoggedExec Tool for Full and Detail Logging (CodePlex Project)