> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getmonita.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Set Up Global Monitoring - iOS Swift SDK
> This is a step by step guide to setup and manage Monita Global Monitoring Setup/Manage Global Monitoring for iOS Swift
Global Monitoring is an Enterprise feature, which enables companies to agnostically monitor network requests departing your client.
### Instructions
1. Click 'New Domain' and your domain and select the Monitoring Tab
2. Select iOS SDK or Global Monitoring (Use Global if you would like to use the same Domain for both web and mobile)
3. Next provide the Domain you wish to ingest events from and press enter (you can add subdomains here)
4. Start adding Vendors by Clicking new Vendor
5. Search for an existing Vendor or create a Custom Vendor
6. Fill in the Monitoring Form for the specific Vendor you have Chosen
The form has several crucial fields to complete:
This is the domain which client side pixel/tag requests are sent to.
Typically known as the request URL e.g. for Facebook, "facebook.com/tr".
Use this field to specify which keys you would like to exclude from monitoring. e.g. Facebook sends an "sw" parameter with screen width. If you don't want/need to monitor that key, enter it here.
Used to specify which key in the vendors payload corresponds to the event name.
You can specify either a single field by name, or multiple fields inside curly braces e.g. `{{fieldA}}-{{fieldB}}`. Here is an example request with the event in the "ev" parameter:
You can also extract a field value via regular-expression.
E.g. You may want to extract a sub-domain from a URL and add it to the event, this can be done by find inf the correct regex and applying it to the field parameter in the following format:
`regex::(?<=https:\/\/)[\w|-]*::url`
This format represents 3 sections, separated by double-colons (`::`). The 3 sections are:
* `regex` which inpforms the expression parser that the user is passing a regex expression
* `(?<=https:\/\/)[\w|-]*` is the regular expression itself (javascript regex supported. Test your regex in any regex editor such are [Regexr](https://regexr.com/))
* `url` is the field from which the content is extracted. You may use a dot (`.`) separated field path. (`url`, `host`, `method` and `vendorName` are automatically added to the payload)
The following execnt field `eve-{{regex::(?<=https:\/\/)[\w|-]*::url}}` (multiple digits) on value of field "myfield". In a payload `{ url: "https://subdomain.myapp.com" }`, the event field will be `eve-subdomain`.
Regular Expression allows for capturing text in relation to the existence of other text before it or after it. This is called [lookahead](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Regular_expressions/Lookahead_assertion) and [lookbehind](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Regular_expressions/Lookbehind_assertion)
Use this to focus your monitoring to specific vendor requests e.g. only where "ev" = "orderSuccess". This can also help reduce API call consumption.
7. After completing your Vendor Form press the Apply and then the Save button. To Manage simply enter this form again, edit and you will notice the Deployment Version at the bottom increment by 1.
8. See the below iOS Swift installation guide to install the iOS SDK on your Swift App.
## Installation
Follow these steps to integrate Monita SDK into your iOS project:
### Step 1: Add the Package Dependency
1. Open Xcode and navigate to **File > Swift Packages > Add Package Dependency**.
2. In the search box, enter the URL:
```
https://github.com/rnadigital/monita-ios-sdk.git
```
3. Click **Next**.
4. Select the **branch** option and enter `master` as the branch name.
5. Click **Finish**. The SDK will be added under **Swift Package Dependencies**.
### Step 2: Configure the SDK Token
1. Open your project's `Info.plist` file in Xcode.
2. Add a new key called `MonitaSDKToken` with your SDK token as the value:
```xml theme={null}
MonitaSDKToken
Your-Token-Here
```
## Usage
After installing the SDK, initialize it in your application delegate. For example, update your `AppDelegate.swift` as follows:
```swift theme={null}
import MonitaSDK
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
// Initialize Monita SDK with your custom configuration
MonitaSDK.configure(
enableLogger: true,
batchSize: 10,
customerId: "123456",
consentString: "Granted",
sessionId: "123456",
appVersion: "1.0"
)
return true
}
```