Relay: A remote logger for CocoaLumberjack.
Monitoring fatal crash rates are essential - especially on iOS where submitting a critical bug fix
is at the mercy of the app review team - but what about nonfatals that prevent or hamper your user's experience? Relay makes it easy to send logs to Logstash, Graylog, Splunk, and other log aggregators. Designed around unreliable mobile connections, Relay leverages URLSessionUploadTask
s to pass log data to the system process ASAP so you don't need to cross your fingers and hope the log uploads before the app is suspended. Pending log uploads are persisted across system reboots, and have a default retry behavior to ensure log data gets successfully sent.
- Given this is a logger for CocoaLumberjack, CocaLumberjack is required.
- Realm is used to maintain the log records created from each
DDLogMessage
passsed from CocoaLumberjack. Each createdRelay
maintains it's own SQLite database located in the Documents folder on iOS.
Add the following to your Cartfile:
github zerofinancial.com/relay ~> 0.0.0
Be sure to add Relay
and Realm
to your Carthage run script.
Download the latest framework binary off the releases page, and Realm. Add them to your project, set the proper framework search paths, and you're ready to go.
Take a look at the documentation for all configurable options.
Relay is licensed under either of
- Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT).
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you shall be dual licensed as above, without any additional terms or conditions.
Relay is maintained by Zero by Evan Kimia. The names and logos for Zero and Relay are trademarks of Zero Financial Inc. Follow our blog or say hi on twitter @zerofinancial.