Eventos da Web no ASP.NET 2.0

Bem-vindo à coluna ASP.NET suporte voz! Meu nome é Jerry Andrade. Eu foram com a Microsoft por 5 anos e passaram a maior parte do meu tempo que se concentra na tecnologias relacionadas à Web, como o FrontPage e as novas tecnologias SharePoint. Passei o ano passado, trabalhar com ASP.NET como um engenheiro de suporte.

Este mês na coluna suporte voz, vou descrever o novo recurso de eventos Web fornecido na próxima versão do ASP.NET 2.0.

O recurso de eventos Web do ASP.NET 2.0

Um dos principais serviços novos fornecidos no ASP.NET 2.0 é a Web eventos recurso fornecido pelo sistema de monitoramento de integridade. Modificando o arquivo Web.config, você pode usar a sistema de monitoramento de integridade para fazer exceções sem tratamento, formulários expirados, tíquetes de autenticação e quaisquer outros dados que você deseja registrados no seu aplicativo. Esta coluna obterá iniciado usando o recurso de eventos Web e também fornece exemplos de como usar vários provedores no ASP.NET 2.0.

Log é realizado, definindo uma regra que associa a um provedor de eventos. A regra define o tipo de eventos que são enviadas para o provedor. Os seguintes eventos base estão disponíveis para você fazer logon: Os tipos de provedores disponíveis permitem que você enviar saída de evento para visualizar eventos, SQL Server, (WMI) e email. O provedores pré-configurados e mapeamentos de evento reduzir a quantidade de trabalho necessário para obter saída de evento registrada.

ASP.NET 2.0 usa o log de eventos provedor-de-pronta para registrar eventos com base em domínios de aplicativo iniciando e parando, bem como fazer todas as exceções sem tratamento. Isso ajuda a abordar alguns dos cenários básicos. Por exemplo, digamos que seu aplicativo lança uma exceção, mas o usuário não salvar o erro e não é possível reproduzi-lo. Com a regra de log de eventos padrão, você poderá coletar as informações de exceção e pilha para ter uma idéia melhor do que tipo de erro ocorreu. Ou, se seu aplicativo está perdendo estado da sessão, você pode procurar no log de eventos para determinar se o domínio do aplicativo é reciclagem e por que o domínio do aplicativo foi interrompido em primeiro lugar.

Além disso, a sistema de monitoramento de integridade é extensível. Por exemplo, você pode definir eventos Web personalizados, acioná-los dentro de seu aplicativo e, em seguida, definir uma regra para enviar as informações de evento para um provedor, como seu email. Isso permite que você facilmente vincular seu instrumentação para o provedores de monitoramento de integridade. Como outro exemplo, você pode disparar um evento cada vez que um pedido é processado e configurar uma regra que envia a cada evento para o banco de dados do SQL Server. Você também foi disparado um evento quando um usuário tenta fazer logon várias vezes em uma linha e configurar o evento para usar os provedores com email.

A configuração para os eventos e provedores padrão é armazenada no arquivo Web.config global. O arquivo Web.config global armazena todos os as baseado na Web configurações que estavam armazenadas no arquivo Machine.config no ASP.NET 1 x. O arquivo Web.config global está localizado no seguinte diretório:A seção <healthmonitoring> do arquivo Web.config global fornece padrão definições de configuração. Você pode substituir essa configuração ou configurar suas próprias configurações Implementando a seção <healthmonitoring> no arquivo Web.config para seu aplicativo.

A seção <healthmonitoring> do arquivo Web.config global contém os seguintes itens:

• provedores Contém provedores configurado para o Visualizar eventos, WMI e SQL Server.
• eventMappings Contém mapeamentos de várias classes WebBase. Você pode estender essa lista se você gerar sua própria classe de evento. Gerar sua própria classe de evento lhe granularidade mais refinada sobre os provedores de que enviar informações para. Por exemplo, você pode configurar exceções não tratadas sejam enviadas para SQL Server, ao enviar seus próprios eventos personalizados ao email.
• regras Vincula o eventMappings para o provedor.
• armazenamento em buffer Usada com provedores SQL Server e o email para determinar como freqüentemente liberar os eventos para o provedor.

Abaixo está um exemplo de código do arquivo Web.config global.

Exemplo de provedor

Este exemplo de provedor contém os seguintes arquivos:

• arquivo ViewEvents.aspx o ? dispara o evento de web personalizado MyEvent no evento click do botão Page_Load e evento de log . Tem um GridView que usa a conexão de banco de dados no arquivo Web.config para lista os eventos registrados para o SQL Server.
  
  Certifique-se configurar o connectionString no arquivo Web.config para apontar para o banco de dados ASPNETDB .
• arquivo Web.config o ? possui todos os vários provedores e regras configuradas e comentada. Retire os comentários na regra que você deseja testar e procure as páginas de Default.aspx e ViewEvent.aspx para ver a aparência da saída.
• arquivo MyEvent.cs o ? localizados na pasta App_Data. Isso é usado na página ViewEvents.aspx para acionar um evento personalizado.
• arquivo default.aspx o ? lança uma System.NullReferenceException para ver o que faz uma exceção não tratada.
• arquivo EmailTemplateTest.aspx o ? usado para o exemplo TemplateemailProvider. O arquivo code-behind para o arquivo EmailTemplateTest.aspx tem linhas de código, você pode remover comentários, que fará com que a página para gerar uma exceção.

Como armazenar eventos em Visualizar eventos

Como mencionei anteriormente, o provedor de eventos de log de eventos visualizar está configurado para você no arquivo Web.config global. Por padrão, todos os eventos com base em WebBaseErrorEvent e WebFailureAuditEvent são registrados. Você pode adicionar regras adicionais para registrar informações adicionais no log de eventos. Por exemplo, se você quiser registrar todos os eventos ( ou seja , todos os eventos com base em WebBaseEvent ), você pode adicionar a regra a seguir ao seu arquivo Web.config: essa regra deve vincular o mapa de eventos de Todos os eventos ao provedor de log de eventos. EventMapping e o provedor estão incluídos no arquivo Web.config global. Em seguida, você pode usar a página ViewEvents.aspx para disparar os eventos gerados procurando a página. A página também acionará o evento personalizado MyEvent no evento Page_Load e um clique de botão .

Para ver o tipo de dados gerados, procure a página Default.aspx. Isso lançará uma exceção System.NullReferenceException , e o seguinte evento será registrado no evento visualizar:

Tipo de evento: aviso
Origem do evento: ASP.NET 2.0.50601.0
Categoria do evento: Eventos da Web
IDENTIFICAÇÃO de evento: 1311
Data: 16/8/2005
Tempo: 9:37:44 PM
Usuário: N/d
Computador: Computer name
Descrição:
Código do evento: 3005
Mensagem de evento: Ocorreu uma exceção sem tratamento.
Hora do evento: 16/8/2005 9:37:44 PM
Hora do evento (UTC): 17/8/2005 2:37:44 AM
IDENTIFICAÇÃO de evento: 88838b4e73cf4a0d9a36ac737ff9d1a0
Seqüência de eventos: 39
Ocorrência do evento: 1
Código de detalhes do evento: 0
As informações do aplicativo: domínio de aplicativo: d047d537-2-127687190240098660
Nível de confiança: total
Caminho do aplicativo virtual: /WebSite3
Physical path do caminho de aplicativo:
Nome da máquina: Computer name
Processar informações: ID do processo: 3776
Nome do processo: WebDev.WebServer.EXE
Nome da conta: domínio\usuário
Informações de exceção: tipo de exceção: NullReferenceException
Mensagem de exceção: não definida para uma instância de um objeto de referência de objeto.
Solicitar informações: solicitação de URL: http://localhost:1698/WebSite3/Default.aspx
Solicitar caminho: /WebSite3/Default.aspx
Endereço de host do usuário: 127.0.0.1
Usuário: domínio\usuário
Está autenticado: VERDADEIRO
Tipo de autenticação: NTLM
Conta de thread nome: domínio\usuário
Informações do thread:
Identificação do segmento: 8
Conta de thread nome: domínio\usuário
Está representando: FALSO

Rastreamento de pilha: no _Default.Page_Load (objeto remetente, EventArgs e) em c:\Documents e Settings\user\Desktop\WebEvents\WebSite3\WebSite3\Default.aspx.cs:line 15
em System.Web.Util.CalliHelper.EventArgFunctionCaller(IntPtr fp, Object o, Object t, EventArgs e)
em System.Web.Util.CalliEventHandlerDelegateProxy.Callback (objeto remetente, EventArgs e)
em System.Web.UI.Control.OnLoad (EventArgs e) em System.Web.UI.Control.LoadRecursive()
em System.Web.UI.Page.ProcessRequestMain (includeStagesBeforeAsyncPoint Boolean, includeStagesAfterAsyncPoint Boolean)

Detalhes do evento personalizado: para obter mais informações, consulte o Centro de Ajuda e suporte em http://support.microsoft.com.

Log de todos os eventos no log de eventos gera eventos informativos bem. O seguinte evento mostra o URL autorização subseqüente para a solicitação da página:

Tipo de evento: Informações
Origem do evento: ASP.NET 2.0.50601.0
Categoria do evento: Web eventos
IDENTIFICAÇÃO de evento: 1314
Data: 16/8/2005
Tempo: 11: 04: 44 PM
Usuário: N/d
Computador: Computer name
Descrição:
Código do evento: 4003
Mensagem de evento: URL autorização bem-sucedida para a solicitação.
Hora do evento: 16/8/2005 11: 04: 44 PM
Hora do evento (UTC): 17/8/2005 4: 04: 44 AM
IDENTIFICAÇÃO de evento: fec3d73fba0247eaba425e5ccfada18e
Seqüência de eventos: 2
Ocorrência do evento: 1
Código de detalhes do evento: 0
Informações de aplicativo:
Domínio de aplicativo: d047d537-1-127687250829701433
Nível de confiança: total
Caminho do aplicativo virtual: /WebSite3
Caminho do aplicativo: C:\Documents and Settings\user\Desktop\WebEvents\WebSite3\WebSite3\
Nome da máquina: Computer name
Informações do processo:
Identificação do processo: 2292
Nome do processo: WebDev.WebServer.EXE
Nome da conta: domínio\usuário
Solicite informações sobre:
Solicitar URL: http://localhost:2087/WebSite3/Default.aspx
Solicitar caminho: /WebSite3/Default.aspx
Endereço de host do usuário: 127.0.0.1
Usuário: domínio\usuário
Está autenticado: VERDADEIRO
Tipo de autenticação: NTLM
Conta de thread nome: domínio\usuário

Detalhes do evento personalizado:
Para obter mais informações, consulte o Centro de Ajuda e suporte em http://support.microsoft.com.

Como armazenar eventos para o SQL Server

Esse método usa o banco de dados ASPNETDB , que é gerado pela ferramenta Aspnet_regsql.exe. O provedor padrão usa a seqüência de conexão LocalSqlServer, que usa a instância SQLExpress local do SQL Server ou um banco de dados com base em arquivo na pasta App_Data. A seqüência de caracteres de conexão LocalSqlServer e o SqlProvider são configurados no arquivo Web.config global.

LocalSqlServer seqüência de conexão no arquivo Web.config global tem esta aparência: se você desejar usar outro SQL server, você precisará usar a ferramenta Aspnet_regsql.exe, que pode ser encontrada na pasta %windir%\Microsoft.Net\Framework\v2.0.*\Aspnet_regsql.exe. Use a ferramenta Aspnet_regsql.exe para gerar um banco de dados ASPNETDB personalizado no servidor do SQL server e adicionar a seqüência de caracteres de conexão ao arquivo .config aplicativos e adicione um provedor usando a nova seqüência de conexão. Depois de banco de dados ASPNETDB criado, você precisará definir uma regra para vincular um eventMapping o sqlProvider.

Para configurar um banco de dados personalizado, execute estas etapas:

1. Gere um banco de dados ASPNETDB .
   1. Execute aspnet_regsql.exe ?W e percorrer o assistente.
   2. Execute o comando para automatizar o processo: Aspnet_regsql ?A w s SQL Server - Leste
2. Adicionar uma seqüência de conexão que aponta para o banco de dados, para que ele se parece com isso:

   <connectionStrings>
   	<add name="MYASPNETDB" connectionString="Server=<SQL Instance>;Integrated Security=SSPI;Database=aspnetdb"/>
   </connectionStrings>

3. Adicionar um provedor para usar a seqüência de conexão MYASPNETDB, para que fique assim:

   <healthMonitoring>
   	<providers>
   		<add name="MySqlWebEventProvider" type="System.Web.Management.SqlWebEventProvider" connectionStringName="MYASPNETDB" maxEventDetailsLength="1073741823" buffer="false"/>
   	</providers>
   </healthMonitoring>

Se você usar o padrão SqlProvider ou configura seu próprio provedor, você precisará adicionar uma regra vinculando o provedor com um mapa de evento. A regra a seguir vincula o novo provedor que você criou acima ao mapa de eventos de Todos os eventos . Esta regra será registrar todos os eventos com base em WebBaseEvent e enviá-los para MySqlWebEventProvider que usará a seqüência de caracteres de conexão MYASPNETDB. O código a seguir adiciona uma regra para vincular o provedor com um mapa de evento: se você quiser apenas enviar erros ao SQL Server, você poderá adicionar a seguinte regra:

Como encaminhar eventos WMI

Você também pode encaminhar os eventos WMI. O provedor WMI é configurado para você no arquivo Web.config global por padrão.

O exemplo de código a seguir adiciona uma regra para encaminhar os eventos para o WMI: você precisará adicionar uma regra para associar um eventMapping para o provedor e um aplicativo de escuta do WMI para ouvir os eventos. O exemplo de código a seguir adiciona uma regra para vincular o provedor WMI do mapa de eventos de Todos os eventos : o aplicativo de console exemplo SampleASPNET usa o objeto ManagementEventWatcher para monitorar os eventos e exibi-las na janela do console.
Para usar SampleASPNET, execute estas etapas:

1. Inicie SampleASPNET.exe.
2. Navegar na página ViewEvents.aspx; quando você faz, você verá eventos listados no aplicativo de console.
3. Clique em log eventos Button_Click . A página irá postar de volta, e você verá os eventos adicionais também registrados.

Observação Se você estiver monitorando eventos em um computador remoto, o aplicativo de escutando precisa estar sendo executado no computador como uma conta com acesso de administrador.

Como encaminhar eventos de email

Você também pode encaminhar eventos para email. Isso permitirá que você obter informações sobre seu aplicativo diretamente na caixa de entrada (provavelmente excedente). Cuidado sobre quais regras de evento você mapear para seu provedor de email, como você pode inadvertidamente enviar muita informação que podem ser mais adequadas para SQL Server ou o log de eventos.

Há dois provedores de email, SimpleMailWebEventProvider e TemplatedMailWebEventProvider. Cada tem os atributos de configuração mesmo, com exceção dos atributos de "modelo" e "detailedTemplateErrors", que só estão disponíveis a TemplatedMailWebEventProvider.

Observação Nenhum desses provedores de email está configurado para você. Será necessário adicioná-los a seu arquivo Web.config.

A principal diferença entre esses provedores de duas email é que SimpleMailWebEventProvider envia emails em um modelo genérico não pode ser modificado. The sample Web.config file adds this e-mail provider to the list of configured providers by using the following rule: a regra a seguir também é adicionada para vincular o provedor de email para o mapa de eventos de Todos os eventos : a alerta de email é semelhante à seguinte:A seguir há uma mensagem de alerta de email que mostra uma exceção não tratada:TemplatedMailWebEventProvider permite que você especificar uma página ASPX como um modelo--você adivinhou ele--. A saída da página ASPX é usada no corpo do email, permitindo que você personalizar a aparência dos dados que é exibida.

O aplicativo de exemplo usa o código a seguir para adicionar TemplatedMailWebEventProvider Web.config arquivo e especificar a página EmailTemplateTest.aspx como o modelo. (A página EmailTemplateTest.aspx percorre os eventos disponíveis no buffer e os exibe em uma tabela.) a alerta de email é semelhante à seguinte:Em ambos os casos, se o atributo de buffer for false, o email conterá somente um evento. Com buffer definido como true, você também precisará especificar um bufferMode, que indica a freqüência de liberar o buffer. Há alguns bufferModes padrão no arquivo Web.config global.

Se detailedTemplateErrors = "true", e quaisquer erros que ocorrem quando você executar o modelo serão enviados no corpo do email. Se detailedTemplateErrors = "false", um erro genérico é enviado.

Um erro detalhadas lançado por EmailTemplateTest.aspx tem esta aparência:Se o atributo for FALSO e não houver erro, você só receberá uma mensagem de erro genérica, que tem esta aparência: Observação Para atributos relacionados ao armazenamento em buffer, cada liberação resulta em uma notificação. Se a liberação contém mais eventos que permite maxEventsPerMessage , a notificação será desmembrada em vários emails, mas eles todos ainda são considerados para ser a mesma notificação. Por exemplo, uma liberação gera 13 eventos, mas maxEventsPerMessage somente permite que cinco. Você obterá três emails: cada duas primeiras emails irão conter cinco eventos e o terceiro email conterá três eventos.

Se houver mais emails que permite maxMessagesPerNotification , alguns eventos são descartados. Por exemplo, se você definir maxMessagesPerNotification para dois e você usar o mesmo maxEventsPerMessage como acima, deve receber somente dois emails. Os eventos que seriam no terceiro email são ignorados. Qualquer quedas ou truncamento de notificações será ser observado em um dos emails para o provedor de simple mail. Parte superior do email será exibido o seguinte:Como você têm controle do formato do email para o modelo de provedor, você precisa verificar para posicionamentos/truncamento você mesmo e determinar se deseja que incluir no email.

Observação Provedores de email usam System.NET.Mail, para que você precise configurar System.NET.Mail no seu arquivo Web.config.

Para obter mais informações sobre o recurso de eventos Web no ASP.NET 2.0, você pode baixar os arquivos de exemplo de eventos da Web a seguir.
Download the Web Events Sample.exe package now. (http://download.microsoft.com/download/a/1/e/a1ea5122-a6c4-4331-bad8-8556f256004c/web events sample.exe)
Para obter mais informações no esquema de configurações do ASP.NET, visite o seguinte site:Para obter mais informações sobre monitoramento de integridade no ASP.NET 2.0, visite o seguinte site: