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.

Features

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.

Supported platforms

The Splunk Mint SDKs are available for the following platforms and programming languages:

• Android (Java)
  • Splunk MINT SDK for Android Developer Guide
  • Splunk MINT SDK for Android API Reference
• iOS (Objective-C and Swift)
  • Splunk MINT SDK for iOS Developer Guide
  • Splunk MINT SDK for iOS API Reference
• REST
  • Splunk MINT REST API Developer Guide

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:

• Xamarin
• Apache Cordova
• PhoneGap
• Sencha
• Dojo Mobile
• Appcelerator Titanium
• Unity
• 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:

• Splunk MINT SDK for Xamarin Android (readme)

• Splunk MINT SDK for Xamarin iOS (readme)

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?

1. Sign up for Splunk MINT.

To get started with Splunk MINT, you must be a Splunk MINT customer. Sign up now for a free 15-day trial.

2. Get the Splunk MINT SDKs.

For each platform your app runs on, download the corresponding Splunk MINT SDK or plugin:

• Android
• iOS
3. Create projects for your mobile apps in Splunk MINT Management Console.

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:



4. Integrate MINT into your mobile apps.

Paste the line of code that contains your API key into your mobile app code to integrate MINT. (See specific instructions for Android and iOS).

Repeat steps 3-4 for each of the mobile apps you want to monitor, creating one project for each platform/release stage combination.

5. Verify that MINT Management Console is displaying data from your mobile apps.

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.

6. Get the Splunk MINT App for Splunk Enterprise.

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?

• See the MINT documentation for more information about MINT Management Console, the Splunk MINT App, and the Splunk MINT SDKs.
• See the Splunk MINT Help Desk for customer support, answers to frequently-asked questions, and the knowledge base.