Facilitates flexible logging by separating log destination, supporting pluggable loggers, and allowing configuration for different application variants. Targets both developer and business analytics needs.
This repository contains the logging modules that you can leverage for logging within you applications. The values of the library are the following:
The above values are achieved through a breakup of artifacts produced by this repository and an application of the facade pattern. The facade only gives you the capability to log an analytic event or a dev metric--it doesn't send that log anywhere. It is the consumer's responsibility to configure the logging library to send those analytics and dev metrics to the desired destination.
The following table describes the artifacts produced by this repositoryEach artifact has a different purpose, and they build upon one-another. The combination of libraries that you should use depends upon your environment
So, if you have an Android project, not only do you have abstractions for a logging facade (logging), but you also have an abstraction for integrating with Microsoft AppCenter, Google Firebase, NewRelic, and Urban Airship. If you don't have an Android app, then you need to implement the FSEventLogger and FSDevMetricsLogger interfaces yourself.
This is the base (multiplatform) library that you'll need to include for any project (if you are using one of the other artifacts, you'll get this artifact transitively). This library contains the core logging code that consumers are intended to use when logging analytics events or dev metrics and contains the definitions of the interfaces that consumers may implement to ensure their analytics events and dev metrics are sent to the appropriate destination. Learn more here: logging.
You should likely only use this in your app's debug configuration. It has some valuable classes for adding analytics and dev metrics logs locally to the device. For more details, see logging-android-debug.
This contains implementations of FSEventLogger and FSDevMetricsLogger interfaces specific to Microsoft AppCenter's Analytics Android integration (version 3). For more details, see logging-android-appcenter3. You probably shouldn't use this one, though. Use it only if you happen to still be using their major version 3. Otherwise, use the library below.
This contains implementations of FSEventLogger and FSDevMetricsLogger interfaces specific to Microsoft AppCenter's Analytics Android integration (version 3). For more details, see logging-android-appcenter4.
This contains implementations of FSEventLogger and FSDevMetricsLogger interfaces specific to Google Firebase's Analytics and Crashlytics Android integration. For more details, see logging-android-firebase.
This contains implementations of FSEventLogger and FSDevMetricsLogger interfaces specific to the NewRelic Android Agent. For more details, see logging-android-newrelic.
This contains implementations of FSEventLogger and FSDevMetricsLogger interfaces specific to the Airship analytics. For more details, see logging-android-newrelic.
In an ideal scenario, you would know exactly what your users wanted, how they want to interact with your application, and how the application can maximize its value prior to developing the application. Additionally, in an ideal scenario, you'd develop an application that is capable of meeting the customer need and providing maximum value. This suite of libraries attempts to provide an API around the measurement and analytics tools you use to determine success/failure at both indicators of success.
Logging events facilitates two purposes:
Like other libraries, there are some gotchas with this one. See the following
Warning In order to avoid an infinite loop, you should not log from within a logger unless you specify the
destinationsparameter that the same logger will not be reinvoked or you have otherwise guaranteed that an infinite loop will not be created.
| Library | Analytics Framework | Platform |
|---|
| logging | nonspecific | Android/JVM/iOS/JavaScript/Mac(X64)/Linux(X64) |
| logging-android-appcenter3 | Microsoft AppCenter | Android |
| logging-android-appcenter4 | Microsoft AppCenter | Android |
| logging-android-debug | nonspecific | Android |
| logging-android-firebase | Google Firebase | Android |
| logging-android-newrelic | NewRelic | Android |
| logging-android-newrelic | Urban Airship | Android |
Surfaced from shared tags and platforms — no rankings paid for.