Partilhar via

Arquivos de log (documentação do SDK do PDV para .NET v1.14)

O Microsoft Point of Service for .NET (POS para .NET) inclui um recurso de log para gravar POS para .NET, objetos de serviço e eventos de aplicativos. Os parâmetros de log são lidos da chave do Registro POS for .NET, \HKLM\SOFTWARE\POSfor.NET\Logging, e as entradas são gravadas usando a Logger classe.

Ativar o Registo

O registo é ativado quando a chave de registo \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, o registro em log será interrompido. Não haverá exceção ou erro retornado ao aplicativo.

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

Localização 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, assume como padrão o diretório C:\Documents and Settings\(username)\Local Settings\temp. Este é um diretório por usuário.

Nomes de arquivos de log

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

  • O nome do ficheiro base contido na chave de registo \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 do arquivo .txt.

Este é 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 usuário, sistema operacional, thread de chamada e processo é gravado em cada arquivo de log quando ele é criado. Este cabeçalho inclui os seguintes campos:

  • Usuário atual: o nome do usuário atual.
  • Nome do computador: o nome do computador que está criando o log.
  • Versão do SO: A versão do Windows que está a ser executada, incluindo service packs.
  • Tempo de execução do .Net: A versão do tempo de execução do .NET.
  • ID do processo: O PID do processo que criou o arquivo de log.
  • Thread Id: O thread que criou o log.
  • Tamanho máximo do arquivo de log: o tamanho máximo a ser usado para esse arquivo de log.
  • Arquivo: 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.
  • Produto: A descrição do produto armazenada no executável.
  • ProductVersion: A versão do arquivo armazenada no executável.
  • Depurar: sinalizador de depuração.
  • Corrigido: Arquivo corrigido.
  • Pré-lançamento: sinalizador de pré-lançamento.
  • PrivateBuild: Sinalizador de construção privada.
  • SpecialBuild: Bandeira de construção especial.
  • Idioma: O idioma usado para criar o arquivo de log.

Entradas do arquivo de log

As entradas de log podem ser criadas pelo POS para .NET ou 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, que é determinado pelo método Logger envolvido.

    Tag de importância nas entradas de log Método Logger correspondente
    INFORMAÇÃO Logger.Info
    AVISO Logger.Aviso
    ERRO 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 necessariamente o nome do executável.

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

Comentários

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

Consulte Também

Referência

Conceitos

Outros Recursos

  • Last updated on