hpctrace
Esse comando foi introduzido no HPC Pack 2008 R2 e não tem suporte em versões anteriores. A funcionalidade foi adicionada ao HPC Pack 2012 e alterada no HPC Pack 2012 com o Service Pack 1 (SP1).
referência de Hpctrace para HPC Pack 2012 com SP1 (ou posterior)
referência de Hpctrace para HPC Pack 2008 R2 e HPC Pack 2012
Referência de Hpctrace para HPC Pack 2012 com SP1 (ou posterior)
Coleta e extrai as informações nos arquivos de log binário (.bin) gerados pelo HPC Pack, começando pelo HPC Pack 2012 com o Service Pack 1 (SP1).
Observação
Para baixar e gerenciar arquivos de log gerados em nós do Windows Azure, você pode usar o hpcazurelog ferramenta de linha de comando. Em seguida, use o subcomando nesta ferramenta para extrair as informações nos arquivos de log que você baixou.
Sintaxe
hpctrace getlog <provider> [level] [-d:<destination folder>]
hpctrace parselog <BIN file> [level] [-s] [-d:<destination folder>]
hpctrace {/? | /help}
Subcomandos
| Subcomando | Descrição |
|---|---|
| hpctrace getlog | Coleta os arquivos de log binário para o provedor especificado e executa automaticamente o subcomando para extrair suas informações em arquivos de texto. Quando usado com o parâmetro de nível de |
| hpctrace parselog | Extrai as informações de um ou mais arquivos de log binário (.bin) e as grava em um arquivo de texto com valores separados por tabulação, que podem ser importados para uma ferramenta baseada em tabela para análise. O arquivo de saída tem o mesmo nome do arquivo de log binário, com uma extensão .log. Quando usado com o parâmetro de nível de O parâmetro opcional –s processa arquivos binários em todas as subpastas. |
| hpctrace /? | Exibe a Ajuda no prompt de comando. |
| hpctrace /help | Exibe a Ajuda no prompt de comando. |
Parâmetros
| Parâmetro | Descrição |
|---|---|
| > do provedor de < | Especifica o provedor (origem) dos logs. Os provedores disponíveis são: mgmt – Serviço de Gerenciamento de HPC esquema – Serviço de Agendador de Trabalho do HPC sdm – Serviço de Repositório do SDM do HPC diag – Serviço de Diagnóstico de HPC rept – HPC Reporting Service nmgr – Serviço do Gerenciador de Nós do HPC msvr – Serviço de Servidor de Monitoramento de HPC mclt – Serviço de Cliente de Monitoramento de HPC brok – Serviço do HPC Broker sdgm – HPC SOA Diag Mon Service sess – Serviço de Sessão HPC |
| < > de arquivo BIN | Especifica o nome do arquivo de log binário ou arquivos a serem extraídos. Aplica-se somente ao subcomando de de |
| [nível] | Opcionalmente, filtra a saída de log com base na gravidade máxima de cada entrada de log. O nível padrão é 4. Os níveis disponíveis são: 1 – Somente erro e crítico 2 – Somente aviso, erro e crítico 3 – Somente informações, avisos, erros e críticos 4 – Tudo: detalhado, informações, aviso, erro e crítico |
| [-s] | Opcionalmente, extrai arquivos binários em todas as subpastas existentes. Aplica-se somente ao subcomando de |
| [-d:<pasta de destino>] | Opcionalmente, especifica o caminho para a pasta em que o arquivo de texto de saída ou os arquivos devem ser gravados. Se esse parâmetro não for especificado para o getlog subcomando, os arquivos de texto serão gravados na pasta da qual você executou hpctrace. Se esse parâmetro não for especificado para o parselog subcomando, os arquivos de texto serão gravados na mesma pasta em que os arquivos binários são armazenados. |
Exemplos
Para coletar e extrair as informações nos arquivos de log do Serviço de Agendador de Trabalho do HPC e gravar os arquivos de saída na pasta atual:
hpctrace getlog sche
Para coletar e extrair as informações nos arquivos de log do Serviço de Gerenciamento de HPC e gravar os arquivos de saída na pasta C:\Meus Logs:
hpctrace getlog mgmt -d:"C:\My Logs"
Para extrair somente entradas de log de Erro e Crítico no arquivo binário chamado hpcworker_000001.bin na pasta C:\logs e grave o arquivo de saída na mesma pasta:
hpctrace parselog C:\logs\hpcworker_000001.bin 1
Para extrair todos os arquivos binários que começam com "hpc" na pasta atual e em qualquer subpasta existente, e gravar cada arquivo de saída na mesma pasta que seu arquivo binário correspondente:
hpctrace parselog hpc*.bin -s
Referência de Hpctrace para HPC Pack 2008 R2 e HPC Pack 2012
Inicia, interrompe, consulta, coleta e formata os logs de rastreamento baseados em ETW (Rastreamento de Eventos para Windows) gerados pelo Serviço de Gerenciamento de HPC, pelo Serviço de Armazenamento do HPC SDM e pelas ferramentas de gerenciamento de HPC que usam a API de gerenciamento de HPC. No HPC Pack 2012, hpctrace também extrai os arquivos de log binário gerados pelos nós do Windows Azure e pelo Serviço de Servidor de Monitoramento do HPC e pelo Serviço de Cliente de Monitoramento de HPC.
Sintaxe
hpctrace start <provider> [file size]
hpctrace {stop|query} <provider>
hpctrace getlog <provider> <TXT file> [level]
hpctrace fmtlog <ETL file> <TXT file> [level]
hpctrace parselog <BIN file> [-s] [level]
hpctrace {/? | /help}
Subcomandos
| Subcomando | Descrição |
|---|---|
| hpctrace fmtlog | Extrai as informações de um arquivo ETL existente (.etl) e as grava no arquivo de texto especificado (.txt). Quando usado com o parâmetro de nível de |
| hpctrace getlog | Coleta o log de rastreamento do provedor especificado (fonte de rastreamento) e grava-o no arquivo de texto especificado (.txt). Quando usado com o parâmetro de nível de |
| hpctrace parselog | Esse parâmetro foi adicionado ao HPC Pack 2012 e não tem suporte em versões anteriores. Extrai as informações de um ou mais arquivos de log binários (.bin) e as grava em um arquivo de texto (.txt) com valores separados por tabulação, que podem ser importados para uma ferramenta baseada em tabela para análise. O arquivo de saída tem o mesmo nome do arquivo de log binário, com uma extensão de arquivo .log e é armazenado na mesma pasta que o arquivo .bin. Quando usado com o parâmetro de nível de O parâmetro opcional –s processa arquivos binários em todas as subpastas. Esse parâmetro foi introduzido no HPC Pack 2012. Não há suporte para ele em versões anteriores. |
| consulta hpctrace | Exibe informações de sessão para o provedor especificado (origem do rastreamento). |
| início do hpctrace | Inicia uma nova sessão de rastreamento para o provedor especificado (fonte de rastreamento). O arquivo ETL gerado será armazenado em %CCP_DATA%LogFiles. O parâmetro opcional tamanho do arquivo especifica o tamanho máximo do arquivo ETL, em MB. |
| hpctrace stop | Interrompe uma sessão de rastreamento existente para o provedor especificado (origem do rastreamento). Parar e reiniciar uma sessão excluirá o arquivo ETL atual (.etl) para o provedor. Se você quiser manter o conteúdo de uma sessão anterior, antes de reiniciar a sessão, copie o arquivo ETL para um local seguro ou use o parâmetro getlog para gravá-lo em um arquivo de texto. Os arquivos ETL são armazenados em %CCP_DATA%LogFiles. |
| hpctrace /? | Exibe a Ajuda no prompt de comando. |
| hpctrace /help | Exibe a Ajuda no prompt de comando. |
Parâmetros
| Parâmetro | Descrição |
|---|---|
| < > de arquivo BIN | Especifica o nome do arquivo de log binário ou arquivos a serem extraídos. Aplica-se somente ao subcomando de de |
| < > de arquivo ETL | Especifica o nome do arquivo ETL a ser extraído. Aplica-se somente ao subcomando de de fmtlog |
| [tamanho do arquivo] | Opcionalmente, especifica o tamanho máximo do arquivo ETL, em MB. Aplica-se somente ao subcomando iniciar |
| [nível] | Opcionalmente, filtra a saída de log com base na gravidade máxima de cada entrada de log. Aplica-se aode 1 – Somente crítico 2 – Erro e crítico 3 – Aviso, erro e crítico 4 – Informações, Aviso, Erro e Crítico 5 – Tudo: detalhado, informações, aviso, erro e crítico |
| > do provedor de < | Especifica o provedor (origem) dos logs de rastreamento. Aplica-se somente aos subcomandos de de consulta mgmt – Serviço de Gerenciamento de HPC sdm – Serviço de Repositório do SDM do HPC mapi – API de gerenciamento de HPC (usada para especificar o rastreamento de sessões do HPC PowerShell e do HPC Cluster Manager. Apenas uma sessão de rastreamento é necessária para todos os processos da API de gerenciamento de HPC.) |
| [-s] | Opcionalmente, extrai arquivos binários em todas as subpastas existentes. Aplica-se somente ao subcomando de |
| < > de arquivo TXT | Especifica o nome do arquivo de texto de saída. Aplica-se somente aos subcomandos de de de de |
Exemplos
Para recuperar o arquivo de log hpctrace chamado mgmttxt que contém aviso, erro e mensagens críticas, use o seguinte comando:
hpctrace getlog mgmt mgmttxt 3
Para interromper uma sessão de rastreamento para o Serviço de Gerenciamento de HPC e reiniciá-la com um tamanho máximo de arquivo de 100 MB:
hpctrace stop mgmthpctrace start mgmt 100
Para extrair apenas o arquivo binário chamado HpcLog_01.bin, na pasta C:\logs:
hpctrace parselog C:\logs\HpcLog_01.bin
Para extrair todos os arquivos binários que começam com "HpcLog_0", seguidos por um número, na pasta atual (por exemplo, HpcLog_00.bin, HpcLog_01.bin, HpcLog_02.bin e assim por diante):
hpctrace parselog HpcLog_0?.bin
Para extrair todos os arquivos binários na pasta atual e em todas as subpastas existentes:
hpctrace parselog *.bin -s