Utilitário SQLdiag

Aplica-se a:SQL Server

O utilitário SQLdiag é um utilitário de coleta de diagnósticos de uso geral que pode ser executado como um aplicativo de console ou como um serviço. Você pode usar o SQLdiag para coletar logs e arquivos de dados do SQL Server e de outros tipos de servidores e usá-lo para monitorar seus servidores ao longo do tempo ou solucionar problemas específicos com seus servidores. O SQLdiag destina-se a agilizar e simplificar a coleta de informações de diagnóstico para os Serviços de Atendimento ao Cliente da Microsoft.

O SQLdiag pode coletar os seguintes tipos de informações de diagnóstico:

• Logs de desempenho do Windows
• Registos de eventos do Windows
• Rastreamentos do SQL Server Profiler
• Informações de bloqueio do SQL Server
• Informações de configuração do SQL Server

Você pode especificar quais tipos de informações deseja que o SQLdiag colete editando o arquivo SQLdiag.xmlde configuração , que é descrito em uma seção a seguir.

Sintaxe

sqldiag
    { [ /? ] }
    |
    {
      [ /I configuration_file ]
      [ /O output_folder_path ]
      [ /P support_folder_path ]
      [ /N output_folder_management_option ]
      [ /M machine1 [ machine2 machineN ] | @machinelistfile ]
      [ /C file_compression_type ]
      [ /B [+]start_time ]
      [ /E [+]stop_time ]
      [ /A SQLdiag_application_name ]
      [ /T { tcp [ ,port ] | np | lpc } ]
      [ /Q ] [ /G ] [ /R ] [ /U ] [ /L ] [ /X ]
    }
    |
    { [ START | STOP | STOP_ABORT ] }
    |
    { [ START | STOP | STOP_ABORT ] /A SQLdiag_application_name }

Argumentos

/?

Exibe informações de uso.

/I ficheiro_de_configuração

Define o arquivo de configuração para o SQLdiag usar. Por padrão, /I é definido como SQLdiag.xml.

/O output_folder_path

Redireciona a saída do SQLdiag para a pasta especificada. Se a opção /O não for especificada, a saída do SQLdiag será gravada num subdiretório chamado SQLDIAG no diretório de inicialização do SQLdiag. Se a pasta não existir, o SQLDIAGSQLdiag tentará criá-la.

/P support_folder_path

Define o caminho da pasta de suporte. Por padrão, /P é definido como a pasta onde reside o executável do SQLdiag . A pasta de suporte contém arquivos de suporte do SQLdiag , como o arquivo de configuração XML, scripts de Transact-SQL e outros arquivos que o utilitário usa durante a coleta de diagnóstico. Se você usar essa opção para especificar um caminho alternativo de arquivos de suporte, o SQLdiag copiará automaticamente os arquivos de suporte necessários para a pasta especificada, caso ainda não existam.

Para definir sua pasta atual como o caminho de suporte, especifique %cd% na linha de comando da seguinte maneira:

sqldiag /P %cd%

/N opção_de_gestão_da_pasta_de_resultado

Define se o SQLdiag substitui ou renomeia a pasta de saída quando ela é iniciada. Opções disponíveis:

• 1 = Substitui a pasta de saída (padrão)
• 2 = Quando o SQLdiag é iniciado, ele renomeia a pasta de saída para SQLDIAG_00001, SQLDIAG_00002e assim por diante. Depois de renomear a pasta de saída atual, o SQLdiag grava a saída na pasta SQLDIAGde saída padrão.

O SQLdiag não acrescenta saída à pasta de saída atual quando é iniciado. Ele só pode substituir a pasta de saída padrão (opção 1) ou renomear a pasta (opção 2) e, em seguida, grava a saída na nova pasta de saída padrão chamada SQLDIAG.

/M máquina1 [ máquina2máquinaN ] | @machinelistfile

Substitui as máquinas especificadas no ficheiro de configuração. Por padrão, o arquivo de configuração é SQLdiag.xml, ou é definido com o /I parâmetro. Ao especificar mais de uma máquina, separe cada nome de máquina com um espaço.

A opção @machinelistfile especifica um nome de arquivo de lista de máquinas a ser armazenado no arquivo de configuração.

/C file_compression_type

Define o tipo de compactação de arquivo usado nos arquivos de pasta de saída do SQLdiag . Opções disponíveis:

• 0 = none (padrão)
• 1 = usa compressão NTFS

/B [+]start_time

Especifica a data e a hora para iniciar a coleta de dados de diagnóstico no seguinte formato: yyyyMMdd_HH:mm:ss

O tempo é especificado usando notação de 24 horas. Por exemplo, 2:00 P.M. deve ser especificado como 14:00:00.

Use + sem a data (somente HH:mm:ss) para especificar uma hora relativa à data e hora atuais. Por exemplo, se você especificar /B +02:00:00, o SQLdiag aguardará 2 horas antes de começar a coletar informações.

Não insira um espaço entre + e o start_time especificado.

Se você especificar uma hora de início que está no passado, o SQLdiag alterará forçosamente a data de início para que a data e a hora de início estejam no futuro. Por exemplo, se você especificar /B 01:00:00 e a hora atual for 08:00:00, o SQLdiag alterará forçosamente a data de início para que a data de início seja o dia seguinte.

O SQLdiag usa a hora local no computador onde o utilitário está sendo executado.

/E [+]stop_time

Especifica a data e a hora para interromper a coleta de dados de diagnóstico no seguinte formato: yyyyMMdd_HH:mm:ss

O tempo é especificado usando notação de 24 horas. Por exemplo, 2:00 P.M. deve ser especificado como 14:00:00.

Use + sem a data (somente HH:mm:ss) para especificar uma hora relativa à data e hora de início . Por exemplo, se você especificar uma hora de início e uma hora de término usando /B +02:00:00 /E +03:00:00o , o SQLdiag aguardará 2 horas antes de começar a coletar informações e, em seguida, coletará informações por 3 horas antes de parar e sair. Se /B não for especificado, o SQLdiag começará a coletar diagnósticos imediatamente e terminará na data e hora especificadas pelo /E.

Não insira um espaço entre + e a start_time ou end_time especificada.

O SQLdiag usa a hora local no computador onde o utilitário está sendo executado.

/A SQLdiag_application_name

Permite executar várias instâncias do utilitário SQLdiag na mesma instância do SQL Server.

Cada SQLdiag_application_name identifica uma instância diferente do SQLdiag. Não existe nenhuma relação entre uma instância SQLdiag_application_name e um nome de instância do SQL Server.

SQLdiag_application_name pode ser usado para iniciar ou parar uma instância específica do serviço SQLdiag .

Neste exemplo, substitua <SQLdiag_application_name> pelo valor apropriado para SQLdiag_application_name:

sqldiag START /A <SQLdiag_application_name>

Ele também pode ser usado com a /R opção de registrar uma instância específica do SQLdiag como um serviço. Neste exemplo, substitua <SQLdiag_application_name> pelo valor apropriado para SQLdiag_application_name:

sqldiag /R /A <SQLdiag_application_name>

Protocolo

Conecta-se a uma instância do SQL Server usando um dos seguintes valores de protocolo.

/Q

Executa o SQLdiag em modo quieto. /Q suprime todos os pedidos, como os de senha.

/G

Executa SQLdiag no modo genérico. Quando /G é especificado, no arranque, o SQLdiag não efetua verificações de conectividade ao SQL Server nem verifica se o utilizador é membro da função fixa de servidor sysadmin. Em vez disso, o SQLdiag delega ao Windows determinar se um utilizador tem os direitos apropriados para coletar cada diagnóstico solicitado.

Se /G não for especificado, o SQLdiag verificará se o usuário é membro do grupo Administradores do Windows e não coletará diagnósticos do SQL Server se o usuário não for membro do grupo Administradores .

/R

Registra o SQLdiag como um serviço. Todos os argumentos de linha de comando especificados quando você registra o SQLdiag como um serviço são preservados para futuras execuções do serviço.

Quando o SQLdiag é registrado como um serviço, o nome de serviço padrão é SQLDIAG. Você pode alterar o nome do serviço usando o /A argumento.

Utilize o argumento START da linha de comando para iniciar o serviço.

sqldiag START

Você também pode usar o net start comando para iniciar o serviço:

net start SQLDIAG

/U

Cancela o registro do SQLdiag como um serviço.

Use o /A argumento também se cancelar o registro de uma instância nomeada do SQLdiag .

/L

Executa o SQLdiag no modo contínuo quando uma hora de início ou uma hora de término é especificada com os argumentos /B ou /E, respectivamente. O SQLdiag é reiniciado automaticamente após a interrupção da coleta de diagnósticos devido a um desligamento agendado. Por exemplo, usando o /E ou os /X argumentos.

O uso /L não implica o modo de serviço. Para usar /L ao executar o SQLdiag como um serviço, especifique-o na linha de comando ao registrar o serviço.

/X

Executa SQLdiag no modo de instantâneo. O SQLdiag tira um instantâneo de todos os diagnósticos configurados e, em seguida, desliga-se automaticamente.

INÍCIO | PARAGEM | STOP_ABORT

Inicia ou para o serviço SQLdiag . STOP_ABORT força o serviço a desligar o mais rápido possível sem concluir a recolha de diagnósticos que está a ser realizada no momento.

Quando esses argumentos de controle de serviço são usados, eles devem ser o primeiro argumento usado na linha de comando. Por exemplo:

sqldiag START

Somente o /A argumento, que especifica uma instância nomeada do SQLdiag, pode ser usado com START, STOPou STOP_ABORT para controlar uma instância específica do serviço SQLdiag . Neste exemplo, substitua <SQLdiag_application_name> pelo valor apropriado para SQLdiag_application_name:

sqldiag START /A <SQLdiag_application_name>

Requisitos de segurança

A menos que o SQLdiag seja executado no modo genérico (especificando o /G argumento da linha de comando), o usuário que executa o SQLdiag deve ser membro do grupo Administradores do Windows e membro da função de servidor fixa sysadmin do SQL Server. Por padrão, o SQLdiag se conecta ao SQL Server usando a Autenticação do Windows, mas também dá suporte à Autenticação do SQL Server.

Considerações sobre desempenho

Os efeitos de desempenho da execução do SQLdiag dependem do tipo de dados de diagnóstico que você configurou para coletar. Por exemplo, se você configurou o SQLdiag para coletar informações de rastreamento do SQL Server Profiler, quanto mais classes de evento você optar por rastrear, mais o desempenho do servidor será afetado.

O impacto no desempenho da execução do SQLdiag é aproximadamente equivalente à soma dos custos de coleta dos diagnósticos configurados separadamente. Por exemplo, coletar um rastreamento com o SQLdiag incorre no mesmo custo de desempenho que coletá-lo com o SQL Server Profiler. O impacto no desempenho do uso do SQLdiag é insignificante.

Espaço em disco necessário

Como o SQLdiag pode coletar diferentes tipos de informações de diagnóstico, o espaço livre em disco necessário para executar o SQLdiag varia. A quantidade de informações de diagnóstico coletadas depende da natureza e do volume da carga de trabalho que o servidor está processando e pode variar de alguns megabytes a vários gigabytes.

Arquivos de configuração

Na inicialização, o SQLdiag lê o arquivo de configuração e os argumentos de linha de comando que foram especificados. Você especifica os tipos de informações de diagnóstico que o SQLdiag coleta no arquivo de configuração. Por padrão, o SQLdiag usa o arquivo de configuração, que é extraído SQLdiag.xml sempre que a ferramenta é executada e está localizado na pasta de inicialização do utilitário SQLdiag . O arquivo de configuração usa o esquema XML, SQLDiag_schema.xsd, que também é extraído do arquivo executável para o diretório de inicialização do utilitário sempre que o SQLdiag é executado.

Editar os arquivos de configuração

Você pode copiar e editar SQLdiag.xml para alterar os tipos de dados de diagnóstico que o SQLdiag coleta. Ao editar o arquivo de configuração, use sempre um editor XML que possa validar o arquivo de configuração em relação ao seu esquema XML, como o Management Studio. Você não deve editar SQLdiag.xml diretamente. Em vez disso, faça uma cópia e renomeie-a para um novo nome de SQLdiag.xml arquivo na mesma pasta. Em seguida, edite o novo arquivo e use o /I argumento para passá-lo para o SQLdiag.

Editar o arquivo de configuração quando o SQLdiag é executado como um serviço

Se você já tiver executado o SQLdiag como um serviço e precisar editar o arquivo de configuração, cancele o registro do SQLDIAG serviço especificando o argumento da linha de /U comando e, em seguida, registre novamente o serviço usando o argumento da linha de /R comando. Cancelar o registro e registrar novamente o serviço remove informações de configuração antigas que foram armazenadas em cache no registro do Windows.

Pasta de saída

Caso não especifiques uma pasta de saída com o argumento /O, SQLdiag criará uma subpasta denominada SQLDIAG na pasta de inicialização SQLdiag. Para a coleta de informações de diagnóstico que envolve rastreamento de alto volume, como o SQL Server Profiler, verifique se a pasta de saída está em uma unidade local com espaço suficiente para armazenar a saída de diagnóstico solicitada.

Quando o SQLdiag é reiniciado, ele substitui o conteúdo da pasta de saída. Para evitar isso, especifique /N 2 na linha de comando.

Processo de recolha de dados

Quando o SQLdiag é iniciado, ele executa as verificações de inicialização necessárias para coletar os dados de diagnóstico especificados no SQLdiag.xml. Este processo pode demorar vários segundos. Depois que o SQLdiag começar a coletar dados de diagnóstico quando ele é executado como um aplicativo de console, uma mensagem será exibida informando que a coleção do SQLdiag foi iniciada e que você pode pressionar CTRL+C para pará-la. Quando o SQLdiag é executado como um serviço, uma mensagem semelhante é gravada no log de eventos do Windows.

Se estiver a utilizar o SQLdiag para diagnosticar um problema que possa reproduzir, aguarde até receber esta mensagem antes de reproduzir o problema no servidor.

O SQLdiag coleta a maioria dos dados de diagnóstico em paralelo. Todas as informações de diagnóstico são coletadas conectando-se a ferramentas, como o utilitário sqlcmd do SQL Server ou o processador de comandos do Windows, exceto quando as informações são coletadas de logs de desempenho e logs de eventos do Windows. O SQLdiag usa uma linha de trabalho por computador para monitorizar a recolha de dados de diagnóstico dessas outras ferramentas, muitas vezes aguardando simultaneamente a conclusão de várias ferramentas. Durante o processo de recolha, o SQLdiag redireciona a saída de cada diagnóstico para a pasta de saída.

Parar a recolha de dados

Depois que o SQLdiag começa a coletar dados de diagnóstico, ele continua a fazê-lo, a menos que você o interrompa manualmente por meio do Ctrl+C, crie um sqldiag.stop arquivo ou o configure para parar em um momento especificado. Pode configurar o SQLdiag para parar num tempo específico utilizando o argumento /E, ou utilizando o argumento /X, que faz o SQLdiag executar no modo de instantâneo.

Quando o SQLdiag para, ele interrompe todos os diagnósticos iniciados. Por exemplo, ele interrompe os rastreamentos do SQL Server Profiler que estava a coletar, interrompe a execução de scripts Transact-SQL que estava a executar e interrompe todos os subprocessos criados durante a recolha de dados. Após a conclusão da coleta de dados de diagnóstico, o SQLdiag é encerrado.

Pare o SQLdiag ao executar como um aplicativo de console

Se você estiver executando o SQLdiag como um aplicativo de console, pressione CTRL+C na janela do console onde o SQLdiag está sendo executado para pará-lo. Depois de pressionar CTRL+C, uma mensagem é exibida na janela do console informando que a coleta de dados do SQLdiag está terminando e que você deve esperar até que o processo seja encerrado, o que pode levar vários minutos.

Pressione Ctrl+C duas vezes para encerrar todos os processos de diagnóstico filho e encerrar imediatamente o aplicativo.

Parar o SQLdiag ao executar como um serviço

Se você estiver executando o SQLdiag como um serviço, execute sqldiag STOP na pasta de inicialização do SQLdiag para pará-lo. Ou, você pode parar os serviços SQLdiag no miniaplicativo Services.msc .

Se você estiver executando várias instâncias do SQLdiag no mesmo computador, também poderá passar o nome da instância do SQLdiag para na linha de comando quando parar o serviço. Por exemplo, para parar uma instância do SQLdiag chamada Instance1, use a seguinte sintaxe:

sqldiag STOP /A Instance1

/A é o único argumento de linha de comando que pode ser usado com START, STOP, ou STOP_ABORT. Se você precisar especificar uma instância nomeada do SQLdiag com um dos verbos de controle de serviço, especifique /A após o verbo de controle na linha de comando, conforme mostrado no exemplo de sintaxe anterior. Quando verbos de controle são usados, eles devem ser o primeiro argumento na linha de comando.

Para parar o serviço o mais rápido possível, execute sqldiag STOP_ABORT na pasta de inicialização do utilitário. Este comando anula qualquer recolha de diagnósticos que esteja a ser realizada no momento sem esperar pela sua conclusão.

Pare o SQLdiag usando o arquivo sqldiag.stop

O SQLdiag também é desligado automaticamente quando encontra um arquivo nomeado sqldiag.stop na pasta do \Output utilitário. Essa opção se aplica independentemente se o SQLdiag for executado como um aplicativo de console ou como um serviço. Criar um .stop arquivo pode ser útil quando você deseja desligar programaticamente o SQLdiag depois que algum evento ocorre, mas você não sabe com antecedência a hora em que esse evento ocorre. O conteúdo do sqldiag.stop ficheiro é irrelevante. Uma opção, além de criar manualmente o arquivo, é usar um comando como o seguinte em um arquivo em lote para criar sqldiag.stop:

ECHO stop > F:\PSSDIAG\Output\sqldiag.stop

Outra opção é usar o PowerShell:

Set-Content -Value "stop" -Path "F:\PSSDIAG\Output\sqldiag.stop"

Iniciar e parar automaticamente o SQLdiag

Para iniciar e parar automaticamente a recolha de dados de diagnóstico numa hora especificada, use os argumentos /B <start_time> e /E <stop_time>, utilizando a notação de 24 horas. Por exemplo, se você estiver solucionando um problema que aparece consistentemente em aproximadamente 02:00:00, poderá configurar o SQLdiag para iniciar automaticamente a coleta de dados de diagnóstico às 01:45 e parar automaticamente às 03:00:00.

Use os /B argumentos e /E para especificar a hora de início e de parada. Use a notação de 24 horas para especificar uma data e hora exatas de início e parada com o formato geral yyyyMMdd_HH:mm:ss. O exemplo a seguir inicia a coleta de dados às 01:45 e a interrompe às 3:00.

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

Para especificar uma hora relativa de início ou parada, prefixe a hora de início e de parada com + e omita a parte de data (yyyyMMdd_), conforme mostrado no exemplo a seguir. Isso faz com que o SQLdiag aguarde uma hora antes de começar a coletar informações e, em seguida, coleta informações por duas horas e meia antes de parar e sair:

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

Quando um start_time relativo é especificado, o SQLdiag é iniciado em um horário relativo à data e hora atuais. Quando um end_time relativo é especificado, o SQLdiag termina em um momento relativo ao start_time especificado. Se a data e hora de início ou término que você especificou estiver no passado, o SQLdiag alterará forçosamente a data de início para que a data e a hora de início estejam no futuro.

Isso tem implicações importantes nas datas de início e término que você escolher. Considere o seguinte exemplo:

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

Se a hora atual for 08:00, a hora final já terá passado antes que a recolha do diagnóstico realmente comece. Como o SQLdiag ajusta automaticamente as datas de início e término para o dia seguinte quando elas ocorrem no passado, neste exemplo a coleta de diagnóstico começa às 09:00 de hoje (uma hora de início relativa foi especificada em 1 hora a partir de agora usando +) e continua coletando até as 08:30 da manhã seguinte.

Pare e reinicie o SQLdiag para coletar diagnósticos diários

Para coletar um conjunto especificado de diagnósticos diariamente sem ter que iniciar e parar manualmente o SQLdiag, use o /L argumento. O /L argumento faz com que o SQLdiag seja executado continuamente, reiniciando-se automaticamente após um desligamento agendado. Quando /L é especificado e SQLdiag para por ter atingido a hora de término definida com o argumento /E, ou por estar a ser executado no modo instantâneo por usar o argumento /X, SQLdiag reinicia em vez de terminar.

O exemplo a seguir especifica que o SQLdiag seja executado em modo contínuo para reiniciar automaticamente após a coleta de dados de diagnóstico ocorrer entre 03:00:00 e 05:00:00.

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

O exemplo a seguir especifica que o SQLdiag seja executado em modo contínuo para reiniciar automaticamente depois de tirar um instantâneo de dados de diagnóstico às 03:00:00.

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

Executar o SQLdiag como um serviço

Quando você deseja usar o SQLdiag para coletar dados de diagnóstico por longos períodos de tempo durante os quais talvez seja necessário sair do computador no qual o SQLdiag está sendo executado, você pode executá-lo como um serviço.

Registrar o SQLdiag para executar como um serviço

Você pode registrar o SQLdiag para ser executado como um serviço especificando o /R argumento na linha de comando. Isso registra o SQLdiag para ser executado como um serviço. O nome do serviço SQLdiag é SQLDIAG. Quaisquer outros argumentos especificados na linha de comando ao registrar o SQLdiag como um serviço são preservados e reutilizados quando o serviço é iniciado.

Para alterar o nome do serviço padrão SQLDIAG , use o argumento de linha de /A comando para especificar outro nome. O SQLdiag prefixa automaticamente DIAG$ para qualquer nome de instância do SQLdiag especificado com /A para criar nomes de serviço sensíveis.

Cancelar o registro do serviço SQLDIAG

Para cancelar o registro do serviço, especifique o /U argumento. Cancelar o registro do SQLdiag como um serviço também exclui as chaves do Registro do Windows do serviço.

Iniciar ou reiniciar o serviço SQLDIAG

Para iniciar ou reiniciar o SQLDIAG serviço, execute sqldiag START a partir da linha de comando.

Se você estiver executando várias instâncias do SQLdiag usando o /A argumento, também poderá passar o nome da instância do SQLdiag na linha de comando ao iniciar o serviço. Por exemplo, para iniciar uma instância do SQLdiag chamada Instance1, use a seguinte sintaxe:

sqldiag START /A Instance1

Você também pode usar o net start comando para iniciar o SQLDIAG serviço.

Quando você reinicia o SQLdiag, ele substitui o conteúdo na pasta de saída atual. Para evitar isso, especifique /N 2 na linha de comando para renomear a pasta de saída quando o utilitário for iniciado.

Não há suporte para pausar o serviço SQLdiag .

Executar várias instâncias do SQLdiag

Execute várias instâncias do SQLdiag no mesmo computador especificando /A <SQLdiag_application_name> na linha de comando. Isso é útil para coletar diferentes conjuntos de diagnósticos simultaneamente da mesma instância do SQL Server. Por exemplo, você pode configurar uma instância nomeada do SQLdiag para executar continuamente a coleta de dados leve. Em seguida, se ocorrer um problema específico no SQL Server, você poderá executar a instância padrão do SQLdiag para coletar diagnósticos para esse problema ou para coletar um conjunto de diagnósticos que os Serviços de Atendimento ao Cliente da Microsoft solicitam que você reúna para diagnosticar um problema.

Coletar dados de diagnóstico de instâncias clusterizadas do SQL Server

O SQLdiag oferece suporte à coleta de dados de diagnóstico de instâncias clusterizadas do SQL Server. Para recolher diagnósticos de instâncias clusterizadas do SQL Server, certifique-se de que "." está especificado para o atributo name do elemento <Machine> no ficheiro de configuração SQLdiag.xml e não especifique o argumento /G na linha de comando. Por padrão, "." é especificado para o name atributo no arquivo de configuração e o /G argumento é desativado. Normalmente, você não precisa editar o arquivo de configuração ou alterar os argumentos de linha de comando ao coletar de uma instância clusterizada do SQL Server.

Quando "." especificado como o nome da máquina, o SQLdiag deteta que está sendo executado em um cluster e, simultaneamente, recupera informações de diagnóstico de todas as instâncias virtuais do SQL Server instaladas no cluster. Se pretender coletar informações de diagnóstico de apenas uma instância virtual do SQL Server que está em execução num computador, especifique essa instância virtual do SQL Server para o atributo do elemento name em <Machine>.

Conteúdo relacionado

• Utilitários de linha de comando SQL (Mecanismo de Banco de Dados)