Open-Source Observability · CocoaLumberjack

CocoaLumberjack

CocoaLumberjack is a logging framework for Apple platforms (iOS, macOS, tvOS, watchOS, visionOS) that replaces NSLog with faster, more flexible logging. It supports multiple simultaneous log destinations (console, files, custom handlers) and integrates with Swift Package Manager, CocoaPods, and Carthage.

Talk to DEV.co Discuss Implementation

Source: GitHub — github.com/CocoaLumberjack/CocoaLumberjack

13.3k

GitHub stars

2.3k

Forks

Objective-C

Primary language

BSD-3-Clause

License (OSI-approved)

Key facts

Objective fields from the source. Values we can't verify are shown as “Unknown” rather than guessed.

Field	Value
Repository	CocoaLumberjack/CocoaLumberjack
Owner	CocoaLumberjack
Primary language	Objective-C
License	BSD-3-Clause — OSI-approved
Stars	13.3k
Forks	2.3k
Open issues	6
Latest release	3.9.1 (2026-04-16)
Last updated	2026-07-01
Source	https://github.com/CocoaLumberjack/CocoaLumberjack

What CocoaLumberjack is

A multi-threaded, dispatch-based logging framework written in Objective-C with Swift bindings. Supports dynamic log level configuration per file/logger, file rolling policies, and acts as a swift-log backend via DDLogHandler. Primary loggers include DDOSLogger (os_log), DDFileLogger, DDTTYLogger, and DDASLLogger.

Quickstart

Get the CocoaLumberjack source

Clone the repository and explore it locally.

terminalbash

1git clone https://github.com/CocoaLumberjack/CocoaLumberjack.git2cd CocoaLumberjack3# follow the project's README for install & configuration

Need it deployed, integrated, or customized instead? DEV.co ships production installs.

Best use cases

Field debugging & crash investigation

Capture verbose logs to local files during deployment, then upload or inspect post-crash. File rolling policies and multi-level logging (by file/logger) make it ideal for tracking rare production bugs.

Multi-destination logging in native Apple apps

Simultaneously log to console, file, and custom handlers (e.g., remote logging) from a single log statement. Flexible per-logger and per-file level configuration suits complex debugging workflows.

Swift + Objective-C hybrid codebases

Native support for both languages via CocoaLumberjackSwift and swift-log integration. Unified logging across mixed-language projects without wrapper overhead.

Implementation considerations

Multiple import patterns depending on integration method: `@import CocoaLumberjack;` for frameworks, `#import <CocoaLumberjack/CocoaLumberjack.h>` otherwise, and `import CocoaLumberjack` for Swift.
Known build issue: legacy Objective-C projects may encounter 'Multiple methods named tag' error; mitigate with `#define DD_LEGACY_MESSAGE_TAG 0` before import.
Swift Package Manager integration requires explicit addition of both `CocoaLumberjack` and `CocoaLumberjackSwift` products to targets; SPM does not always auto-detect the dependency.
File logger configuration (rolling frequency, max log files, compression) must be set explicitly; defaults are available but should be tuned for your app's disk and retention needs.
Minimum deployment targets: iOS 11.0 documented; exact support for tvOS, watchOS, visionOS versions not specified—requires review for older OS versions.

When to avoid it — and what to weigh

Pure Swift-only architecture — If your project is 100% Swift and you have no legacy Objective-C code, swift-log with a simpler backend may reduce complexity. CocoaLumberjack's Objective-C core adds some overhead.
Simple, minimal logging needs — If your app only needs basic console output or simple file logging, the framework's configurability and performance may be overkill. os_log alone might suffice for iOS 10+.
Server-side or non-Apple platforms — CocoaLumberjack is tightly integrated with Apple SDKs (Grand Central Dispatch, os_log, UIKit). Not suitable for server or non-Apple deployment targets.
Strict license restrictions on Objective-C dependencies — If your project prohibits BSD-3-Clause licensed code, you cannot use CocoaLumberjack. Review your legal/compliance policies before adoption.

License & commercial use

BSD-3-Clause (BSD 3-Clause "New" or "Revised" License). A permissive OSI-approved license allowing use in commercial, proprietary, and closed-source software with attribution and liability disclaimer.

BSD-3-Clause is a permissive license. Commercial use is permitted. Ensure you provide a copy of the license and retain the original copyright notice in your distribution. No warranty is provided by the authors. Recommended: include CocoaLumberjack license in your app's legal notices or LICENSES directory.

DEV.co evaluation signals

Editorial assessment — not user reviews. Directional, with an explicit confidence level.

Signal	Assessment
Maintenance	Active
Documentation	Adequate
License clarity	Clear
Deployment complexity	Low
DEV.co fit	Good
Assessment confidence	High

Security considerations

No explicit security claims made. Logging frameworks can inadvertently capture sensitive data (PII, credentials, auth tokens). Implement careful log filtering or sanitization if logging untrusted or sensitive input. File logger writes to local disk (typically app sandbox on iOS); ensure log files are not world-readable and are cleared appropriately. No information provided on encryption of log files at rest or in transit.

Alternatives to consider

os_log + unified logging (native Apple)

Built-in to iOS 10+. Simpler, no dependency. Lower overhead. Suitable if you don't need file persistence or multi-destination logging. Less granular control per file/logger.

swift-log (Apple's open-source logging API)

Swift-native, decoupled from specific backend. Works across platforms. Simpler for pure Swift code. Requires choosing a backend separately. CocoaLumberjack can be a backend, but pure swift-log + simpler backend may reduce complexity.

Glog / NSLog (legacy NSLog)

Minimal setup, no dependency. Extremely limited; slower, no file logging, no level control per file. Only a fallback for basic console output.

Software development agency

Build on CocoaLumberjack with DEV.co software developers

CocoaLumberjack is production-ready and actively maintained. Integrate via CocoaPods, Carthage, or Swift Package Manager today. See the Getting Started guide for step-by-step setup.

Talk to DEV.co

Related open-source tools

Surfaced by semantic similarity across the DEV.co open-source index.

swift-log Pulse Wormholy

Related on DEV.co

Explore the category and the services that help you build with it.

Open-Source Observability Application Development Custom Software Development Talk to DEV.co

CocoaLumberjack FAQ

Is CocoaLumberjack still actively maintained?

Yes. Latest release 3.9.1 is from April 2026, last commit July 2026, with only 6 open issues. The project is not archived and actively developed.

Can I use CocoaLumberjack in a commercial app?

Yes. BSD-3-Clause is a permissive open-source license that permits commercial use. Include a copy of the license and retain copyright notices in your distribution.

Does CocoaLumberjack work with pure Swift?

Yes, via the CocoaLumberjackSwift product and DDLog Swift API. It also integrates as a backend for swift-log. Objective-C code is wrapped for Swift access.

What is the performance impact?

README claims Lumberjack is 'an order of magnitude faster than NSLog' due to multi-threading and lockless atomic operations. No benchmark data provided; requires independent validation for your use case.

Custom software development services

DEV.co helps companies turn open-source tools like CocoaLumberjack into production software. Our software development services cover the full lifecycle — architecture, web development, integration, and maintenance — delivered by software developers and web developers who ship. Engage our software development agency to implement or customize it for your open-source observability stack.

Ready to improve your app's logging?

CocoaLumberjack is production-ready and actively maintained. Integrate via CocoaPods, Carthage, or Swift Package Manager today. See the Getting Started guide for step-by-step setup.

Talk to DEV.co Schedule a Consultation