# Monitor iOS apps: The Sentry way > Has it ever happened to you that a customer call and says: "The app crashes"? You start wonder why and you ask the client what he was doing when app crashes. If you're lucky he remembers and you've a point to start with. I did it for a while, but it was a mess and time consuming and when the bugs seems went away, here they come again. Out there there are many services for app monitoring and in my company we decided to adopt one: [Sentry](https://sentry.io/welcome/?utm_source=google&utm_medium=cpc&utm_campaign=9575834316&utm_content=g&utm_term=sentry&gclid=Cj0KCQiAnuGNBhCPARIsACbnLzrWNw5QJ48-AAu7vO7_pkh9yWNaCrLX6-vM5zpTsj2OCnOujGd6mxAaApoMEALw_wcB). *Hey, but what do you mean with monitoring? * We can say a lot of things, but I think that one of the most important is to **know which uncaught crashes happens runtime**. So I'll keep it simple and I'll explain how to monitor this kind of events -> **these are the initial client question!** 😜 Sentry has a generous free tier and I'll explain 1. how I integrated it in an iOS app 2. the problem I found without previous knowledge about crash monitoring ## How to connect an app to Sentry The [official docs](https://docs.sentry.io/platforms/apple/guides/ios/) is well explained for the *Installation* and *Configure* part, but there is an option not cited in the docs that help keeps things sorted: `environment`property of `option` object ```swift import Sentry func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool { SentrySDK.start{ options in options.environment = "my_env_name" //other options } } ``` Note that I wrote "my_env_name" for the Sentry environment name. What does it mean? Check out your Sentry console. At the top of the screen there is the *environment name*. Each name you'll see is not a particular Sentry environment. Each time a log is sent to Sentry with a new `options.environment` name, Sentry add a new environment to the console, too. **You can name the environment with any name**. Below you can see my console with issues belonging to the "production" environment (I set `options.environment = "production"`). ![Schermata 2021-12-14 alle 23.14.43.jpg](https://cdn.hashnode.com/res/hashnode/image/upload/v1639520614713/STwvY_zq7.jpeg) Now you've a working environment collecting all non caught runtime crashes with the associated stacktrace! But wait! **The stacktrace has something strange** 😕 ![Schermata 2021-12-14 alle 23.32.33.jpg](https://cdn.hashnode.com/res/hashnode/image/upload/v1639521285674/JPp999vXB.jpeg) What are the `` near the app name? And why all other system Apple framework's name have a meaningful name (for example see the last line)? > `` is a placeholder that Sentry puts because it doesn't know the **dSYM**s of your app "I've never heard about it" you may think. Like me! The docs devotes only 4 rows to this important step and initially I thought it was not important: it worked like a charm and I was more concentrated to see if the crash would arrive to the console from the app. By the way: **the crash log are not catched by Sentry if you run the app with an attached debugger**: detach debugger from the `Debug->Detatch from ....` or run the app directly from a device But **what are dSYMs**? Simply debug SYMbols, i.e. the app specific parts that contributed to the exception. For security reason the app doesn't send these debug data and when Sentry receives a crash log it doesn't know how to interpret the crash message from the app. These data are instead visible in a debugging session with the cable plugged in the device we're working with. Ok... Where are they located? First of all, you must know that dSYMs are tied to a specific build of the app. If you're monitoring the app version 1.0.1 you can't use the dSYMs belonging to the 1.0.0 because each dSYM describes the semantics of each memory location (the stack trace is a list of HEX values) and **two different app versions don't share the same memory location in the bitcode** Normally in Xcode the app create dSYM only when we build it in *Release mode* and you can find it in the `DerivedData` folder, usually located at `/Users//Library/Developer/Xcode/DerivedData/`. In this folder you can find a folder named with your app name followed by some characters. If your app name is "MyApp", you could find a folder with a name like "MyApp-dhgdhfgjsghfgshs". Step into that folder and descend the tree until `Build/Products/`, then you may have a folder with a name like "Release-iphoneos" or whatever, depending which dSYM you've generated during the build (see the screenshot below) and finally in this folder you can find a file (**which is a folder practically**) with extension `.app.dSYM`. ![Schermata 2021-12-14 alle 23.53.44.jpg](https://cdn.hashnode.com/res/hashnode/image/upload/v1639522554810/SeRHCB9T6.jpeg) Step into the `.app.dSYM` folder until `.app.dSYM/Contents/Resources/DWARF` and you'll find a single file called as your app name. We'll call it "TO_CHECK" Then run the following command ``` sentry-cli difutil check ``` This will check if the dSYMs we want to upload to sentry are ok. You should have an output like this. ![Schermata 2022-02-17 alle 10.40.39.jpg](https://cdn.hashnode.com/res/hashnode/image/upload/v1645091439075/AK0rqtbZO.jpeg) If you don't have `sentry-cli` [install it](https://github.com/getsentry/sentry-cli/releases) *Ok... we've almost end!* Now we actually have to upload the dSYMs of the entire app, including frameworks! From the [docs](https://docs.sentry.io/platforms/apple/guides/ios/dsym/#uploading-symbols-with-sentry-cli) we can see the command ``` sentry-cli --auth-token YOUR_AUTH_TOKEN upload-dif --org YOUR_ORG_SLUG --project YOUR_PROJECT_SLUG PATH_TO_DSYMS ``` "PATH_TO_DSYMS" **is plural**. How can we upload all the dSYMs in a shot with the certainty of doing everything correctly? We've to upload the `.xcarchive` file **corresponding to the latest build we're monitoring on Sentry**. Ok: where I can find the `.xcarchive` file? Go to `Xcode -> Window -> Organizer -> Archives`. Right click on the release we're dealing with and *Show in finder*. The archives are usually located at `/Users//Library/Developer/Xcode/Archives`. Run the following command: ``` sentry-cli --auth-token upload-dif --org --project --log-level=debug .xcarchive ``` You should have an output like this ![Schermata 2022-02-17 alle 11.02.55.jpg](https://cdn.hashnode.com/res/hashnode/image/upload/v1645092372745/r0qUNuQTQ.jpeg) To make sure everything is ok, go to your sentry web console -> `Settings -> Projects ->