Registro de eventos em log no WCF

  • Artigo

O WCF (Windows Communication Foundation) rastreia os eventos internos no log de eventos do Windows.

Como ver os logs de eventos

O log de eventos está habilitado automaticamente por padrão, e não há nenhum mecanismo para desabilitá-lo. Os eventos registrados pelo WCF podem ser vistos por meio do Visualizador de Eventos. Para iniciar essa ferramenta, clique em Iniciar, em Painel de Controle, clique duas vezes em Ferramentas Administrativas e clique duas vezes em Visualizador de Eventos.

Log de Eventos do Aplicativo

O Log de Eventos do Aplicativo contém a maioria dos eventos gerados pelo WCF. A maioria das entradas indica que um recurso específico não foi iniciado para um aplicativo. Os exemplos incluem:

  • Log/rastreamento de mensagens: o WCF grava um evento no log de eventos quando há uma falha no rastreamento e no log de mensagens. No entanto, nem toda falha de rastreamento dispara um evento. Para impedir que o log de eventos seja completamente preenchido com falhas de rastreamento, o WCF implementa um período de blecaute de dez minutos para um evento como esse. Isso significa que, se o WCF gravar uma falha de rastreamento no log de eventos, ele não o fará novamente por, pelo menos, dez minutos.

  • Ouvinte compartilhado: o Serviço de Compartilhamento de Porta TCP do WCF registra um evento em log quando ele não é iniciado.

  • CardSpace: registra os eventos quando o serviço não é iniciado.

  • Eventos críticos e de erro, como falhas de inicialização ou falhas

  • Log de mensagens ativado: registra os eventos quando o log de mensagens é ativado. Isso serve para notificar o administrador de que informações confidenciais e específicas do aplicativo podem ser registradas em log nos cabeçalhos e nos corpos de mensagens.

  • Um evento é registrado quando o atributo enableLoggingKnownPII no elemento machineSettings do arquivo machine.config é definido. Esse atributo especifica se qualquer aplicativo em execução no computador tem permissão para registrar PII (informações de identificação pessoal) conhecidas em log.

  • Se o atributo logKnownPii no arquivo app.config ou web.config estiver definido como true para que um aplicativo específico ative o log do PII, mas o atributo enableLoggingKnownPII no elemento machineSettings do arquivo machine.config estiver definido como false, um evento será registrado em log. Além disso, se logKnownPii e enableLoggingKnownPII estiverem definidos como true, o evento será registrado em log. Para obter mais informações sobre essas configurações, confira a seção Segurança do tópico Como configurar o log de mensagens.

Log de eventos de segurança

O Log de eventos de segurança contém eventos de auditoria de segurança registrados pelo WCF.

Log de Eventos do Sistema

O WCF não registra nada no Log de eventos do sistema.

Entradas do log de eventos

A origem de um evento é o nome do assembly que gera a entrada de log.

O tipo de entrada de log de eventos é usado para indicar a severidade de um evento. Cada evento precisa ser de um só tipo, o que o aplicativo indica quando relata o evento. O Visualizador de Eventos usa esse tipo para determinar o ícone que será exibido na exibição de lista do log. Para o tipo de evento diferente de uma entrada de log de eventos, confira EventLogEntryType.

Quando você clica em "Mais informações" ao ver um evento no Visualizador de Eventos, o Visualizador de Eventos pode enviar informações pela Internet. Para saber mais, confira a ajuda do Visualizador de Eventos.

Confira também