PaperTrailLumberjack

PaperTrailLumberjack 是一个 CocoaLumberjack 记录器，帮助将日志语句记录到您的日志目的地 papertrailapp。它可以使用 TCP 和 UDP 列日志 - 默认使用 TCP（带有 TLS）。

使用方法

要运行示例项目；克隆仓库，并在首先从 Example 目录运行 pod install。

示例 UDP 日志记录

RMPaperTrailLogger *paperTrailLogger = [RMPaperTrailLogger sharedInstance];
paperTrailLogger.host = @"destination.papertrailapp.com"; //Your host here
paperTrailLogger.port = 9999; //Your port number here    
paperTrailLogger.useTcp = NO;
[DDLog addLogger:paperTrailLogger];
DDLogVerbose(@"Hi PaperTrailApp.com);

示例 TCP 日志记录（带有 TLS）

RMPaperTrailLogger *paperTrailLogger = [RMPaperTrailLogger sharedInstance];
paperTrailLogger.host = @"destination.papertrailapp.com"; //Your host here
paperTrailLogger.port = 9999; //Your port number here    
[DDLog addLogger:paperTrailLogger];
DDLogVerbose(@"Hi PaperTrailApp.com");

您的日志消息将自动格式化为符合 syslog 规范，通常在日志前加上机器名和程序名，以及时间戳。为了保护用户隐私，PaperTrailLumberjack 使用设备独特的 UUID（UUID 是随机的，每次删除并重新安装应用程序时都会重置）。程序名称是删除空格的程序包名称。为了保护用户隐私，PaperTrailLumberjack 使用设备独特的 UUID（UUID 是随机的，每次删除并重新安装应用程序时都会重置）。程序名称是删除空格的程序包名称。

示例日志输出

May 08 23:20:59 0A3F9C64-D271-452F-AD6E-8052BBD3F789 PaperTrailLumberjackiOSExample: 60b PaperTrailLumberjackiOSExampleTests@testUdpLogging@62 "Hi PaperTrailApp.com"

默认情况下，PaperTrailLumberjack 使用 UUID 作为机器名，使用应用程序的包显示名称作为程序名。这些可以按照以下方式重写

paperTrailLogger.machineName = @"My Custom Machine";
paperTraiLogger.programName = @"My Program";

在用户定义的机器和程序名称中（如果有的话）的空白字符将在记录之前被删除。示例输出

May 08 23:20:59 MyCustomMachine MyProgram: 60b PaperTrailLumberjackiOSExampleTests@testUdpLogging@62 "Hi PaperTrailApp.com"

安装

PaperTrailLumberjack 可以通过多种方法安装

1. PaperTrailLumberjack 通过 CocoaPods 提供

   要安装它，

   • Objective-C 项目

   请将以下行添加到 Podfile 文件中

   use_frameworks!
   
   target "YourTargetName" do
      pod "PaperTrailLumberjack"
   end
   

   在您的项目中，导入 PaperTrailLumberJack 头文件

   import <PaperTrailLumberjack/PaperTrailLumberjack.h>
   

   • Swift 项目，

   请将以下行添加到 Podfile 文件中

   use_frameworks!
   
   target "YourTargetName" do
      pod "PaperTrailLumberjack/Swift"
   end
   

   在您的项目中，导入 PaperTrailLumberJack

   import PaperTrailLumberjack
   

2. 通过 Carthage

   Carthage 是一个轻量级依赖管理器，与 Cocoapods 相比，它不那么侵入性。要使用 Carthage 安装，请将以下条目添加到 Cartfile，并遵循此处列出的说明 here

   git "https://bitbucket.org/rmonkey/papertraillumberjack.git"
   

   您将必须对 Carthage 进行非二进制构建（否则 CocoaLumberjack-Swift 无法构建）

   carthage update --no-use-binaries
   

作者

George Malayil-Philip，[email protected]

Rogue Monkey Technologies & Systems Private Limited

许可协议

PaperTrailLumberjack 在 MIT 许可协议下提供。有关更多信息，请参阅 LICENSE 文件。