WebAPI+SignalR实现实时日志监测

在最近的一篇博文中描述了使用NLog记录WebAPI的调用日志，但是也发现在实际使用中由诸多不便。日志只有在生成后才能查看，能否在接口调用的同时就看到呢？结合使用SignalR可以实现这种可能。

本文会在之前的两篇文章基础上进行讲解：

WebAPI+NLog实现日志输出

WebAPI集成SignalR

思路

第三方程序调用API接口时会触发日志跟踪，如果在此时将日志内容通过SignalR广播出去，并由一个Web页面接收显示，那么就能实现接口调用的实时监听。

实现

改造SignalR

首先我们希望能够为日志监听单独开辟一条“通道”，以便不受到其他通道的影响。同时考虑到日志消息的发送是“广播”，与Client无关，所以采用持久连接PersistentConnection来做这件事情。

添加我们的日志广播通道LogTracer.cs，并继承于PersistentConnection：

public class LogTracer : PersistentConnection
{
//protected override Task OnConnected(IRequest request, string connectionId)
//{
//    return Connection.Send(connectionId, "Welcome!");
//}

//protected override Task OnReceived(IRequest request, string connectionId, string data)
//{
//    return Connection.Broadcast(data);
//}
}

这个类不需要添加任何代码，要做的仅仅是在Startup类中对它进行配置。



这样一条专为日志广播的通道就建好了。

改造NLog日志类

在之前的文章WebAPI+NLog实现接口日志输出中，日志的写入是在AppLog类中完成的，我们只需要在日志写入前或写入后将日志内容广播出去就行了。

在AppLog中引入上一步创建的持久连接：

//持久连接--日志监听
private static IPersistentConnectionContext connectContext = GlobalHost.ConnectionManager.GetConnectionContext<Hubs.LogTracer>();

在日志内容被写入文件之前，将其通过持久连接广播出去（添加在函数Log中）：

页面展示

显示实时日志的页面实质上就是SignalR的Web客户端。

在项目中添加一个MVC控制器LogController，同时在Views目录下会创建Log目录以及Index.cshtml。

为Index.cshtml添加js引用：

<script src="~/Scripts/jquery-1.10.2.min.js"></script>

<script src="~/Scripts/jquery.signalR-2.2.1.js"></script>

定义持久连接代理以及连接、断开的方法：

var listener = $.connection('/LogTracer');
//开启连接
function startConnection() {
//stopConnection();
listener.start().fail(function () {
$('#_messageList').append('<li>监听启动失败!</li>');
}).done(function () {
$('#_messageList').append('<li>监听已启动...</li>');
});
listener.received(function (message) {

$('#_messageList').append('<li>' + message + '</li>');

});
}

//断开连接
function stopConnection() {
if(listener!=null){
listener.stop();
}
};

页面全部代码如下：

@{
ViewBag.Title = "系统日志";
}
<h2>实时日志</h2>
<p>
@Html.ActionLink("历史日志","History")
</p>
<div>
<input type="button" id="_start" value="开始监听" />
<input type="button" id="_stop" value="停止监听" />
<input type="button" id="_clear" value="清空记录" />
</div>
<div>
<ul id="_messageList"></ul>
</div>

@section scripts{
<script src="~/Scripts/jquery-1.10.2.min.js"></script>

<script src="~/Scripts/jquery.signalR-2.2.1.js"></script>
<script>

//隐藏
$("#tbLog").hide();

$(function () {
var startBtn = $('#_start');
var stopBtn = $('#_stop');
var listener = $.connection('/LogTracer');

enable(stopBtn, false);
enable(startBtn, true);

//启动
startBtn.click(function () {
startConnection();
enable(stopBtn, true);
enable(startBtn, false);
});

//停止
stopBtn.click(function () {
stopConnection();
enable(startBtn, true);
enable(stopBtn, false);
$('#_messageList').append('<li>监听已停止...</li>');
});

//清空列表
$('#_clear').click(function () {
$('#_messageList').children().remove();

});

//开启连接
function startConnection() {
//stopConnection();
listener.start().fail(function () {
$('#_messageList').append('<li>监听启动失败!</li>');
}).done(function () {
$('#_messageList').append('<li>监听已启动...</li>');
});
listener.received(function (message) {

$('#_messageList').append('<li>' + message + '</li>');

});
}

//断开连接
function stopConnection() {
if(listener!=null){
listener.stop();
}
};

//按钮切换
function enable(button,enabled) {
if (enabled) {
button.removeAttr("disabled");
}
else {

button.attr("disabled", "disabled");

}

}

});

</script>
}

效果

完成上述改造后，运行项目，在系统日志页面启动日志监听，当API接口被调用时，就可以实时监测了。效果如下：



另外又增加了一个历史日志的查询界面（日志文件保存在指定目录下，读取文件内容展示在界面上即可），效果如下：



通过这次思考及实现，发现将不同的技术点融合后会有许多不错的结果，期待后面能发现更多有趣的事情。