SQL Server - Como ler e gravar eventos no Event Viewer do Windows utilizando o CLR (C#)

Post Views 3,333 views

Neste artigo

Reading time 5 minutes

Olá pessoal
Tudo bem?

Neste post, eu gostaria de mostrar a vocês como ler e gravar eventos no Visualizador de Eventos (Event Viewer) do Windows utilizando o CLR (C#). Para saber mais sobre o CLR, esse poderoso recurso que permite criar e executar códigos escritos utilizando a linguagem de programação C# e o .NET Framework para estender as funcionalidades do SQL Server, acesse o post Introdução ao SQL CLR (Common Language Runtime) no SQL Server.

Em muitas situações, ter essa informação disponível para consultas no banco de dados pode ser muito útil para criar monitoramentos internos ou para criar aplicações web que consomem essas informações e auxiliem a equipe de desenvolvimento a identificar problemas em aplicações e serviços, bem como permitir que se consiga gravar mensagens de evento personalizadas dentro de Stored Procedures do banco de dados SQL Server, de acordo com determinadas situações.

Um outro exemplo legal para esse post, é aqui na empresa em que eu trabalho, onde existe um serviço que fica monitorando o Event Viewer de um servidor, em busca de um evento onde a aplicação seja “XPTO” e o tipo seja “Error”. Quando é gerado um evento utilizando essa aplicação, uma equipe de monitoramento que trabalha no regime 24×7 faz o acionamento telefônico para um determinado número tomar as ações necessárias, especialmente para rotinas altamente críticas e que não podem falhar ou parar. Esse evento é gravado pelo CLR, quando uma determinada situação no banco de dados ocorre.

Como gravar eventos no Event Viewer pelo SQL Server

Para gravar eventos no Event Viewer do Windows pelo SQL Server, basta executar a Stored Procedure stpEvent_Viewer_Gravar da sua biblioteca CLR.

Parâmetros:

@Ds_Servidor: Nome do servidor que você quer gravar o evento
@Ds_Tipo_Evento: Tipo do evento que você deseja gravar (Error, FailureAudit, Warning, SuccessAudit, Success ou Information)
@Ds_Fonte: Nome que você quer definir como fonte do evento (Geralmente, o nome do sistema ou aplicação)
@Ds_Mensagem: Mensagem que você deseja gravar no evento
@Id_Evento: Código do erro ou mensagem que você quer gerar para este evento (livre escolha sua)

Visualizar código-fonte

using System.Diagnostics;

public partial class StoredProcedures
{
    [Microsoft.SqlServer.Server.SqlProcedure]
    public static void stpEvent_Viewer_Gravar(string Ds_Servidor, string Ds_Tipo_Evento, string Ds_Fonte, string Ds_Mensagem, int Id_Evento)
    {

        var tipoEvento = Ds_Tipo_Evento;
        var enumTipoEvento = EventLogEntryType.Error;
        
        switch (tipoEvento)
        {
            case "Error":
                enumTipoEvento = EventLogEntryType.Error;
                break;

            case "FailureAudit":
                enumTipoEvento = EventLogEntryType.FailureAudit;
                break;

            case "Information":
                enumTipoEvento = EventLogEntryType.Information;
                break;

            case "SuccessAudit":
            case "Success":
                enumTipoEvento = EventLogEntryType.SuccessAudit;
                break;

            case "Warning":
                enumTipoEvento = EventLogEntryType.Warning;
                break;

            default:
                return;
        }

        if (!EventLog.SourceExists(Ds_Fonte))
        {
            EventLog.CreateEventSource(Ds_Fonte, "Application");
        }

        using (var ev = new EventLog("Application", Ds_Servidor))
        {
            ev.Source = Ds_Fonte;
            ev.WriteEntry(Ds_Mensagem, enumTipoEvento, Id_Evento, 1);
        }
        
    }

};

using System.Diagnostics;

public partial class StoredProcedures

{

[Microsoft.SqlServer.Server.SqlProcedure]

public static void stpEvent_Viewer_Gravar(string Ds_Servidor, string Ds_Tipo_Evento, string Ds_Fonte, string Ds_Mensagem, int Id_Evento)

{

var tipoEvento = Ds_Tipo_Evento;

var enumTipoEvento = EventLogEntryType.Error;

switch (tipoEvento)

{

case "Error":

enumTipoEvento = EventLogEntryType.Error;

break;

case "FailureAudit":

enumTipoEvento = EventLogEntryType.FailureAudit;

break;

case "Information":

enumTipoEvento = EventLogEntryType.Information;

break;

case "SuccessAudit":

case "Success":

enumTipoEvento = EventLogEntryType.SuccessAudit;

break;

case "Warning":

enumTipoEvento = EventLogEntryType.Warning;

break;

default:

return;

}

if (!EventLog.SourceExists(Ds_Fonte))

{

EventLog.CreateEventSource(Ds_Fonte, "Application");

}

using (var ev = new EventLog("Application", Ds_Servidor))

{

ev.Source = Ds_Fonte;

ev.WriteEntry(Ds_Mensagem, enumTipoEvento, Id_Evento, 1);

}

};

Exemplo de utilização

Como gravar eventos no Event Viewer pelo SQL Server (Sem CLR)

É possível gravar eventos no Event Viewer pelo SQL Server sem utilizar o CLR? É sim, embora não seja uma forma tão “elegante”, uma vez que não é possível especificar a origem (Source) do evento.

Uma das formas de se fazer isso, é utilizando a opção “Write to the Windows Application event log” do SQL Agent:

A outra forma é utilizando a procedure não documentada xp_logevent, que eu já até havia publicado sobre ela no post The Undocumented SQL Server Extended Procedures:

EXEC master..xp_logevent 50001, 'Teste de mensagem no Event Viewer', 'INFORMATIONAL' -- INFORMATIONAL, WARNING, ERROR

1	EXEC master..xp_logevent 50001, 'Teste de mensagem no Event Viewer', 'INFORMATIONAL' -- INFORMATIONAL, WARNING, ERROR

Exemplo de uso:

Como ler eventos no Event Viewer pelo SQL Server

Para ler eventos no Event Viewer do Windows pelo SQL Server, vou compartilhar duas formas de se atingir esse objetivo, uma utilizando uma Stored Procedure e outra utilizando uma Table-valued function, que nos dá mais flexibilidade para trabalhar com os dados.

Visualizar código-fonte da stpEvent_Viewer_Listar

using System;
using System.Data;
using System.Data.SqlTypes;
using Microsoft.SqlServer.Server;
using System.Diagnostics;

public partial class StoredProcedures
{
    [SqlProcedure]
    public static void stpEvent_Viewer_Listar(string Ds_Servidor, string Ds_Tipo_Log, SqlDateTime Dt_Inicio, SqlDateTime Dt_Fim)
    {
        
        var logType = Ds_Tipo_Log;
        var dtInicio = Dt_Inicio.Value;
        var dtFim = Dt_Fim.Value;

        using (var ev = new EventLog(logType, Ds_Servidor))
        {

            var lastLogToShow = ev.Entries.Count;

            if (lastLogToShow <= 0)
                return;


            var pipe = SqlContext.Pipe;

            var colunas = new SqlMetaData[5];
            colunas[0] = new SqlMetaData("Id_Evento", SqlDbType.BigInt);
            colunas[1] = new SqlMetaData("Fl_Evento", SqlDbType.NVarChar, 1024);
            colunas[2] = new SqlMetaData("Ds_Fonte", SqlDbType.NVarChar, 1024);
            colunas[3] = new SqlMetaData("Ds_Messagem", SqlDbType.NVarChar, 4000);
            colunas[4] = new SqlMetaData("Dt_Evento", SqlDbType.DateTime);

            var linhaSql = new SqlDataRecord(colunas);

            pipe?.SendResultsStart(linhaSql);

            for (var i = ev.Entries.Count - 1; i >= 0; i--)
            {

                try
                {

                    var currentEntry = ev.Entries[i];

                    if ((currentEntry.TimeGenerated >= dtInicio) && (currentEntry.TimeGenerated <= dtFim))
                    {
                        linhaSql.SetSqlInt64(0, new SqlInt64(currentEntry.InstanceId));
                        linhaSql.SetSqlString(1, new SqlString(currentEntry.EntryType.ToString()));
                        linhaSql.SetSqlString(2, new SqlString(currentEntry.Source));
                        linhaSql.SetSqlString(3, new SqlString(currentEntry.Message.Substring(0, (currentEntry.Message.Length) > 4000 ? 3999 : currentEntry.Message.Length)));
                        linhaSql.SetSqlDateTime(4, new SqlDateTime(currentEntry.TimeGenerated));

                        pipe?.SendResultsRow(linhaSql);

                    }
                    else if (currentEntry.TimeGenerated < dtInicio) break;

                }
                catch (Exception e)
                {
                    // ignore
                }

            }

            pipe?.SendResultsEnd();
            
        }
        
    }

};

using System;

using System.Data;

using System.Data.SqlTypes;

using Microsoft.SqlServer.Server;

using System.Diagnostics;

public partial class StoredProcedures

{

[SqlProcedure]

public static void stpEvent_Viewer_Listar(string Ds_Servidor, string Ds_Tipo_Log, SqlDateTime Dt_Inicio, SqlDateTime Dt_Fim)

{

var logType = Ds_Tipo_Log;

var dtInicio = Dt_Inicio.Value;

var dtFim = Dt_Fim.Value;

using (var ev = new EventLog(logType, Ds_Servidor))

{

var lastLogToShow = ev.Entries.Count;

if (lastLogToShow <= 0)

return;

var pipe = SqlContext.Pipe;

var colunas = new SqlMetaData[5];

colunas[0] = new SqlMetaData("Id_Evento", SqlDbType.BigInt);

colunas[1] = new SqlMetaData("Fl_Evento", SqlDbType.NVarChar, 1024);

colunas[2] = new SqlMetaData("Ds_Fonte", SqlDbType.NVarChar, 1024);

colunas[3] = new SqlMetaData("Ds_Messagem", SqlDbType.NVarChar, 4000);

colunas[4] = new SqlMetaData("Dt_Evento", SqlDbType.DateTime);

var linhaSql = new SqlDataRecord(colunas);

pipe?.SendResultsStart(linhaSql);

for (var i = ev.Entries.Count - 1; i >= 0; i--)

{

try

{

var currentEntry = ev.Entries[i];

if ((currentEntry.TimeGenerated >= dtInicio) && (currentEntry.TimeGenerated <= dtFim))

{

linhaSql.SetSqlInt64(0, new SqlInt64(currentEntry.InstanceId));

linhaSql.SetSqlString(1, new SqlString(currentEntry.EntryType.ToString()));

linhaSql.SetSqlString(2, new SqlString(currentEntry.Source));

linhaSql.SetSqlString(3, new SqlString(currentEntry.Message.Substring(0, (currentEntry.Message.Length) > 4000 ? 3999 : currentEntry.Message.Length)));

linhaSql.SetSqlDateTime(4, new SqlDateTime(currentEntry.TimeGenerated));

pipe?.SendResultsRow(linhaSql);

}

else if (currentEntry.TimeGenerated < dtInicio) break;

}

catch (Exception e)

{

// ignore

}

pipe?.SendResultsEnd();

}

};

Visualizar código-fonte da fncEvent_Viewer_Listar

using System;
using System.Collections;
using System.Data.SqlTypes;
using System.Diagnostics;

public partial class UserDefinedFunctions
{

    private class EventViewerListar
    {

        public SqlInt64 Id_Evento;
        public SqlDateTime Dt_Evento;
        public SqlString Tp_Evento;
        public SqlString Ds_Fonte;
        public SqlString Ds_Mensagem;
        

        public EventViewerListar(SqlInt64 idEvento, SqlDateTime dtEvento, SqlString tpEvento, SqlString dsFonte, SqlString dsMensagem)
        {

            Id_Evento = idEvento;
            Dt_Evento = dtEvento;
            Tp_Evento = tpEvento;
            Ds_Fonte = dsFonte;
            Ds_Mensagem = dsMensagem;
            
        }
    }

    [Microsoft.SqlServer.Server.SqlFunction(
        FillRowMethodName = "FillRowEventViewer",
        TableDefinition = "Id_Evento BIGINT, Dt_Evento DATETIME, Tp_Evento nvarchar(50), Ds_Fonte nvarchar(50), " +
                          "Ds_Mensagem NVARCHAR(MAX)"
    )]
    public static IEnumerable fncEvent_Viewer_Listar(string Ds_Servidor, string Ds_Tipo_Log, DateTime Dt_Inicio, DateTime Dt_Fim)
    {

        var eventViewerListarCollection = new ArrayList();

        try
        {

            var logType = Ds_Tipo_Log;

            using (var ev = new EventLog(logType, Ds_Servidor))
            {

                var lastLogToShow = ev.Entries.Count;

                if (lastLogToShow > 0)
                {

                    for (var i = lastLogToShow - 1; i >= 0; i--)
                    {

                        var currentEntry = ev.Entries[i];

                        if ((currentEntry.TimeGenerated >= Dt_Inicio) && (currentEntry.TimeGenerated <= Dt_Fim))
                        {

                            eventViewerListarCollection.Add(new EventViewerListar(
                                currentEntry.InstanceId,
                                currentEntry.TimeGenerated,
                                currentEntry.EntryType.ToString(),
                                currentEntry.Source,
                                currentEntry.Message.Substring(0, (currentEntry.Message.Length) > 4000 ? 3999 : currentEntry.Message.Length)
                            ));

                        }
                        else
                            if (currentEntry.TimeGenerated < Dt_Inicio)
                                break;

                    }

                }
                
            }

        }
        catch (Exception e)
        {
            // ignored
        }


        return eventViewerListarCollection;

    }

    protected static void FillRowEventViewer(object objEventViewerListar, out SqlInt64 idEvento, out SqlDateTime dtEvento, out SqlString tpEvento, out SqlString dsFonte, out SqlString dsMensagem)
    {

        var eventViewerListar = (EventViewerListar)objEventViewerListar;

        idEvento = eventViewerListar.Id_Evento;
        dtEvento = eventViewerListar.Dt_Evento;
        tpEvento = eventViewerListar.Tp_Evento;
        dsFonte = eventViewerListar.Ds_Fonte;
        dsMensagem = eventViewerListar.Ds_Mensagem;

    }

}

100

101

102

103

104

105

using System;

using System.Collections;

using System.Data.SqlTypes;

using System.Diagnostics;

public partial class UserDefinedFunctions

{

private class EventViewerListar

{

public SqlInt64 Id_Evento;

public SqlDateTime Dt_Evento;

public SqlString Tp_Evento;

public SqlString Ds_Fonte;

public SqlString Ds_Mensagem;

public EventViewerListar(SqlInt64 idEvento, SqlDateTime dtEvento, SqlString tpEvento, SqlString dsFonte, SqlString dsMensagem)

{

Id_Evento = idEvento;

Dt_Evento = dtEvento;

Tp_Evento = tpEvento;

Ds_Fonte = dsFonte;

Ds_Mensagem = dsMensagem;

}

[Microsoft.SqlServer.Server.SqlFunction(

FillRowMethodName = "FillRowEventViewer",

TableDefinition = "Id_Evento BIGINT, Dt_Evento DATETIME, Tp_Evento nvarchar(50), Ds_Fonte nvarchar(50), " +

"Ds_Mensagem NVARCHAR(MAX)"

)]

public static IEnumerable fncEvent_Viewer_Listar(string Ds_Servidor, string Ds_Tipo_Log, DateTime Dt_Inicio, DateTime Dt_Fim)

{

var eventViewerListarCollection = new ArrayList();

try

{

var logType = Ds_Tipo_Log;

using (var ev = new EventLog(logType, Ds_Servidor))

{

var lastLogToShow = ev.Entries.Count;

if (lastLogToShow > 0)

{

for (var i = lastLogToShow - 1; i >= 0; i--)

{

var currentEntry = ev.Entries[i];

if ((currentEntry.TimeGenerated >= Dt_Inicio) && (currentEntry.TimeGenerated <= Dt_Fim))

{

eventViewerListarCollection.Add(new EventViewerListar(

currentEntry.InstanceId,

currentEntry.TimeGenerated,

currentEntry.EntryType.ToString(),

currentEntry.Source,

currentEntry.Message.Substring(0, (currentEntry.Message.Length) > 4000 ? 3999 : currentEntry.Message.Length)

));

}

else

if (currentEntry.TimeGenerated < Dt_Inicio)

break;

}

catch (Exception e)

{

// ignored

}

return eventViewerListarCollection;

}

protected static void FillRowEventViewer(object objEventViewerListar, out SqlInt64 idEvento, out SqlDateTime dtEvento, out SqlString tpEvento, out SqlString dsFonte, out SqlString dsMensagem)

{

var eventViewerListar = (EventViewerListar)objEventViewerListar;

idEvento = eventViewerListar.Id_Evento;

dtEvento = eventViewerListar.Dt_Evento;

tpEvento = eventViewerListar.Tp_Evento;

dsFonte = eventViewerListar.Ds_Fonte;

dsMensagem = eventViewerListar.Ds_Mensagem;

}

Exemplos de utilização

Listando os eventos utilizando a SP

Listando os eventos utilizando a função

And that's it, folks!
Espero que tenham gostado desse post e por favor, não confundam eventos do Event Viewer com eventos do log do SQL Server.. rs
Um abraço e até o próximo post.

Subscribe to blog by email

Blog Views

Microsoft MVP

Post Archive

Categories

Recent posts

SQL Server – Como ler e gravar eventos no Event Viewer do Windows utilizando o CLR (C#)

Como gravar eventos no Event Viewer pelo SQL Server

Visualizar código-fonte

Exemplo de utilização

Como gravar eventos no Event Viewer pelo SQL Server (Sem CLR)

Como ler eventos no Event Viewer pelo SQL Server

Visualizar código-fonte da stpEvent_Viewer_Listar

Visualizar código-fonte da fncEvent_Viewer_Listar

Exemplos de utilização

You may also like...

Deixe uma respostaCancelar resposta

Como gravar eventos no Event Viewer pelo SQL Server

Visualizar código-fonte

Exemplo de utilização

Como gravar eventos no Event Viewer pelo SQL Server (Sem CLR)

Como ler eventos no Event Viewer pelo SQL Server

Visualizar código-fonte da stpEvent_Viewer_Listar

Visualizar código-fonte da fncEvent_Viewer_Listar

Exemplos de utilização

You may also like...

SQL Server – Como identificar os parâmetros de inicialização da instância utilizando T-SQL

SQL Server – Como importar arquivos de texto para o banco (OLE Automation, CLR, BCP, BULK INSERT, OPENROWSET)

SQL Server – Como identificar e coletar informações de consultas demoradas utilizando Extended Events (XE)

Deixe uma respostaCancelar resposta