Under the Bridge

A Forest Of Loggers

So since we moved off Lightspeed Pascal as our Macintosh development environment way back in the day, we’ve been toting around this suite of logging, timing, and so forth debugging macros that by this time can be called transparently from .c/.cpp/.m/.mm files in development environments ranging from Lightspeed C through Metrowerks CodeWarrior up to Xcode 6+; but as we gear up to take on our intended New Year’s resolution of shipping a full hand of Swift apps next year … oh wait, there’s no macros in .swift code now! Well, there goes two and a half decades of accumulated cleverness out the window, bah humbug.

Not that it would be too terribly hard to rewrite said suite using NDEBUG and @autoclosure like assert(), but why bother with that when no doubt there’s somebody else’s projects for native Swift logging out there doing that already we can join? And why yes, here’s two that the exemplarily diligent ManiacDev folk have turned up on Github:

XCGLogger looks considerably more active than Swell, so we’ll go with that one. Unless any of you Dear Readers have an excellent reason why not. But long as we’re on the topic, let’s take a look at what Objective-C options checking CocoaPods brings up that we could raid for feature additions … my, there are a lot, aren’t there now?

  • CCLogSystem (5/54/18) “A Log system for iOS.Support print, record and review logs.”
  • CocoaLumberjack (270/4131/705) “A fast & simple, yet powerful & flexible logging framework for Mac and iOS”
  • DLLog (1/2/1) “NSLog-like logging API with support for level and context filtering”
  • GRLogger (1/2/1) “a logger utility for debugging and tracing”
  • LibComponentLogging (5/101/13) “Logging for Objective-C with log levels and log components.”
  • Log4Cocoa (12/80/29) “is a Log4j port for iOS and Mac OS X”
  • MTLog(11/218/24) (ManiacDev) “NSLog replacement for coders!”
  • NALog (1/3/0) “An easy, lightweight, and simple NSLog-based logging tool”
  • NBULog (13/22/5) “Log framework based on CocoaLumberjack…”
  • NSLogger (147/2447/299) “A modern, flexible logging tool”
  • NWLogging (7/14/4) “A minimalistic logging framework for Cocoa”
  • OCLogTemplate (8/9/3) “A flexible logging header for Objective-C”
  • TFLogger (7/2/0) “Dependency free logging library”
  • TULogging (1/7/0) “Better logging that uses ASL log levels”
  • UALogger (11/235/21) “A powerful and flexible logging utility for Mac/iOS apps”
  • WZLog (1/2/0) “A log system for iOS” … and that’s about it not in Japanese.
  • XLFacility (8/97/2) “Elegant and extensive logging facility for OS X & iOS (includes database, Telnet and HTTP servers)”

CocoaLumberjack is pretty much the venerably accepted standard, as the numbers there attest, but some of these othes look interesting too. Particularly that very last one, XLFacility; from the ManiacDev writeup,

Some of the features of XLFacility include:

  • Viewing of logging messages in real-time via Telnet or TCP
  • An HTTP server for viewing real-time log messagess and browsing past logging messages
  • Different logging levels, and macros for easy logging at each level
  • Customizable logging formats
  • An in-app logging overlay that can appear when messages are sent to XLFacility
  • A nice syntax for creating your own custom loggers

With XLFacility you can log to the console, a file, a SQLite database, and you can also view messages in realt-time via Telnet or TCP and there is a built-in http server so you can browse past log messages or see live updates…

That’s some serious feature-laden logging there, that is.

UPDATES:

ZHSwiftLogger: “…will use println() for development and use NSLog() for production.”

PrintlnMagic “An alternative for Swift’s println() function along the lines of DLog.”

SwiftLog “Simple and easy logging in Swift.”

Debug Logging In Swift

Teleport-NSLog: Open Source Library Enhancing NSLog Allowing You To Log To A Remote Server

CleanroomLogger: “provides a simple, lightweight and performant logging API written in Swift”

Learn How People Use Your App – an App Analytics Tools Round-up

ARAnalytics : “is a analytics abstraction library offering a sane API for tracking events and user data. It currently supports on iOS: TestFlight, Mixpanel, Localytics, Flurry, GoogleAnalytics, KISSmetrics, Crittercism, Crashlytics, Bugsnag, Countly, Helpshift, Tapstream, NewRelic, Amplitude, HockeyApp, ParseAnalytics, HeapAnalytics, Chartbeat, Yandex Mobile Metrica, and Branch. And for OS X: KISSmetrics and Mixpanel.”

ARAnalyticsLogger: “A bridge between CocoaLumberjack and ARAnalytics,” derived from CrashlyticsLumberjack

Aspect-Oriented Programming and ARAnalytics

Swiftalytics: “A declarative Swift DSL for your view tracking needs.”

2
  • http://www.kreutzberger.com/ Sebastian Kreutzberger

    Hi, please check out SwiftyBeaver. It is a new Swift Logger which provides many things other loggers are missing:

    – writes to Console and / or file
    – color in Xcode & Terminal
    – fast because it runs in own background thread
    – very lightweight & memory-saving
    – can be called with standard log.debug(“foo”) syntax

  • knly

    I would also appreciate your input on my logging framework `Evergreen`. It’s modeled after Python’s excellent `logging` module with adjustable log levels and everything you would expect from a logging framework:

    http://www.github.com/viwid/Evergreen

    It’s based on a logger hierarchy that also allows you to adjust the verbosity of parts of your software, e.g. lower the log level for the part you are currently debugging. This also gives users of your framework the opportunity to configure the verbosity of your logging.

    Any feedback welcome :)