About the Splunk MINT SDKs
Splunk MINT allows you to gain mobile intelligence about your mobile apps by using the Splunk MINT SDKs with your existing mobile app projects. Then, you can use Splunk MINT Management Console and the Splunk MINT App to monitor and gain insights into all of your mobile apps.
In addition to sending crash reports, you can send additional data to Splunk MINT to monitor specific actions and items in your mobile apps.
- Monitor transactions. Track any process in your app from start to finish and identify slow transactions that negatively affect the user experience.
- Add and report events. Add events to your code and report them to track virtually any user activity on your app.
- Report handled exceptions. Log handled exceptions that occur, along with any custom information you want to add.
- Add custom data and breadcrumbs to crash reports. Add custom data to your crash reports as key-value pairs. You can also add breadcrumbs to your code to tag events or actions, which are also included in crash reports.
- Report user-specific data. Track the experience of any given user by adding user identifiers to your code, then you can search for errors that affected a particular user and examine the corresponding crash data.
- Send log output. Collect and view system debug messages depending on the platform. For example, send LogCat output from Android devices or NSLog messages from iOS devices.
- Report debug messages. Display debug messages during testing before you deploy to production.
- Monitor hybrid pages. Use WebView monitoring to track any hybrid pages that are not written in native code.
The Splunk Mint SDKs are available for the following platforms and programming languages:
- Android (Java)
- iOS (Objective-C and Swift)
Splunk MINT supports the following mobile apps:
- Native apps on iOS and Android
- Hybrid apps on iOS and Android
Although the MINT SDKs might work with these mobile app platforms, Splunk MINT does not officially support them:
- Apache Cordova
- Dojo Mobile
- Appcelerator Titanium
- Google Sparrow
Splunk MINT SDKs for Xamarin
The previous BugSense SDKs for Xamarin have been released as Splunk MINT SDKs on GitHub as open source projects under the Apache 2.0 License. If you want to continue using Xamarin Android or Xamarin iOS with Splunk MINT, get the open source SDKs from these repositories:
The Splunk MINT SDKs for Xamarin are not officially supported by the Splunk MINT team. If you use these SDKs, you must rely on the community for support and maintenance builds.
How does Splunk MINT work?
Splunk MINT has several components that work together:
- The Splunk MINT SDKs integrate MINT into your mobile apps with only one line of code. The SDKs are available for several platforms.
- Mobile apps with Splunk MINT send data to the MINT Data Collector, which then forwards the data to Splunk MINT Management Console and the Splunk MINT App. For more, see About Splunk MINT data collection.
- The cloud-based Splunk MINT Management Console shows you seven days of information about crashes, usage, and performance for each individual MINT project (a MINT project corresponds to one mobile app on one platform).
- The Splunk MINT App in Splunk Enterprise provides dashboards, saved reports, and search functionality allowing you to view data for all of your MINT app projects together, over all time, to gain powerful insights about all channels of your organization.
For a detailed comparison, see What's the difference between the Splunk MINT Management Console and the Splunk MINT App?.
How do I monitor mobile apps with Splunk MINT?
- Sign up for Splunk MINT.
- Get the Splunk MINT SDKs.
To get started with Splunk MINT, you must be a Splunk MINT customer. Sign up now for a free 15-day trial.
For each platform your app runs on, download the corresponding Splunk MINT SDK or plugin:
Log in to Splunk MINT Management Console and create a project for one variation of your mobile app (a platform and release stage, such as Android/Testing, or iOS/Release). You'll get an API key and a line of code to add for that particular platform—copy it to your clipboard:
Repeat steps 3-4 for each of the mobile apps you want to monitor, creating one project for each platform/release stage combination.
When you start using your mobile apps, they will begin to send data to the Splunk MINT Data Collector. Go back to MINT Management Console and open your mobile app projects. You'll start to see data appear in your dashboards in minutes.
After you've set up your mobile app projects in MINT Management Console, use the Splunk MINT App in Splunk Enterprise to see aggregated data for all of your mobile app projects over all time.
- Contact your sales representative to sign up for the Splunk MINT App.
- See the Splunk MINT App User Guide for information about installing, configuring, and using the Splunk MINT App.
What are the keys and tokens used by MINT?
The following table summarizes the different keys and tokens used by Splunk MINT.
|Name||What is it?||Where is it?|
|API key||Identifies a specific mobile app project and is generated for each new project you create in Splunk MINT Management Console.||On the MINT Management Console home page, one key per project.|
|API token||Identifies your Splunk MINT account, and is used to provide authentication when integrating third-party apps such as HipChat or when using the dSYM uploader script.||In MINT Management Console, under Account > Account Info.|
Where can I get help?
This documentation applies to the following versions of Splunk MINT™ SDK for iOS (Legacy): 4.2.x, 4.3.x, 4.4.x