帮助手册

NLog 日志

NLog 是 Windows .NET 应用程序和 C# 中广泛使用的日志框架。Site24x7 AppLogs 是一款独特的云端日志管理服务,帮助您轻松管理日志。Site24x7 代理自动检测机器上基于 NLog 的日志,并识别日志字段,如日期和时间、日志级别、记录器名称和消息。凭借对 NLog 日志的默认支持,您可以借助直观的 Web 客户端搜索、查看、收集和分析数据。了解更多关于 Site24x7 日志管理的信息

您可以使用以下任一方法推送 NLog 日志:

使用代理

  1. 登录您的 Site24x7 账号。
  2. 下载并安装 Site24x7 服务器监控代理(Windows)。
  3. 前往 Admin > AppLogs > Log Profile,然后点击添加日志配置文件
  4. 选择日志类型中选择 NLog
  5. NLog 日志从以下文件夹路径获取。如果您的日志存储在其他文件夹中,可以在创建日志配置文件时在搜索日志的文件列表中指定该文件夹。
    C:\\NLog\\.log
    注意

    此处提供的日志文件路径仅供参考。默认情况下,Site24x7 会运行脚本以查找特定文件路径。

  6. 选择收集日志的服务器监视器,然后保存配置文件。

不使用代理

  1. 登录您的 Site24x7 账号。
  2. 前往 Admin > AppLogs > Log Type,然后点击添加日志类型
  3. 选择日志类型中选择 NLog
  4. 启用 API 上传
  5. 复制 HTTPS 端点 URL。
  6. 点击保存
  7. 下载以下 NLog 配置 XML 文件并更新您的应用程序。将 '<ENDPOINT-URL>' 替换为上述第 5 步中复制的 URL。
    <?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" 
          throwConfigExceptions="true"
          internalLogLevel="Off"
          internalLogToConsole="false"
          internalLogFile="C:\home\LogFiles\nlog-internal-logs.txt"
    >
     <extensions>
     <add assembly="NLog.Targets.Http" />
     </extensions>
     <targets>
     <target name='site24x7-logs' 
                type='HTTP' 
                URL='<ENDPOINT-URL>'
                BatchSize='100'
                ContentType='application/json'
        >
    <layout type='JsonLayout'>
     <attribute name='loglevel' layout='${level:upperCase=true}' />
     <attribute name='message' layout='${message}' />
     <attribute name='datetime' layout='${longdate}' />
     <attribute name='_zl_timestamp' layout='${replace:inner=${unixtime:universalTime=true}:searchFor=.:replaceWith=}' /> 
     <attribute name='s247agentuid' layout='logsource' />
     </layout>
     </target>
     </targets>
     <rules>
     <logger name="*" minlevel="Debug" writeTo="site24x7-logs" />
     </rules>
    </nlog>
  8. 如果 NLog 中没有"NLog.Targets.Http"包,请安装该包。Site24x7 在 NLog 中使用此包来批量处理日志消息并将其上传到我们的服务器。

日志模式

$DateTime:date$ $LogLevel$ $SourceFileName$ $Line:number$ - $Message$

这是 Site24x7 根据以下示例日志为解析 NLog 日志定义的默认模式。

示例日志

2017-07-02 20:52:39,342 DEBUG className 200 - This is debug message

上述示例日志可拆分为 4 个字段,每个字段将从此处获取对应的值,然后上传到 Site24x7。

 字段名称  字段值
DateTime 2017-07-02 20:52:39,342
LogLevel DEBUG
SourceFileName className
Line 200
Message This is debug message   

本文档对您有帮助吗?

您愿意帮助我们改进文档吗?请告诉我们哪些方面可以做得更好。


很抱歉本文档未能让您满意。我们希望了解可以从哪些方面改进您的体验。


感谢您抽出时间分享反馈。我们将利用您的反馈来改进在线帮助资源。

短链接已复制!