Compartilhar via

Arquivos de Log (Documentação do SDK do POS para .NET v1.14)

O POS para .NET (Ponto de Serviço para .NET) da Microsoft inclui um recurso de registro em log para a gravação do POS para .NET, Objetos de Serviço e eventos de aplicativo. Os parâmetros de registro em log são lidos da chave do Registro do POS para .NET, \HKLM\SOFTWARE\POSfor.NET\Logging e as entradas são gravadas usando a classe Logger.

Habilitando o registro em log

O registro em log é habilitado quando a chave do Registro \HKLM\SOFTWARE\POSfor.NET\Logging\Enabled é definida como qualquer valor diferente de zero.

Tamanho do Arquivo de Log

O tamanho máximo do arquivo de log é especificado na chave do Registro \HKLM\SOFTWARE\POSfor.NET\Logging\MaxLogFileSizeMB. Se esse tamanho de arquivo for excedido enquanto o registro em log estiver habilitado, esse registro será interrompido. Nenhuma exceção ou erro será retornada ao aplicativo.

Por padrão, o tamanho máximo do arquivo de log é de 10 MB (megabytes).

Local do Arquivo de Log

A chave do Registro \HKLM\SOFTWARE\POSfor.NET\Logging\location é usada para determinar onde os arquivos de log serão gravados.

Por padrão, esse local é definido como a variável de ambiente %TEMP% que, no Windows, usa o diretório C:\Documents and Settings\(username)\Local Settings\temp como padrão. Esse é um diretório por usuário.

Nomes de arquivo de log

Os nomes de arquivo de log são compostos por três elementos:

  • O nome do arquivo base presente na chave do Registro \HKLM\SOFTWARE\POSfor.NET\Logging\Name. O padrão para esse valor é PosFor.Net.
  • Um carimbo de data/hora neste formato: (aaaa-mm-dd hh-mm-ssZ)
  • A extensão de arquivo .txt.

Eis um exemplo de um nome de arquivo de log típico:

PosFor.Net(2006-08-10 18-33-29Z).txt

Cabeçalho do arquivo de log

Um cabeçalho contendo informações como o usuário, o sistema operacional, o thread de chamada e o processo é gravado em cada arquivo de log quando ele é criado. Esse cabeçalho inclui os seguintes campos:

  • Current user: o nome do usuário atual.
  • Computer name: o nome do computador que está criando o log.
  • OS version: a versão do Windows que está sendo executada, incluindo service packs.
  • .Net runtime: a versão do runtime do .NET.
  • Process Id: o PID do processo que criou o arquivo de log.
  • Thread Id: o thread que criou o log.
  • Max log file size: o tamanho máximo do arquivo a ser usado para esse arquivo de log.
  • File: o nome do executável que criou o arquivo de log.
  • InternalName: o nome interno do executável.
  • OriginalFilename: o nome original do executável.
  • FileVersion: as informações de versão armazenadas no executável.
  • FileDescription: a descrição armazenada no executável.
  • Product: a descrição do produto armazenada no executável.
  • ProductVersion: a versão do arquivo armazenada no executável.
  • Debug: o sinalizador de depuração.
  • Patched: o arquivo corrigido.
  • PreRelease: o sinalizador de pré-lançamento.
  • PrivateBuild: o sinalizador de build privado.
  • SpecialBuild: o sinalizador de build especial.
  • Language: a linguagem usada para criar o arquivo de log.

Entradas de arquivo de log

As entradas de log podem ser criadas pelo POS para .NET, pelo aplicativo ou pelo Objeto de Serviço. As entradas são criadas chamando o método apropriado em uma instância da classe Logger.

Cada entrada contém os seguintes campos:

  • Carimbo de data/hora.

  • ID do thread que criou a entrada.

  • Nível de importância. Cada entrada de log é marcada com seu nível de importância, o qual é determinado pelo método Logger envolvido.

    Marca de importância em entradas de log Método do agente correspondente
    INFO Logger.Info
    WARNING Logger.Warning
    ERROR Logger.Error

  • Cadeia de caracteres de nome especificada pelo código que chamou o método Logger. Essa cadeia de caracteres é especificada quando o método Logger é invocado e pode não conter o nome do executável necessariamente.

  • Por exemplo, uma entrada típica no arquivo de log teria esta aparência: [8/10/2006 6:12:14 PM 2936 INFO PosExplorer] Entering LoadExplorer()

Comentários

Se houver um arquivo de log aberto e o aplicativo chamar o método Refresh(), o arquivo será fechado e será criado um novo com o carimbo de data/hora atualizado.

Consulte Também

Referência

Conceitos

Outros recursos