Exibir os logs de ULS para entradas de trabalho da fila

  • Artigo

 

Tópico modificado em: 2015-02-27

É possível usar os logs do Serviço de Log Unificado (ULS) para solucionar problemas de fila no Microsoft Office Project Server 2007. As informações de entrada em fila em logs ULS são especialmente úteis em conjunto com as informações da página Gerenciar Fila do Project Web Access, ou com Visualizar Eventos do Windows Server.

Este artigo descreve:

  • Como definir as configurações de arquivo de log ULS

  • Como configurar o Microsoft Office Excel 2007 para exibir arquivos de log ULS

  • Como pesquisar trabalhos de filas específicas nos logs ULS

  • Tipos de entradas de trabalhos de fila nos logs ULS

  • Parâmetros de entrada em fila

  • Práticas recomendadas para solucionar problemas de fila

Definindo as configurações de arquivo de log ULS

É possível definir as configurações de arquivo de log ULS usando o site da Administração Central do SharePoint. Nesta página, você pode:

  • Especificar um local padrão para armazenar arquivos de log.

  • Especificar o número máximo de arquivos de log a serem armazenados no servidor.

  • Especificar a duração de tempo (em minutos) que cada arquivo de log cobre.

NoteObservação:
As configurações de arquivo de log se aplicam a todos os servidores no farm.

Definir as configurações de arquivo de log ULS

  1. Na Administração Central, clique em Operações. Na seção Log e Relatório, clique em Log de diagnóstico.

  2. Na página Log de Diagnóstico, na seção Log de Rastreamento, verifique o local especificado no campo Caminho. O local padrão é C:\Program Files\Common Files\Microsoft Shared\Web server extensions\12\LOGS. Para alterar o local, digite um novo local no campo Caminho.

  3. No campo Número de Arquivos de Log , especifique o número máximo de arquivos de log salvos em cada servidor do farm. O valor padrão é 96.

  4. No campo Número de minutos para usar um arquivo de log, digite a duração (em minutos) de cada arquivo de log. O valor padrão é 30.

  5. Clique em OK.

Novos arquivos de log serão nomeados no seguinte formato: nomedoservidor-ano/mês/dia-hora.log

Por exemplo: um arquivo de log criado em 8 de junho de 2008 às 13h20 em um servidor chamado "Contoso" receberia o nome contoso-20080608-1320.log. Se o campo Número de minutos para usar um arquivo de log for definido como 30, os seguintes arquivos serão criados: contoso-20080608-1320.log contoso-20080608-1350.log, contoso-20080608-1420.log, contoso-20080608-1450.log e assim por diante.

Configurando o Office Excel 2007 para exibir os arquivos de log ULS

Os arquivos de log podem ser facilmente exibidos na maioria dos editores de texto e no Microsoft Office Excel. O Excel permite que os arquivos de log sejam classificados por coluna e também oferece melhor legibilidade (especialmente para linhas que contêm cadeias de caracteres de dados longas).

Configurar o Office Excel 2007 para exibir arquivos do log de rastreamento

  1. No Office Excel 2007, clique no botão Office e clique em Abrir.

  2. Na caixa de diálogo Abrir, procure o local dos arquivos de log.

  3. Na lista Arquivos do Tipo (localizada à direita do campo Nome do arquivo), selecione Todos os Arquivos (*.*) para que você possa ver os arquivos de log.

    NoteObservação:
    Para organizar a lista de arquivos por data, clique com o botão direito do mouse em uma área aberta da lista, clique em Classificar por e clique em Data da Modificação.

  4. Na lista de arquivos, selecione o arquivo de log que deseja exibir.

  5. Uma vez exibido o arquivo de log, na guia Página Inicial, clique em Classificar e Filtrar e clique em Filtrar. Isso permitirá filtrar todas as linhas segundo critérios específicos. Por exemplo: para exibir somente entradas do Project Server, clique no menu Filtrar na coluna Área e desmarque todas as opções, exceto Project Server.

  6. Selecione a coluna Mensagem. Na guia Página Inicial, clique em Formatar e clique em Formatar Células. Na página Formatar Células, clique em Alinhamento, e na seção Controle de Texto selecione Quebrar texto automaticamente. Clique em OK. Os dados da mensagem podem ficar muito extensos, por isso configure a coluna para quebrar o texto e facilitar a exibição dos dados.

Pesquisando trabalhos em filas específicas

Para procurar uma entrada específica de um arquivo de log, use a página Gerenciar Trabalhos na Fila do Project Web Access em conjunto com os logs ULS.

Cada trabalho na fila possui uma Identificação do Grupo de Trabalho. Use esses dados para pesquisar um arquivo de log. Para começar, adicione a coluna Identificação do Grupo de Trabalho à sua Grade de Trabalhos. Em seguida, você poderá verificar um valor específico no arquivo de log ULS.

Adicionar a coluna Identificação do Grupo de Trabalho à Grade de Trabalho

  1. Na página Configurações do Servidor no Project Web Access, na seção Fila, clique em Gerenciar Fila.

  2. Na página Gerenciar Trabalhos da Fila, clique em Colunas.

  3. Na lista Colunas Disponíveis, selecione Identificação do Grupo de Trabalho. Clique em Adicionar para mover a Identificação do Grupo de Trabalho para a lista Colunas Selecionadas.

  4. Na barra de ferramentas da Grade de Trabalho, clique emAtualizar Status e verifique se a coluna foi adicionada.

Após adicionar a coluna Identificação do Grupo de Trabalho, você pode comparar as entradas de fila de trabalho nos logs ULS ao valor de Identificação do Grupo de Trabalho exibido para o trabalho na página Gerenciar Trabalhos da Fila. Por exemplo: na Grade de Trabalho da página Gerenciar Trabalhos da Fila, digamos que você notou que um trabalho de publicação de projeto falhou às 13h22 em 8 de junho de 2008. Com base no momento da falha, você sabe que poderá encontrar o arquivo de log correto que contém as informações sobre a falha. Por exemplo, contoso-20080608-1320log conterá as informações sobre a falha se asdurações de arquivos de log (número de minutos para usar um parâmetro de arquivo de log) estiverem definidas como 30 minutos, porque o intervalo será de 13h20 às 13h50.

Após abrir o arquivo de log, você pode pesquisar todas as entradas referentes ao trabalho da fila específico usando os filtros de coluna. Por exemplo: a coluna Correlações permite filtrar com base na Identificação do Grupo de Trabalho. Também é possível restringir a pesquisa filtrando a coluna Carimbo de data/hora (com base no horário da falha), a coluna Área (filtrar por "Project Server") ou a coluna Categoria ("filtrar por "Fila do Project Server").

Exibindo os componentes de entrada de fila

Ao exibir os logs ULS para ver entradas de fila, note que eles podem ser divididos em dois tipos de funções:

  • Trabalhos enviados à fila: o trabalho está sendo enviado do Project Server para a fila para ser processado.

  • Trabalhos selecionados para processamento: depois que o trabalho é enviado com êxito para a fila, um thread de trabalho da fila tenta processar o trabalho.

Trabalhos enviados à fila

Depois que o trabalho é enviado com êxito para a fila, você geralmente vê três tipos de entradas no log ULS do trabalho da fila:

  • Uma entrada de início de grupo de mensagens

  • Entradas que estão enviando dados relativos ao trabalho para a fila

  • Uma entrada de fim de grupo de mensagens

Entrada de início de grupo de mensagens: a entrada inicial do log ULS de um trabalho da fila é uma marca que significa o início do trabalho. Ela diz à fila que dados adicionais referentes ao trabalho serão enviados posteriormente. Veja abaixo um exemplo de entrada de trabalho de fila de início de grupo de mensagens:

05/13/2008 11:24:09.05 w3wp.exe(0x0E38) 0x0160 ProjectServer ProjectServerQueue 8the Medium PWA:hppt://contoso/PWA, SSP:SharedService1, User:Contoso\EvaCorets, PSI: Project.QueueCreateProjectAndCheckOut [QUEUE][SENDER] ProjectQ: BeginMessageGroup(95e48e6e-71ad-4a6b-b997-86693cac4f66,41398775-d4a6-4c10-a523-4d0251d192c1,ProjectCreate,StandardPriority): JobUID: 6c2c97af-06b4-4038-8ee8-d83de92e59a9 ca5ca0b6-1dce-4d76-aefb-fec966aa8fe1

Entradas que estão enviando dados relativos ao trabalho para a fila: depois que a entrada de início de grupo de mensagens é enviada pelo trabalho da fila, você pode ver algumas entradas referentes ao trabalho enviadas à fila. É possível acompanhar a sequência dessas entradas por meio do valor de parâmetro da Identificação. Essas entradas podem ocorrer sequencialmente no log ou serem dispersas durante um período de tempo, misturadas a outras entradas de log. Use esse número de UID de Grupo do trabalho para acompanhar entradas do trabalho no arquivo de log. Neste momento, o trabalho está no estado "entrando em fila". Veja abaixo um exemplo de entrada referente ao trabalho:

05/13/2008 11:24:09.07 w3wp.exe (0x0E38) 0x0160 ProjectServer ProjectServerQueue 8thf Medium PWA:http://contoso/PWA, SSP:SharedServices1, User:Contoso\EvaCorets, PSI: Project.QueueCreateProjectAndCheckOut  [QUEUE][SENDER] ProjectQ: Send( Microsoft.Office.Project.Server.BusinessLayer.QueueMsg.ProjectAddToMessage ): ID: 1 GroupUID: 95e48e6e-71ad-4a6b-b997-86693cac4f66  ca5ca0b6-1dce-4d76-aefb-fec966aa8fe1

Entrada de fim de grupo de mensagens: depois que a fila recebe todos os dados do trabalho, uma entrada de fim de grupo de mensagens é enviada à fila. Até que essa entrada seja recebida, o trabalho da fila fica no estado "Colocando em Fila". Se a entrada de fim de grupo de mensagens for recebida com êxito, o trabalho muda para "Aguardando Processamento". Veja abaixo um exemplo de entrada de fim de grupo de mensagens:

05/13/2008 11:24:09.09 w3wp.exe(0x0E38) 0x0160 ProjectServer ProjectServerQueue 8the Medium PWA:hppt://contoso/PWA, SSP:SharedService1, User:Contoso\EvaCorets, PSI: Project.QueueCreateProjectAndCheckOut [QUEUE][SENDER] ProjectQ: EndMessageGroup(): GroupUID: 6c2c97af-06b4-4038-8ee8-d83de92e59a9 ca5ca0b6-1dce-4d76-aefb-fec966aa8fe1

Trabalhos selecionados para processamento

Depois que o trabalho é enviado com êxito para a fila, ele é finalmente selecionado para processamento pelos threads de trabalho. Dois tipos de trabalho são associados:

  • Entrada de início de grupo

  • Entrada de grupo concluído com êxito

Entrada de início de grupo: a entrada de início de grupo no log ULS significa que um trabalho foi selecionado para processamento. Neste ponto, o status do trabalho será "Processando" Veja abaixo um exemplo de entrada referente ao trabalho:

05/13/2008 11:24:09.55 Microsoft.Office.Project.Server (0x0E9C) 0x1378  ProjectServer   ProjectServerQueue 7h52 Medium PWA:http://Contoso/PWA, SSP:SharedServices1, User:Contoso\EvaCorets, PSI:[QUEUE] ProjectQ: Starting group 95e48e6e-71ad-4a6b-b997-86693cac4f66 type = ProjectCreate priority = StandardPriority   59d07fb9-158f-42b6-ac09-824d592c06c7

Entrada de grupo concluído com êxito: quando um trabalho tem seu processamento concluído com êxito, isso é notado por uma entrada de grupo concluído com êxito no log ULS. O trabalho tem o status "Êxito". Veja abaixo um exemplo de entrada referente ao trabalho:

05/13/2008 11:24:11.52 Microsoft.Office.Project.Server (0x0E9C) 0x1378  ProjectServer  ProjectServerQueue 7h5o Medium PWA:http://Contoso/PWA, SSP:SharedServices1, User:Contoso\EvaCorets, PSI:[QUEUE] ProjectQ: Group completed successfully: 95e48e6e-71ad-4a6b-b997-86693cac4f66 type = ProjectCreate 59d07fb9-158f-42b6-ac09-824d592c06c7

Parâmetros de entrada em fila

Os seguintes parâmetros podem ser encontrados em todas as entradas de trabalho da fila nos logs ULS:

Parâmetro Descrição

PWA:http://contoso/PWA

Descreve a instância do Project Server na qual o trabalho da fila está sendo processado. Neste exemplo, é "http://contoso/PWA".

SSP:ShareService1

Descreve o Provedor de Serviços Compartilhados para a instância do Project Server na qual o trabalho ocorreu. Neste exemplo, é “SharedService1”.

User:Contoso\EvaCorets

Descreve o proprietário do trabalho da fila. Neste exemplo, é um usuário do Windows com o alias EvaCorets.

PSI: WinProj.PreSaveProject

Descreve a chamada Project Server Interface (PSI) que está sendo feita por meio do trabalho. Neste exemplo, WinProj.PreSaveProject significa que a chamada PSI é uma operação Salvar do projeto por meio do Project Professional.

[SENDER]

Diz que a mensagem está sendo enviada para a fila.

[QUEUE]

Define os threads principais da fila e os threads de trabalho da fila.

[SERVICE]

Define o Processo do Observador de Fila.

[QSERVICE]

Define o Processo de Trabalho de Fila.

ProjectQ:

Defines a fila do Projeto (em oposição à fila do Quadro de Horários).

ProjectSave

Especifica que o trabalho é do tipo Salvar do cliente do Project. O tipo de trabalho será acompanhado das entradas Type = in Starting Group ou Group Completed Successfully.

StandardPriority

Indica a prioridade do trabalho. Trabalhos de baixa prioridade (como a gravação no banco de dados de relatório gerada por meio de um trabalho de publicação de projeto) serão selecionados para processamento depois dos trabalhos de alta de prioridade. A prioridade será acompanhada das entradas Priority = in Starting Group ou Group Completed Successfully.

JobUID: de2f…

Define a UID do trabalho da fila. O valor da UID do Trabalho corresponde ao valor da ID do Trabalho para trabalhos da fila na página Gerenciar Trabalhos da Fila nas Configurações do Servidor do Project Web Access.

NoteObservação:
Os valores UID da última coluna de uma entrada de trabalho da fila nos logs ULS podem geralmente ser correlacionados ao valor UID do Grupo de Trabalho da página Gerenciar Trabalhos da Fila nas Configurações do Servidor do Project Web Access.

Para obter mais informações sobre threads e processos de fila, consulte Sistema de fila do Microsoft Office Project Server 2007.

Consulte também

Conceitos

Sistema de fila do Microsoft Office Project Server 2007
Práticas recomendadas para solucionar problemas de fila do Project Server
Configurar o número máximo de threads de processador de trabalho para o Serviço de Fila do Project Server
Solucionar problemas de trabalhos em fila ao obter o status de fila