Мобильный мониторинг

Требования к Совместимости Мобильного агента для iOS

Операционная система: iOS 10 или выше.
API/SDK: Поддержка NSURLConnection и AFNetworking, ограниченная поддержка NSURLSession.
Языки программирования: Objective-C и Swift.
Устройства: Совместимость с iOS-устройствами.
Размер файла: Добавляет 2-12 МБ к приложению.
Архитектура: ARM 64-бит.
SHA-2: Требуется поддержка SHA-2 (256-бит) на сервере приложения.
Xcode: Рекомендуется использовать последнюю версию.
CocoaPods: Версия 1.10.1 или выше.
tvOS: Поддержка приложений tvOS.

Полный список и подробности доступны в официальной документации

Требования к Совместимости Мобильного агента для Android

Операционная система: Android 7.0 или выше.
API/SDK: Поддержка HttpURLConnection, OkHttp2 (кроме версий 2.0 и 2.4), OkHttp (версии 2.8, 3.5+, 4.0+), OkIO (версия 1.11), AndroidHttpClient, Volley (версия 1.0.0) и Apache HTTP Client.
Языки программирования: Java 1.7 до Java 9, JDK 11 поддерживается в версии 6.2.0 и выше, JDK 17 - в версии 7.0.0 и выше.
Устройства: Любые совместимые с Android устройства (смартфоны, планшеты, Android TV, Amazon Fire и т.д.).
Размер файла: Агент добавляет менее 500 КБ к вашему релизному APK.
Архитектура: ARM, Intel Atom.
Поддержка Gradle и Android Studio: Требуется соответствующая версия Gradle и Android Studio в зависимости от версии агента. Полный список и подробности доступны в официальной документации

Безопасность мобильных приложений

В целях обеспечения прозрачности и безопасности, наш продукт руководствуется следующими основными принципами::

Сбор данных: Ограничивается информацией о производительности, исключая личные данные пользователя.
Безопасные конечные точки: Данные отправляются на защищенные серверы.
Уникальные идентификаторы: Используются для отслеживания установок и сессий.
Отсутствие удаленных обновлений: Агент не обновляется удаленно без ведома пользователя.
Хранение данных: Информация хранится в памяти устройства.
Инструментарий кода: Внедряемый код не влияет на безопасность.
IP-адрес пользователя: Используется для обогащения данных, но не сохраняется.

Дополнительное описание аспектов безопасности мобильного SDK доступны в официальной документации

Установка мобильного агента для IOS

1. Установка сборки

В зависимости от того какой менеджер пакета вы используете для описания сборки - выберете пункт 1.1,1.2 или 1.3 соответственно

1.1 CocoaPods

Обновление podspec

Добавьте следующую строку в ваш Podfile:

pod 'NewRelicAgent'

Закройте ваш проект в Xcode и выполните обновление, запустив следующую команду из терминала в директории вашего проекта:

pod install

Откройте ваш проект в Xcode, запустив следующую команду из терминала в директории вашего проекта:

open App.xcworkspace

1.2 Xcode

Загрузка и Распаковка XCFramework SDK

Перейдите на страницу с заметками о выпуске iOS агента, чтобы скачать последнюю версию.
Загрузите SDK и сохраните файл на ваш компьютер.

Добавление XCFramework в Ваш Проект Xcode

Распакуйте скачанный SDK.
Откройте Finder и найдите папку NewRelicAgent.xcframework, которую вы только что распаковали.
Перетащите папку NewRelicAgent.xcframework из Finder в ваш проект Xcode, поместив её в панель Frameworks целевого проекта.
В разделе Embed выберите опцию “Embed & Sign”.

Примечание: Убедитесь, что вы используете последнюю версию Xcode и ваш проект настроен для работы с XCFramework.

1.3 Swift Packages Manage

Добавление Package.manifest

Для добавления зависимости через Swift Package Manager выполните следующие шаги:
В Xcode перейдите в меню File > Swift Packages > Add Package Dependency.
Введите URL репозитория пакета на GitHub:

https://github.com/newrelic/newrelic-ios-agent-spm

2. Конфигурация SDK

2.1 Конфигурация на Objective - c

Обновление файла AppDelegate.m

Для интеграции агента необходимо внести изменения в файл AppDelegate.m вашего мобильного приложения.

В начале файла AppDelegate.m добавьте следующий код для импорта необходимой библиотеки:
```
#import <NewRelic/NewRelic.h>
```

В файле AppDelegate.m добавьте этот вызов как первую строку метода application:didFinishLaunchingWithOptions::

[NewRelic startWithApplicationToken:@"<your_app_name>"
                andCollectorAddress:@"<your_collector_address>"
           andCrashCollectorAddress:@"<your_collector_address>"];

2.2 Конфигурация на Swift

Инициализация агента

Для интеграции агента необходимо внести изменения в класс AppDelegate вашего мобильного приложения.

В класс AppDelegate добавьте следующий код для импорта необходимой библиотеки:
```
import NewRelic/NewRelic
```

В файле AppDelegate.swift добавьте этот вызов как первую строку метода application:didFinishLaunchingWithOptions:

NewRelic.start(
    withApplicationToken: "<your_app_name>",
    andCollectorAddress: "<your_collector_address>",
    andCrashCollectorAddress: "<your_collector_address>"
)

3. Автоматическая загрузка вашего файла dSYM

В навигаторе XCode выберите ваш проект, затем кликните на целевое приложение (application target).
Выберите вкладку “Build Phases” и добавьте новую фазу сборки скриптов (“New Run Script Build Phase”).

В текстовом поле скрипта (под строкой Shell) введите следующий скрипт:

#import <NewRelic/NewRelic.h>

SCRIPT=`/usr/bin/find "${SRCROOT}" -name newrelic_postbuild.sh | head -n 1`
if [ -z "${SCRIPT}"]; then
ARTIFACT_DIR="${BUILD_DIR%Build/*}SourcePackages/artifacts"
SCRIPT=`/usr/bin/find "${ARTIFACT_DIR}" -name newrelic_postbuild.sh | head -n 1`
fi
/bin/sh "${SCRIPT}" "<your_app_name>"

4. Сборка и запуск вашего приложения

Для начала работы с данными, выполните следующие шаги:

Очистите ваш проект
Запустите ваше приложение в эмуляторе или на устройстве, чтобы начать видеть данные.

5. Начало работы

После установки агента в ваше приложение, в течение нескольких минут вы должны увидеть данные в вашем аккаунте GMONIT.

Если данные не появляются:

Если вы не видите данные о приложении после нескольких минут, подождите немного.
В случае возникновения проблем с установкой или отсутствия данных, обратитесь за помощью к документации: iOS документация

Установка мобильного агента для Android

Установите последнюю версию SDK
Для ознакомления с подробностями, пожалуйста, просмотрите примечания к релизу: Примечания к релизу Android
SDK New Relic требует Android версии 4.0 и выше. Если ваше приложение поддерживает версии Android ниже 5.0, имеется дополнительная информация о поддержке Multi-Dex: Инструкция по установке агента Android через Gradle

1. Установка SDK через gradle

В зависимости от того какой язык вы используете (groovy или kotlin) для описания сборки - выберете пункт 1.1 или 1.2 соответственно

1.1 Groovy

Обновление файла build.gradle

Следующие изменения необходимо внести в файл build.gradle на уровне вашего проекта до применения плагинов:

buildscript {

  // Данная секция необходима только, если pluginManagement не используется в settings.gradle
  repositories {
    mavenCentral()
  }

  dependencies {
    classpath 'com.newrelic.agent.android:agent-gradle-plugin:7.2.0'
  }
}

Добавьте или дополните следующие строки в файл build.gradle вашего модуля:
```
plugins {
  id 'newrelic'
}

dependencies {
  implementation 'com.newrelic.agent.android:android-agent:7.2.0'
}
```

1.2 Kotlin

Обновление файла build.gradle.kts

Добавьте или дополните следующие строки в файл build.gradle.kts на уровне вашего проекта перед применением плагинов:

buildscript {
  // Данная секция необходима только, если pluginManagement не используется в settings.gradle
  repositories {
    mavenCentral()
  }
  dependencies {
    classpath("com.newrelic.agent.android:agent-gradle-plugin:7.2.0")
  }
}

Добавьте или дополните следующие строки в файл build.gradle.kts вашего модуля:
```
plugins {
  id("newrelic")
}

dependencies {
  implementation("com.newrelic.agent.android:android-agent:7.2.0")
}
```

2. Настройка разрешений приложения

Убедитесь, что ваше приложение запрашивает разрешения INTERNET и ACCESS_NETWORK_STATE, добавив следующие строки в файл AndroidManifest.xml вашего Android проекта:

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

3. Конфигурация SDK

3.1 Конфигурация на Java

Импортируйте класс NewRelic в ваш основной Activity :
```
import com.newrelic.agent.android.NewRelic;
```

Для инициализации New Relic добавьте следующий фрагмент кода в метод onCreate()

NewRelic.withApplicationToken("<your_app_name>")
.usingCollectorAddress("<your_collector_address>")
.usingCrashCollectorAddress("<your_collector_address>")
.start(this.getApplicationContext());

3.2 Конфигурация на Kotlin

Импортируйте класс NewRelic в ваш основной Activity :
```
import com.newrelic.agent.android.NewRelic;
```

Для инициализации New Relic добавьте следующий фрагмент кода в метод onCreate()

NewRelic.withApplicationToken("<your_app_name>")
.usingCollectorAddress("<your_collector_address>")
.usingCrashCollectorAddress("<your_collector_address>")
.start(this.applicationContext);

4. Сборка и запуск вашего приложения

Для начала работы с данными, выполните следующие шаги:

Очистите ваш проект
Запустите ваше приложение в эмуляторе или на устройстве, чтобы начать видеть данные.

5. Начало работы

Если данные не появляются:

Если вы не видите данные о приложении после нескольких минут, подождите немного.
В случае возникновения проблем с установкой или отсутствия данных, обратитесь за помощью к документации: Android документация