Splunk MINT SDK for iOS (Legacy)

Splunk MINT SDK for iOS Developer Guide

Acrobat logo Download manual as PDF


Splunk MINT is no longer available for purchase as of January 29, 2021. Customers who have already been paying to ingest and process MINT data in Splunk Enterprise will continue to receive support until December 31, 2021, which is End of Life for all MINT products: App, Web Service (Management Console), SDK and Add-On.
This documentation does not apply to the most recent version of Splunk MINT SDK for iOS (Legacy). For documentation on the most recent version, go to the latest release.
Acrobat logo Download topic as PDF

Configure your project for symbolication

Before you can analyze crash reports, the stack traces need to be symbolicated―that is, replacing memory addresses with human-readable function names and line numbers. These debug symbols are contained in dSYM bundles that are updated periodically.

You can configure symbolication on the server or on the device. However, server-side symbolication yields better symbolication results.

Note If you enable bitcode in your application, MINT crash reports will not be symbolicated. For details, see Bitcode support.

Configure server-side symbolication

  1. In Xcode, open your project and select the target.
  2. Make sure that your binary name (usually the target name) contains only Latin characters (e.g., only those within ISO-8859-1 character set also known as Latin-1) and no spaces. Otherwise, symbolication may not be successful.
  3. On the Build Settings tab, verify the following are set for all configurations (typically Debug and Release):
    • Strip Debug Symbols During Copy: Yes
    • Strip Linked Product: Yes
  4. On the Build Phases tab, click the + symbol, then click New Run Script Phase.
  5.  New run script.png
    
  6. In the script editor, add the following script:
  7. SCRIPT=`/usr/bin/find "${SRCROOT}" -name splunkmint_postbuild_dsym_upload_script.sh | head -n 1`
    /bin/bash "${SCRIPT}" "API_KEY" "API_TOKEN"

    Be sure to replace API_KEY and API_TOKEN with your MINT API key and API token, respectively. (To find your API token, go to MINT Management Console, then go to Account > Account Info.)

    Note This script is designed to run on released builds only. (The Xcode console displays symbolicated stack traces when you run your app in debug mode.)
  8. To test the configuration, configure the project schema for release and build your project. If the build succeeds, symbolication should be set up correctly.

Configure on-device symbolication

You can symbolicate the crash reports on the device, although on-device symbolication does not provide as much useful information, such as the line of code that crashed your application.

Note Do not configure your mobile app for on-device symbolication if you are targeting iOS version 9.
  1. In Xcode, open your project and select the target.
  2. On the Build Settings tab, verify the following are set for all configurations (typically Debug and Release):
    • Strip Debug Symbols During Copy: No
    • Strip Linked Product: No
    • Deployment Postprocessing: No
    • Generate Debug Symbols: Yes
Last modified on 07 October, 2015
PREVIOUS
Requirements and installation for iOS
  NEXT
Add Splunk MINT to your iOS project

This documentation applies to the following versions of Splunk MINT SDK for iOS (Legacy): 4.4.x


Was this documentation topic helpful?


You must be logged into splunk.com in order to post comments. Log in now.

Please try to keep this discussion focused on the content covered in this documentation topic. If you have a more general question about Splunk functionality or are experiencing a difficulty with Splunk, consider posting a question to Splunkbase Answers.

0 out of 1000 Characters