Seq簡介

Seq是老外開發(fā)的一個(gè)針對(duì).NET平臺(tái)非常友好的日志服務(wù)。支持容器部署，提供一個(gè)單用戶免費(fèi)的開發(fā)版本。

官網(wǎng)：https://datalust.co/seq

使用文檔：https://docs.datalust.co/docs

Seq主體功能如下所示：

支持主流的編程語言，尤其對(duì).NET非常友好

豐富的事件格式

以結(jié)構(gòu)化形式記錄上文信息與應(yīng)用程序事件，支持消息模板將文本數(shù)據(jù)與結(jié)構(gòu)話數(shù)據(jù)無縫連接。下圖中所有屬性都是由使用者自定義的。

支持篩選語法和SQL查詢，非常簡單和靈活

多種查詢方式 -支持以SQL表達(dá)式查詢，以及C#中的，==，!=，<，<=，內(nèi)置StartsWith()，EndsWith()，IndexOf() 和Contains(),并支持文本全文檢索。

公開了內(nèi)置字段和函數(shù)

支持儀表盤，可以自行創(chuàng)建和編輯圖表

支持安裝插件，插件可以使用.NET進(jìn)行編寫

支持發(fā)送郵件（通過插件）

支持團(tuán)隊(duì)操作

提供命令行客戶端

支持健康檢查（通過插件）

支持收集Docker日志

支持收集K8s日志

支持自定義警報(bào)和Webhook

部署到k8s

seq部署我們采用的是基于容器的部署，具體可以參考：

https://docs.datalust.co/docs/getting-started-with-docker

騰訊云容器服務(wù)yaml配置如下所示：

apiVersion: apps/v1beta2 kind: Deployment metadata:annotations:deployment.kubernetes.io/revision: "1"generation: 1labels:k8s-app: seqqcloud-app: seqname: seqnamespace: default spec:progressDeadlineSeconds: 600replicas: 1revisionHistoryLimit: 10selector:matchLabels:k8s-app: seqqcloud-app: seqstrategy:rollingUpdate:maxSurge: 1maxUnavailable: 0type: RollingUpdatetemplate:metadata:labels:k8s-app: seqqcloud-app: seqspec:containers:- env:- name: ACCEPT_EULAvalue: "Y"image: datalust/seq:latestimagePullPolicy: IfNotPresentname: seqresources:limits:cpu: 100mmemory: 2024Mirequests:cpu: 10mmemory: 256MiimagePullSecrets:- name: qcloudregistrykey- name: tencenthubkeyrestartPolicy: Always --- apiVersion: v1 kind: Service metadata:name: seqnamespace: default spec:externalTrafficPolicy: Clusterports:- name: 80-80-tcpnodePort: 31180port: 80protocol: TCPtargetPort: 80- name: 5341-5341-tcpnodePort: 31181port: 5341protocol: TCPtargetPort: 5341selector:k8s-app: seqqcloud-app: seqsessionAffinity: Nonetype: NodePort

注意：其中主機(jī)端口分別為31180（對(duì)應(yīng)80，用于公開Seq UI和Web Api）、31181（對(duì)應(yīng)5341，用于公開Seq接收終結(jié)點(diǎn)的端口）。

一般情況，日志不重要的話，我們可以不進(jìn)行持久化配置。如需持久化，僅需配置“/data”的映射即可。

使用

Seq對(duì).NET Core支持非常友好，支持：

• ASP.NET Core

• Serilog

• 使用NLog

• 使用log4net

當(dāng)然還支持其他語言以及其他的一些方式，比如RabbitMQ、GELF、Windows事件等等。接下來，我們以基于NLog集成為例：

安裝包NLog.Targets.Seq

安裝NLog.Targets.Seq NuGet包。例如，在Visual Studio程序包管理器控制臺(tái)中，鍵入：

PM> Install-Package NLog.Targets.Seq

修改NLog配置文件

第一步，需要先添加剛安裝的擴(kuò)展程序集：

<?xml version="1.0" encoding="utf-8" ?> <nlog xmlns="http://www.nlog-project.org/schemas/NLog.xsd"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"><extensions><add assembly="NLog.Targets.Seq"/></extensions>

然后需要定義規(guī)則：

<targets><target name="seq" xsi:type="BufferingWrapper" bufferSize="1000" flushTimeout="2000"><target xsi:type="Seq" serverUrl="http://localhost:5341" apiKey="" /></target></targets><rules><logger name="*" minlevel="Info" writeTo="seq" /></rules>

需要指定服務(wù)端接收端地址和ApiKey。接下來就可以直接使用了。

除此之外，我們還可以添加例如線程Id、機(jī)器名等屬性，配置示例如下所示：

<target name="seq" xsi:type="Seq" serverUrl="http://localhost:5341" apiKey=""><property name="ThreadId" value="${threadid}" as="number" /><property name="MachineName" value="${machinename}" /> </target>

NLOG配置說明

說明

官網(wǎng)：https://nlog-project.org/?r=redirect

配置和使用

https://github.com/NLog/NLog/wiki/Getting-started-with-ASP.NET-Core-2

https://github.com/NLog/NLog/wiki/Getting-started-with-ASP.NET-Core-3

參考配置

<?xml version="1.0" encoding="utf-8"?><nlog xmlns="http://www.nlog-project.org/schemas/NLog.xsd"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"autoReload="true"internalLogLevel="Warn"internalLogFile="App_Data\Logs\nlogs.log"throwExceptions="true"><!-- 定義日志輸出的根目錄為web目錄的上級(jí)目錄 --><variable name="logdir" value="${basedir}/App_Data/logs"/><extensions><add assembly="NLog.Web.AspNetCore"/><add assembly="NLog.Targets.Seq"/></extensions><targets async="true"><default-target-parameterstype="File"archiveAboveSize="50485760"maxArchiveFiles="50"archiveNumbering="Rolling"keepFileOpen="false"layout="${date:format=HH\:mm\:ss\:ffff}:[${level}] ${callsite} ${onexception:${exception:format=tostring} ${newline}${stacktrace}${newline}"/><!--屏幕彩色打印消息--><target name="console" xsi:type="ColoredConsole"layout="${date:format=HH\:mm\:ss\:ffff}:[${level}] ${message}"/><!--默認(rèn)日志--><target xsi:type="File" name="defaultLog" fileName="${logdir}/${level}/${shortdate}.log" layout="${date:format=HH\:mm\:ss\:ffff}: ${message} ${onexception:${exception:format=tostring} ${newline}${stacktrace}${newline}" /><target name="warnLog" xsi:type="File"fileName="${logdir}/${level}/${shortdate}.log"layout="${date:format=HH\:mm\:ss\:ffff}: ${logger}${newline}${message} ${onexception:${exception:format=tostring} ${newline}${stacktrace}${newline}" /><target name="seq" xsi:type="BufferingWrapper" bufferSize="1000" flushTimeout="2000"><target xsi:type="Seq" serverUrl="http://devlogs.yourdomain.com" apiKey="DRkZrdeDMZIXY0gzZGXB"><property name="ThreadId" value="${threadid}" as="number" /><property name="MachineName" value="${machinename}" /><property name="Environment" value="Development" /><!--https://github.com/NLog/NLog/wiki/Logger-Layout-Renderer--><property name="Logger" value="${logger}" /><!--https://github.com/NLog/NLog/wiki/AspNet-Request-IP-Layout-Renderer--><property name="IP" value="${aspnet-request-ip}" /><!--https://github.com/NLog/NLog/wiki/AspNetRequest-Url-Layout-Renderer--><property name="Url" value="${aspnet-request-url:IncludeHost=true:IncludePort=true:IncludeQueryString=true:IncludeScheme=true}" /><property name="Code" value="${aspnet-response-statuscode}" /></target></target></targets><rules><logger name="*" minlevel="Trace" writeTo="seq" /><logger name="*" levels="Trace,Debug,Info" writeTo="console,defaultLog" /><logger name="*" minlevel="Warn" writeTo="console,warnLog" /></rules> </nlog>

集成之后，我們就可以非常方便的在Seq的面板上看到各種日志和圖表了。

轉(zhuǎn)載是一種動(dòng)力 分享是一種美德

如果喜歡作者的文章，請(qǐng)關(guān)注【麥扣聊技術(shù)】訂閱號(hào)以便第一時(shí)間獲得最新內(nèi)容。本文版權(quán)歸作者和湖南心萊信息科技有限公司共有，歡迎轉(zhuǎn)載，但未經(jīng)作者同意必須保留此段聲明，且在文章頁面明顯位置給出原文連接，否則保留追究法律責(zé)任的權(quán)利。

文檔官網(wǎng)：docs.xin-lai.com

QQ群：

編程交流群<85318032>?

產(chǎn)品交流群<897857351>

總結(jié)

以上是生活随笔為你收集整理的使用Seq搭建免费的日志服务的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。