SQLdiag , utilidad

La utilidad SQLdiag es una herramienta de recopilación de diagnósticos de uso general que se puede ejecutar como una aplicación de consola o como un servicio. Puede usar SQLdiag para recopilar los archivos de datos y de registro de SQL Server y otros tipos de servidores, y para supervisar los servidores a lo largo del tiempo o solucionar problemas específicos de los mismos. SQLdiag se ha diseñado para acelerar y simplificar la recopilación de información de diagnóstico para los Servicios de soporte técnico de Microsoft .

SQLdiag puede recopilar los siguientes tipos de información de diagnóstico:

• Registros de rendimiento de Windows

• Registros de eventos de Windows

• SQL Server Profiler seguimientos

• SQL Server información de bloqueo

• SQL Server información de configuración

Puede especificar los tipos de información que quiere que SQLdiag recopile si modifica el archivo de configuración SQLDiag.xml, que se describe en la siguiente sección.

Sintaxis

  
      sqldiag   
     { [/?] }  
     |  
     { [/I configuration_file]  
       [/O output_folder_path]  
       [/Psupport_folder_path]  
       [/Noutput_folder_management_option]  
       [/Mmachine1 [ machine2machineN]| @machinelistfile]  
       [/Cfile_compression_type]  
       [/B [+]start_time]  
       [/E [+]stop_time]  
       [/ASQLdiag_application_name]  
       [/T { tcp [ ,port ] | np | lpc } ]  
       [/Q] [/G] [/R] [/U] [/L] [/X] }  
     |  
     { [START | STOP | STOP_ABORT] }  
     |  
     { [START | STOP | STOP_ABORT] /ASQLdiag_application_name }  

Argumentos

/?
Muestra información de uso.

/I configuration_file
Establece el archivo de configuración que usará SQLdiag . De forma predeterminada, /I está establecido en SQLDiag.Xml.

/O output_folder_path
Redirige la salida de SQLdiag a la carpeta especificada. Si no se especifica la opción /O , la salida de SQLdiag se escribe en una subcarpeta denominada SQLDIAG en la carpeta de inicio de SQLdiag . Si no existe la carpeta SQLDIAG, SQLdiag intenta crearla.

/P support_folder_path
Define la ruta de la carpeta Support. De forma predeterminada, /P está establecido en la carpeta en que reside el ejecutable SQLdiag . La carpeta Support contiene los archivos de compatibilidad de SQLdiag , como el archivo de configuración XML, los scripts Transact-SQL y otros archivos que usa la utilidad durante la recopilación de diagnósticos. Si usa esta opción para especificar una ruta de acceso alternativa a los archivos de compatibilidad, SQLdiag copiará automáticamente los archivos de compatibilidad que necesita en la carpeta especificada, si todavía no existen.

/N output_folder_management_option
Establece si SQLdiag sobrescribe o cambia el nombre de la carpeta de salida cuando se inicia. Opciones disponibles:

1 = Sobrescribe la carpeta de salida (valor predeterminado)

2 = Cuando se inicia SQLdiag , cambia el nombre de la carpeta de salida a SQLDIAG_00001, SQLDIAG_00002, etc. Una vez cambiado el nombre de la carpeta de salida actual, SQLdiag escribe la salida en la carpeta de salida predeterminada SQLDIAG.

/M machine1 [ machine2**machineN] | @machinelistfile
Invalida los equipos especificados en el archivo de configuración. De forma predeterminada, el archivo de configuración es SQLDiag.Xml, o se establece con el parámetro /I . Al especificar más de un equipo, separe cada nombre de equipo con un espacio.

Con @machinelistfile se especifica un nombre de archivo de la lista de equipos que se va a almacenar en el archivo de configuración.

/C file_compression_type
Establece el tipo de compresión de archivo que se usa en los archivos de la carpeta de salida de SQLdiag . Opciones disponibles:

0 = ninguno (valor predeterminado)

1 = utiliza la compresión NTFS

/B [ + ]start_time
Especifica la fecha y la hora en que se empiezan a recopilar los datos de diagnóstico en el siguiente formato:

AAAAMMDD_HH:MM:SS

La hora se especifica usando el reloj de 24 horas. Por ejemplo, 2:00 p.m. se debe especificar como 14:00:00.

Use + sin la fecha (solo HH:MM:SS) para especificar una hora que sea relativa a la fecha y la hora actuales. Por ejemplo, si especifica /B +02:00:00, SQLdiag esperará 2 horas antes de empezar a recopilar información.

No inserte ningún espacio entre + y el valor de start_timeespecificado.

Si especifica una hora de inicio que se encuentra en el pasado, SQLdiag cambia forzosamente la fecha de inicio para que la fecha y la hora de inicio se encuentren en el futuro. Por ejemplo, si especifica /B 01:00:00 y la hora actual es 08:00:00, SQLdiag cambia forzosamente la fecha de inicio para que sea el día siguiente.

Tenga en cuenta que SQLdiag usa la hora local del equipo en el que se ejecuta la utilidad.

/E [ + ]stop_time
Especifica la fecha y la hora en que se dejan de recopilar los datos de diagnóstico en el siguiente formato:

AAAAMMDD_HH:MM:SS

La hora se especifica usando el reloj de 24 horas. Por ejemplo, 2:00 p.m. se debe especificar como 14:00:00.

Use + sin la fecha (solo HH:MM:SS) para especificar una hora que sea relativa a la fecha y la hora actuales. Por ejemplo, si especifica una hora de inicio y una hora de finalización mediante /B +02:00:00 /E +03:00:00, SQLdiag espera 2 horas para empezar a recopilar información y después recopila información durante 3 horas antes de detenerse y cerrarse. Si no se especifica /B , SQLdiag empieza a recopilar información de diagnóstico inmediatamente y finaliza en la fecha y la hora especificadas por /E.

No inserte ningún espacio entre + y el valor especificado de start_time o end_time.

Tenga en cuenta que SQLdiag usa la hora local del equipo en el que se ejecuta la utilidad.

/A SQLdiag_application_name
Permite la ejecución de varias instancias de la utilidad SQLdiag en la misma instancia de SQL Server .

Cada SQLdiag_application_name identifica una instancia diferente de SQLdiag. No existe ninguna relación entre una instancia de SQLdiag_application_name y un nombre de instancia de SQL Server .

SQLdiag_application_name se puede usar para iniciar o detener una instancia concreta del servicio SQLdiag .

Por ejemplo:

SQLDIAG START /A SQLdiag_application_name

También se puede usar con la opción /R para registrar una instancia concreta de SQLdiag como servicio. Por ejemplo:

SQLDIAG /R /A SQLdiag_application_name

/T { tcp [ ,port ] | np | lpc }
Se conecta a una instancia de SQL Server con el protocolo especificado.

tcp [,port]
TCP/IP (Protocolo de control de transmisión/protocolo de Internet). Si lo desea, puede especificar un número de puerto para la conexión.

np
Canalizaciones con nombre. De manera predeterminada, la instancia predeterminada de SQL Server escucha en la canalización con nombre: \\.\pipe\sql\query y en \\.\pipe\MSSQL$<instancename>\sql\query para una instancia con nombre. No puede conectar a una instancia de SQL Server usando un nombre de canalización alternativa.

lpc
Llamada a procedimiento local. Este protocolo de memoria compartida está disponible si el cliente se está conectando a una instancia de SQL Server del mismo equipo.

/Q
Ejecuta SQLdiag en modo silencioso. /Q suprime todos los mensajes, como los de contraseña.

/G
Ejecuta SQLdiag en modo genérico. Cuando se especifica /G , al iniciarse SQLdiag , no aplica las comprobaciones de conectividad de SQL Server ni si el usuario es miembro del rol fijo de servidor sysadmin . En su lugar, SQLdiag consulta con Windows para determinar si un usuario tiene los derechos adecuados para recopilar cada diagnóstico solicitado.

Si no se especifica /G , SQLdiag comprueba si el usuario es miembro del grupo Administradores de Windows y no recopila diagnósticos de SQL Server si el usuario no es miembro del grupo Administradores .

/R
Registra SQLdiag como servicio. Cualquier argumento de la línea de comandos que se especifique al registrar SQLdiag como servicio se guarda para futuras ejecuciones del servicio.

Cuando se registra SQLdiag como servicio, el nombre predeterminado del servicio es SQLDIAG. Puede modificar el nombre de servicio con el argumento /A .

Use el argumento de línea de comandos START para iniciar el servicio:

SQLDIAG START

También puede usar el comando net start para iniciar el servicio:

net start SQLDIAG

/U
Elimina del Registro SQLdiag como servicio.

Use también el argumento /A si elimina del Registro una instancia con nombre de SQLdiag .

/L
Ejecuta SQLdiag en modo continuo cuando se especifica además una hora de inicio o de finalización con los argumentos /B o /E , respectivamente. SQLdiag se reinicia automáticamente después de que se detenga la recopilación de diagnósticos debido a un cierre programado. Por ejemplo, con los argumentos /E o /X .

El uso de /L no implica el modo de servicio. Para usar /L cuando se ejecuta SQLdiag como servicio, especifíquelo en la línea de comandos al registrar el servicio.

/X
Ejecuta SQLdiag en modo de instantánea. SQLdiag toma una instantánea de todos los diagnósticos configurados y después se cierra automáticamente.

START | STOP | STOP_ABORT
Inicia o detiene el servicio SQLdiag . STOP_ABORT obliga al servicio a cerrarse lo más rápido posible sin terminar la recopilación de diagnósticos que está realizando.

Cuando se emplean estos argumentos de control del servicio, deben ser los primeros argumentos utilizados en la línea de comandos. Por ejemplo:

SQLDIAG START

El argumento /A , que especifica una instancia con nombre de SQLdiag, es el único que se puede usar con START, STOPo STOP_ABORT para controlar una instancia específica del servicio SQLdiag . Por ejemplo:

SQLDIAG START /A SQLdiag_application_name

Requisitos de seguridad

A menos que SQLdiag se ejecute en modo genérico (especificando el argumento de la línea de comandos /G ), el usuario que ejecuta SQLdiag debe ser miembro del grupo Administradores de Windows y del rol fijo de servidor SQL Server sysadmin. De forma predeterminada, SQLdiag conecta con SQL Server mediante la autenticación de Windows, pero también admite la autenticación de SQL Server .

Consideraciones de rendimiento

Los efectos sobre el rendimiento de la ejecución de SQLdiag dependen del tipo de datos de diagnóstico cuya recopilación se haya configurado. Por ejemplo, si ha configurado SQLdiag para recopilar la información de seguimiento de SQL Server Profiler , cuanto mayor sea el número de clases de eventos de las que decida realizar un seguimiento, más se verá afectado el rendimiento del servidor.

El impacto sobre el rendimiento de la ejecución de SQLdiag es aproximadamente equivalente a la suma de los costos de recopilar los diagnósticos configurados por separado. Por ejemplo, si recopila un seguimiento con SQLdiag , incurrirá en el mismo costo de rendimiento que si lo recopila con SQL Server Profiler. El impacto que el uso de SQLdiag tiene sobre el rendimiento es mínimo.

Espacio en disco requerido

Dado que SQLdiag puede recopilar diferentes tipos de información de diagnóstico, el espacio libre en disco necesario para ejecutar SQLdiag varía. La cantidad de información de diagnóstico recopilada depende de la naturaleza y del volumen de la carga de trabajo que el servidor está procesando y puede oscilar entre unos pocos megabytes o varios gigabytes.

Archivos de configuración

Durante el inicio, SQLdiag lee el archivo de configuración y los argumentos de la línea de comandos que se han especificado. Puede especificar los tipos de información de diagnóstico que SQLdiag recopila en el archivo de configuración. De forma predeterminada, SQLdiag usa el archivo de configuración SQLDiag.Xml, que se extrae cada vez que se ejecuta la herramienta y se encuentra ubicado en la carpeta de inicio de la utilidad SQLdiag . El archivo de configuración usa el esquema XML, SQLDiag_schema.xsd, que también se extrae en el directorio de inicio de la utilidad desde el archivo ejecutable cada vez que se ejecuta SQLdiag .

Editar los archivos de configuración

Puede copiar y editar SQLDiag.Xml para cambiar los tipos de datos de diagnóstico que SQLdiag recopila. Cuando edite el archivo de configuración, use siempre un editor XML que pueda validar dicho archivo comparándolo con su esquema XML, como por ejemplo, Management Studio. No debe editar SQLDiag.Xml directamente. En su lugar, realice una copia de SQLDiag.Xml y cambie su nombre por otro nombre de archivo en la misma carpeta. Después, edite el nuevo archivo y use el argumento /I para pasarlo a SQLdiag.

Editar el archivo de configuración cuando SQLdiag se ejecuta como servicio

Si ya ha ejecutado SQLdiag como servicio y necesita editar el archivo de configuración, elimine del Registro el servicio SQLDIAG. Para ello, especifique el argumento de la línea de comandos /U y después vuelva a registrar el servicio mediante el argumento de la línea de comandos /R . Si elimina el servicio del registro y lo vuelve a registrar, se eliminará la información de configuración antigua que se almacenó en caché en el Registro de Windows.

Carpeta de salida

Si no especifica una carpeta de salida con el argumento /O , SQLdiag crea una subcarpeta denominada SQLDIAG en la carpeta de inicio de SQLdiag . Para la recopilación de información de diagnóstico que implica un elevado volumen de seguimientos, como SQL Server Profiler , asegúrese de que la carpeta de salida se encuentra en una unidad local con espacio suficiente para almacenar la salida del diagnóstico solicitado.

Cuando se reinicia SQLdiag , sobrescribe el contenido de la carpeta de salida. Para evitarlo, especifique /N 2 en la línea de comandos.

Proceso de recopilación de datos

Cuando se inicia SQLdiag , realiza las comprobaciones de inicialización necesarias para recopilar los datos de diagnóstico que se han especificado en SQLDiag.Xml. Este proceso puede tardar varios segundos. Una vez que SQLdiag ha empezado a recopilar los datos de diagnóstico cuando se ejecuta como aplicación de consola, se muestra un mensaje que informa de que se ha iniciado la recopilación de SQLdiag y de que puede pulsar CTRL+C para detenerla. Cuando SQLdiag se ejecuta como servicio, se escribe un mensaje similar en el registro de eventos de Windows.

Si usa SQLdiag para diagnosticar un problema que puede reproducir, espere hasta que reciba este mensaje antes de reproducir el problema en el servidor.

SQLdiag recopila la mayor parte de los datos de diagnóstico en paralelo. Para recopilar toda la información de diagnóstico se conecta con herramientas, como la utilidad SQL Server sqlcmd o el procesador de comandos de Windows, excepto cuando la información se recopila de los registros de rendimiento y de los registros de eventos de Windows. SQLdiag usa un subproceso de trabajo por cada equipo para supervisar la recopilación de datos de diagnóstico de esas otras herramientas y, a menudo, espera simultáneamente a que varias herramientas completen su proceso. Durante el proceso de recopilación, SQLdiag enruta la salida de cada diagnóstico a la carpeta de salida.

Detener la recopilación de datos

Cuando SQLdiag empieza a recopilar los datos de diagnóstico, continua haciéndolo a menos que el usuario lo detenga o que se configure para que se detenga a una hora especificada. Puede configurar SQLdiag para que se detenga a una hora especificada mediante el argumento /E , que permite especificar una hora de detención, o mediante el argumento /X , que hace que SQLdiag se ejecute en el modo de instantánea.

Cuando SQLdiag se detenga, detendrá todos los diagnósticos que haya iniciado. Por ejemplo, detiene los seguimientos de SQL Server Profiler que estaba recopilando, deja de ejecutar los scripts de Transact-SQL que estaba ejecutando y detiene los subprocesos que ha generado durante la recopilación de datos. Una vez completada la recopilación de datos de diagnóstico, SQLdiag se cierra.

Para detener SQLdiag cuando se ejecuta como aplicación de consola

Si está ejecutando SQLdiag como aplicación de consola, pulse CTRL+C en la ventana de la consola en la que se está ejecutando SQLdiag para detenerlo. Tras pulsar CTRL+C, se muestra un mensaje en la ventana de la consola que le informa de que la recopilación de datos de SQLDiag está finalizando y de que debe esperar hasta que se cierre el proceso, lo que puede tardar varios minutos.

Presione CTRL+C dos veces para terminar todos los procesos de diagnóstico secundarios y cierre la aplicación inmediatamente.

Para detener SQLdiag cuando se ejecuta como servicio

Si ejecuta SQLdiag como servicio, ejecute SQLDiag STOP en la carpeta de inicio de SQLdiag para detenerlo.

Si ejecuta varias instancias de SQLdiag en el mismo equipo, también puede pasar el nombre de instancia de SQLdiag a la línea de comandos cuando detenga el servicio. Por ejemplo, para detener una instancia de SQLdiag denominada Instance1, use la siguiente sintaxis:

SQLDIAG STOP /A Instance1  

Para detener el servicio lo más rápido posible, ejecute SQLDIAG STOP_ABORT en la carpeta de inicio de la utilidad. Este comando anula todas las recopilaciones de diagnósticos en curso sin esperar a que terminen de ejecutarse.

Iniciar y detener automáticamente SQLdiag

Para iniciar y detener automáticamente la recopilación de datos de diagnóstico a una hora especificada, use los argumentos /Bstart_time y /Estop_time (con la notación de 24 horas). Por ejemplo, si está solucionando un problema que suele aparecer a las 02:00:00 aproximadamente, puede configurar SQLdiag para empezar a recopilar automáticamente datos de diagnóstico a la 01:00 y dejar de recopilarlos a las 03:00:00. Use los argumentos /B y /E para especificar la hora de inicio y detención. Utilice la notación de 24 horas para especificar una hora y una fecha de inicio y de finalización exactas con el formato AAAAMMDD_HH:MM:SS. Para especificar una hora de inicio o detención relativa, anteponga + a la hora de inicio o de detención y omita la parte de la fecha (AAAAMMDD_) como se muestra en el siguiente ejemplo, lo que hace que SQLdiag espere 1 hora antes de empezar a recopilar información; después recopila la información durante 3 horas hasta que se detiene y se cierra:

sqldiag /B +01:00:00 /E +03:00:00  

Cuando se especifica un valor start_time relativo, SQLdiag se inicia a una hora relativa respecto a la hora y la fecha actuales. Cuando se especifica un valor end_time relativo, SQLdiag finaliza a una hora relativa respecto al valor start_timeespecificado. Si la hora o la fecha de inicio y de finalización que ha especificado corresponden al pasado, SQLdiag cambiará forzosamente la fecha de inicio para que la fecha y la hora de inicio correspondan al futuro.

Esto tiene importantes implicaciones para las fechas de inicio y de finalización que elija. Considere el ejemplo siguiente:

sqldiag /B +01:00:00 /E 08:30:00  

Si la hora actual es 08:00, la hora de finalización termina antes de que empiece la recopilación de diagnóstico. Dado que SQLDiag ajusta automáticamente las fechas de inicio y de finalización al día siguiente cuando corresponden al pasado, en este ejemplo, la recopilación de diagnósticos se inicia a las 09:00 de hoy (se ha especificado una hora de inicio relativa con +) y continúa hasta las 08:30 del día siguiente.

Detener y reiniciar SQLdiag para que recopile diagnósticos diariamente

Para recopilar diariamente un conjunto de diagnósticos especificado sin tener que iniciar y detener manualmente SQLdiag, use el argumento /L . El argumento /L hace que SQLdiag se ejecute de forma continua al reiniciarse automáticamente después de un cierre programado. Cuando se especifica /L y SQLdiag se detiene porque ha llegado la hora de finalización especificada con el argumento /E , o se detiene porque se está ejecutando en el modo de instantánea con el argumento /X , SQLdiag se reinicia en vez de cerrarse.

En el siguiente ejemplo se especifica que SQLdiag se ejecute en modo continuo para que se reinicie automáticamente después de recopilar los datos de diagnóstico entre las 03:00:00 y las 05:00:00.

sqldiag /B 03:00:00 /E 05:00:00 /L  

En el siguiente ejemplo se especifica que SQLdiag se ejecute en modo continuo para que se reinicie automáticamente después de tomar una instantánea de datos de diagnóstico a las 03:00:00.

sqldiag /B 03:00:00 /X /L  

Ejecutar SQLdiag como servicio

Si desea usar SQLdiag para recopilar los datos de diagnóstico durante largos períodos de tiempo en los que puede ser necesario cerrar sesión en el equipo en el que se está ejecutando SQLdiag , puede ejecutarlo como servicio.

Para registrar SQLDiag para que se ejecute como servicio

Puede registrar SQLdiag para que se ejecute como servicio si especifica el argumento /R en la línea de comandos. De esta forma se registra SQLdiag para que se ejecute como servicio. El nombre de servicio de SQLdiag es SQLDIAG. Cualquier otro argumento que especifique en la línea de comandos cuando registre SQLDiag como servicio se conservará y se reutilizará cuando se inicie el servicio.

Para cambiar el nombre predeterminado del servicio SQLDIAG, use el argumento de la línea de comandos /A . SQLdiag agrega el prefijo DIAG$ de forma automática a cualquier nombre de instancia de SQLdiag especificado con /A para crear nombres de servicio significativos.

Para eliminar el servicio SQLDIAG del registro

Para eliminar el servicio del Registro, especifique el argumento /U . Si elimina del Registro SQLdiag como servicio, también se eliminan las claves del servicio del Registro de Windows.

Para iniciar o reiniciar el servicio SQLDIAG

Para iniciar o reiniciar el servicio SQLDIAG, ejecute SQLDiag START desde la línea de comandos.

Si ejecuta varias instancias de SQLdiag con el argumento /A , también puede pasar el nombre de instancia de SQLdiag en la línea de comandos cuando inicie el servicio. Por ejemplo, para iniciar una instancia de SQLdiag denominada Instance1, use la siguiente sintaxis:

SQLDIAG START /A Instance1  

También puede usar el comando net start para iniciar el servicio SQLDIAG.

Cuando se reinicia SQLdiag, sobrescribe el contenido de la carpeta de salida actual. Para evitarlo, especifique /N 2 en la línea de comandos para cambiar el nombre de la carpeta de salida cuando se inicie la utilidad.

No se permite pausar el servicio SQLdiag .

Ejecutar varias instancias de SQLdiag

Para ejecutar varias instancias de SQLdiag en el mismo equipo, especifique /ASQLdiag_application_name en la línea de comandos. Resulta útil para recopilar distintos conjuntos de diagnósticos de la misma instancia de SQL Server de forma simultánea. Por ejemplo, puede configurar una instancia con nombre de SQLdiag para que ejecute una recopilación de datos ligera de forma constante. De este modo, si se produce un problema específico en SQL Server, puede ejecutar la instancia predeterminada de SQLdiag para recopilar los diagnósticos relativos a ese problema o para recopilar un conjunto de diagnósticos que los servicios de soporte al cliente de Microsoft le hayan solicitado para diagnosticar un problema.

Recopilar datos de diagnóstico de instancias de SQL Server en clúster

SQLdiag permite recopilar datos de diagnóstico de instancias de SQL Server en clúster. Para recopilar diagnósticos de instancias de SQL Server agrupadas, asegúrese de que se especifica "." para el atributo name del elemento <Machine> en el archivo de configuración SQLDiag.Xml y no especifique el argumento /G en la línea de comandos. De forma predeterminada, se especifica "." para el atributo name del archivo de configuración y se desactiva el argumento /G . Normalmente, cuando se realiza la recopilación desde una instancia de SQL Server en clúster, no es necesario editar el archivo de configuración ni cambiar los argumentos de la línea de comandos.

Si se especifica "." como nombre de equipo, SQLdiag detecta que se está ejecutando en un clúster y recupera simultáneamente la información de diagnóstico de todas las instancias virtuales de SQL Server instaladas en el clúster. Si quiere recopilar información de diagnóstico solo de una de las instancias virtuales de SQL Server que se ejecutan en el equipo, especifique ese SQL Server virtual para el atributo name del elemento <Machine> de SQLDiag.Xml.

Consulte también

Referencia de la utilidad del símbolo del sistema (motor de base de datos)