Partilhar via


Como: Criar e Remove Custom evento Logs

Você pode usar o EventLog classe para criar um evento personalizado log em um computador local ou remoto. Você pode criar um log personalizado se você quiser organizar as entradas de uma maneira mais granular, que é permitido quando os componentes escreve as entradas no log do aplicativo padrão.Por exemplo, suponha que você tem um componente chamado OrderEntry que grava informações de entrada para um log de eventos.Você está interessado em fazer backup e salvar essas entradas por um período mais longo do time que algumas outras entradas no log do aplicativo.Em vez de registrar seu componente para gravar no log do aplicativo, você pode criar um log personalizado chamado OrdersLog e registrar seu componente para gravar entradas de log em vez disso. Dessa maneira, todas as suas informações de ordem é armazenado em um lugar e não será afetado se as entradas no log do aplicativo serão limpo.

Você pode usar indiretamente o CreateEventSource método para criar um log personalizado. Esse método cria uma nova fonte e permite que você especifique o log para gravar.Se você especificar que você deseja gravar em um log que ainda não existir, o sistema cria um log personalizado para você automaticamente e registra seu componente sistema autônomo uma fonte para aquele log.

Observação:

Remover um log personalizado da mesma forma que você remover qualquer log — chamando o Delete método. Para obter mais informações, consulte Como: Excluir logs evento.

É importante observar a diferença entre a criação de um log de eventos e criando uma instância do EventLog componente. Quando você usa o CreateEventSource método, você está criando um novo personalizado log de eventos no Windows, em vez de um componente no seu projeto ou aplicativo. Quando você criar uma instância do EventLog componente, você criar um componente dentro de seu projeto referencia um evento log externo. Você pode exibir o evento logs criados com o CreateEventSource método na evento Visualizador, mas não é possível exibir ocorrências de componente lá.

Observação:

Em geral, criar nova fonte do evento durante a instalação do seu aplicativo.Isso dá time para o sistema operacional atualizar sua lista de fontes de evento registrados e suas configurações.Se o sistema operacional tiver não r efreshed sua lista de origens de eventos e você tentar gravar um evento com a nova fonte, haverá falha na operação de gravação.Se criar a fonte durante a instalação não for uma opção, em seguida, tentar criar a fonte bem antes da primeira operação de gravar, por haps durante a inicialização do aplicativo.Se você escolher essa abordagem, certifique-se de que seu código de inicialização está sendo executado com direitos de administrador no computador.Esses direitos são necessários para a criação de novas fontes de evento.

Você pode exibir logs personalizado no Gerenciador de servidores, ou no Windows 2000 Gerenciamento do computador janela.Para obter mais informações, consulte Como: Trabalhar com logs de eventos em Gerenciador de Servidores ou Como: Iniciar Visualizar eventos de Gerenciader de Servideres.

Você deve ter direitos de acesso apropriados nos computadores remoto para criar e excluir logs.Para obter mais informações, consulte Implicações de segurança de evento logs.

Observação de segurança:

Quando você criar um evento log, esteja ciente de que o recurso pode já existe.Outro processo, talvez um mal-intencionado, talvez já criou o recurso e ter acesso a ele.Quando você coloca dados log de eventos, os dados estão disponível para o Outros processo.Para obter informações sobre existentes evento logs, consulte Como: Determinar se existem registros de eventos específicos.

Para criar uma personalizada evento log

  • Chamar o CreateEventSource método e especifique a cadeia de caracteres fonte e o nome do arquivo de log que deseja criar.

    Observação:

    Se você especificar nulo ("") sistema autônomo o nome do log, o padrão será o log do aplicativo.Isso não criará um novo log, mas irá registrar a fonte especificada para o log do aplicativo.Se você criar um novo registro, apenas as primeiras oito letras são avaliadas quando d etermining se o nome é exclusivo.

    O exemplo a seguir mostra como criar um log personalizado chamado MyNewLog no computador local. Esse código supõe que um Imports ou using demonstrativo existe para o System.Diagnostics namespace:

    EventLog.CreateEventSource("ApplicationName", "LogName")
    
         System.Diagnostics.EventLog.CreateEventSource("ApplicationName", "LogName");
    

    Para criar um log de eventos personalizado em um computador remoto, especifique o nome do computador sistema autônomo um terceiro parâmetro.O código a seguir mostra um exemplo.

    Dim creationData As New EventSourceCreationData("ApplicationName", "LogName")
    creationData.MachineName = "ServerName"
    EventLog.CreateEventSource(creationData)
    
         System.Diagnostics.EventSourceCreationData creationData = new
                System.Diagnostics.EventSourceCreationData("ApplicationName", "LogName");
            creationData.MachineName = "ServerName";
            EventLog.CreateEventSource(creationData);
    

Consulte também

Tarefas

Como: Excluir logs evento

Como: Trabalhar com logs de eventos em Gerenciador de Servidores

Como: Iniciar Visualizar eventos de Gerenciader de Servideres

Conceitos

Implicações de segurança de evento logs

Introdução ao componente EventLog

Referência

EventLog

Outros recursos

Administrando evento logs