Destino de archivo de eventos
El destino de archivo de eventos es un destino que escribe búferes completos en el disco.
En la tabla siguiente se describen las opciones disponibles para configurar el destino de archivo de eventos.
Opción |
Valores permitidos |
Descripción |
|---|---|---|
filename |
Cualquier cadena de 260 caracteres, como máximo. Este valor es necesario. |
La ubicación y el nombre del archivo. Puede utilizar cualquier extensión de nombre de archivo. |
max_file_size |
Cualquier entero de 64 bits. Este valor es opcional. |
El tamaño máximo del archivo en megabytes (MB). Si no se especifica max_file_size, el archivo aumentará de tamaño hasta que el disco esté lleno. El tamaño de archivo predeterminado es 1GB. max_file_size debe ser mayor que el tamaño actual de los búferes de sesión. Si no lo es, el destino del archivo no podrá inicializarse y se notificará que max_file_size no es válido. Para ver el tamaño actual de los búferes, vea la columna buffer_size en la vista de administración dinámica sys.dm_xe_sessions. Si el tamaño de archivo predeterminado es menor que el tamaño de búfer de la sesión, recomendamos establecer max_file_size en el valor especificado en la columna max_memory de la vista del catálogo sys.server_event_sessions. Cuando max_file_size se establece en un tamaño mayor que el de los búferes de la sesión, se puede redondear hacia abajo al múltiplo más próximo del tamaño de búfer de la sesión. De esta forma puede crearse un archivo de destino que sea menor que el valor especificado para max_file_size. Por ejemplo, si el tamaño del búfer es de 100 MB y max_file_size está establecido en 150 MB, el tamaño de archivo resultante se redondea hacia abajo a 100 MB porque un segundo búfer no cabría en los 50 MB de espacio restantes. Si el tamaño de archivo predeterminado es menor que el tamaño de búfer de la sesión, recomendamos establecer max_file_size en el valor especificado en la columna max_memory de la vista del catálogo sys.server_event_sessions. |
max_rollover_files |
Cualquier entero de 32 bits. Este valor es opcional. |
El número máximo de archivos que se desean conservar en el sistema de archivos. |
increment |
Cualquier entero de 32 bits. Este valor es opcional. |
El crecimiento incremental, en megabytes (MB), para el archivo. Si no se especifica, el valor predeterminado para el incremento es dos veces el tamaño del búfer de la sesión. |
La primera vez que se crea un destino de archivo de eventos, al nombre de archivo que especifique se le anexa _0_ y un valor entero largo. El valor entero se calcula como el número de milisegundos entre el 1 de enero de 1600 y la fecha y la hora en que se crea el archivo. Los archivos de sustitución incremental siguientes también utilizan este formato. Al examinar el valor del entero largo, puede determinar el archivo más actual. En el ejemplo siguiente se muestra cómo se denominan los archivos de sustitución incremental en un escenario en el que la opción filename se especifica como C:\OutputFiles\MyOutput.xel:
primer archivo creado - C:\OutputFiles\MyOutput_0_128500310259380000.xel
primer archivo de sustitución incremental - C:\OutputFiles\MyOutput_0_128505831770890000.xel
segundo archivo de sustitución incremental - C:\OutputFiles\MyOutput_0_132410772966237000.xel
Agregar el destino a una sesión
Para agregar el archivo de destino de eventos a una sesión de Extended Events, incluiría las siguientes instrucciones al crear o modificar una sesión de eventos, reemplazando file_name por el nombre de archivo y la ruta de acceso que desee:
ADD TARGET package0.event_file(
SET filename='file_name.xel')
Revisar la salida del destino
Para revisar el resultado del destino del archivo, debe utilizar la función sys.fn_xe_file_target_read_file. Recomendamos convertir los datos en XML. Puede utilizar la siguiente sintaxis, reemplazando file_name por el nombre de archivo y la ruta de acceso que especificó cuando agregó el destino:
SELECT *, CAST(event_data AS XML) AS 'event_data_XML'
FROM sys.fn_xe_file_target_read_file('file_name*.xel', NULL, NULL, NULL)
Vea también
Referencia
sys.fn_xe_file_target_read_file (Transact-SQL)
CREATE EVENT SESSION (Transact-SQL)
ALTER EVENT SESSION (Transact-SQL)