Skip to content
[Obsoleted] A log collector for iOS (new version! -> https://github.com/cookpad/Puree-Swift)
Branch: master
Clone or download
slightair Merge pull request #19 from giginet/fix-dependency-version
Modify pessimistic version for YapDatabase
Latest commit c3e5a7b May 18, 2017
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
Example Modify pessimistic version for YapDatabase May 18, 2017
Pod Remove databaseReadWriteCompletionQueue Nov 1, 2016
images
.gitignore Fix test case for Xcode7/Swift2 Sep 27, 2015
.gitmodules Remove submodules Sep 27, 2015
.travis.yml Update Cocoapods Nov 1, 2016
LICENSE Initial commit Dec 10, 2014
Puree.podspec Modify pessimistic version for YapDatabase May 18, 2017
README.md Update README.md Oct 9, 2016

README.md

Puree

Version License Platform Travis

Description

Puree is a log collector which provides some features like below

  • Filtering: Enable to interrupt process before sending log. You can add common params to logs, or the sampling of logs.
  • Buffering: Store logs to buffer until log was sent.
  • Batching: Enable to send logs by 1 request.
  • Retrying: Retry to send logs after backoff time automatically if sending logs fails.

Puree helps you unify your logging infrastructure.

Usage

Configure Logger

// Swift

let configuration = PURLoggerConfiguration.default()
configuration.filterSettings = [
    PURFilterSetting(filter: ActivityFilter.self, tagPattern: "activity.**"),
    // filter settings ...
]
configuration.outputSettings = [
    PUROutputSetting(output: ConsoleOutput.self,   tagPattern: "activity.**"),
    PUROutputSetting(output: ConsoleOutput.self,   tagPattern: "pv.**"),
    PUROutputSetting(output: LogServerOutput.self, tagPattern: "pv.**", settings:[PURBufferedOutputSettingsFlushIntervalKey: 10]),
    // output settings ...
]

let logger = PURLogger(configuration: configuration)
// Objective-C

PURLoggerConfiguration *configuration = [PURLoggerConfiguration defaultConfiguration];
configuration.filterSettings = @[
    [[PURFilterSetting alloc] initWithFilter:[ActivityFilter class]
                                  tagPattern:@"activity.**"],
    // filter settings ...
];
configuration.outputSettings = @[
    [[PUROutputSetting alloc] initWithOutput:[ConsoleOutput class]
                                  tagPattern:@"activity.**"],
    [[PUROutputSetting alloc] initWithOutput:[ConsoleOutput class]
                                  tagPattern:@"pv.**"],
    [[PUROutputSetting alloc] initWithOutput:[LogServerOutput class]
                                  tagPattern:@"pv.**"
                                  settings:@{PURBufferedOutputSettingsFlushIntervalKey: @10}],
    // output settings ...
];

PURLogger *logger = [[PURLogger alloc] initWithConfiguration:configuration];

Expected result

tag name                 [ Filter Plugin ]  -> [ Output Plugin ]
-----------------------------------------------------------------
activity.recipe.view  -> [ ActivityFilter ] -> [ ConsoleOutput ]
activity.bargain.view -> [ ActivityFilter ] -> [ ConsoleOutput ]
pv.recipe_detail      -> ( no filter )      -> [ ConsoleOutput ], [ LogServerOutput(FlushInterval:10sec) ]
event.special         -> ( no filter )      -> ( no output )

Post log

Post log object(anyObject) in an arbitrary timing.

// Swift

logger.post(["recipe_id": "123"], tag: "pv.recipe_detail")
// Objective-C

[logger postLog:@{@"recipe_id": @"123"} tag: @"pv.recipe_detail"]

Plugins

You can create plugins. See Create Plugins

Tag system

Tag

Tag is consisted of multiple term split by .. For example activity.recipe.view, pv.recipe_detail. You can specify tag to log freely.

Pattern

Filter, Output and BufferedOutput plugins is applied to tag matched logs. You can specify tag pattern for plugin reaction rules.

Simple pattern

Pattern aaa.bbb match tag aaa.bbb, not match tag aaa.ccc (Perfect matching).

Wildcard

Pattern aaa.* match tags aaa.bbb, aaa.ccc. Not match tags aaa, aaa.bbb.ccc (single term).

Pattern aaa.** match tags aaa, aaa.bbb and aaa.bbb.ccc. Not match tag xxx.yyy.zzz (zero or more terms).

Installation

Puree is available through CocoaPods. To install it, simply add the following line to your Podfile:

pod "Puree"

Author

Tomohiro Moro, tomohiro-moro@cookpad.com

License

Puree is available under the MIT license. See the LICENSE file for more info.

You can’t perform that action at this time.