Эта страница переведена с помощью Cloud Translation API.

Мониторинг производительности развертывания функций

1. Обзор

В этой лаборатории кода вы узнаете, как отслеживать производительность вашего приложения во время развертывания функции. Наш пример приложения будет иметь базовые функции и настроен на отображение другого фонового изображения на основе флага Firebase Remote Config. Мы рассмотрим инструментирование трассировок для мониторинга производительности приложения, внедрим изменения конфигурации в приложение, отслеживаем эффект и посмотрим, как мы можем улучшить производительность.

Что вы узнаете

Как добавить мониторинг производительности Firebase в свое мобильное приложение, чтобы получать готовые показатели (например, время запуска приложения, медленные или зависшие кадры)
Как добавить пользовательские трассировки, чтобы понять критические пути кода в пути пользователя
Как использовать панель мониторинга производительности, чтобы понимать ваши показатели и отслеживать важные изменения, такие как внедрение функции.
Как настроить оповещения о производительности для мониторинга ключевых показателей
Как внедрить изменение удаленной конфигурации Firebase

Предварительные условия

Android Studio 4.0 или выше
Эмулятор Android с уровнем API 16 или выше.
Java версии 8 или выше
Базовое понимание Firebase Remote Config.

2. Настройте образец проекта

Загрузите код

Выполните следующую команду, чтобы клонировать пример кода для этой лаборатории кода. На вашем компьютере будет создана папка с именем codelab-perf-rc-android :

$ git clone https://github.com/FirebaseExtended/codelab-feature-rollout-performance.git

Если на вашем компьютере нет Git, вы также можете загрузить код прямо с GitHub.

Импортируйте проект в папку firebase-perf-rc-android-start в Android Studio. Вероятно, вы увидите некоторые исключения во время выполнения или, возможно, предупреждение об отсутствующем файле google-services.json . Мы исправим это в следующем разделе.

В этой лаборатории кода вы будете использовать плагин Firebase Assistant , чтобы зарегистрировать свое приложение Android в проекте Firebase и добавить необходимые файлы конфигурации Firebase, плагины и зависимости в свой проект Android — и все это из Android Studio !

Подключите свое приложение к Firebase

Перейдите в Android Studio / Справка > Проверить наличие обновлений, чтобы убедиться, что вы используете последние версии Android Studio и Firebase Assistant.
Выберите «Инструменты» > «Firebase» , чтобы открыть панель «Ассистент» .

Выберите «Мониторинг производительности» , чтобы добавить его в свое приложение, затем нажмите «Начать работу с мониторингом производительности» .
Нажмите «Подключиться к Firebase» , чтобы подключить проект Android к Firebase (при этом в вашем браузере откроется консоль Firebase) .
В консоли Firebase нажмите «Добавить проект» и введите имя проекта Firebase (если у вас уже есть проект Firebase, вместо этого вы можете выбрать существующий проект) . Нажмите « Продолжить» и примите условия, чтобы создать проект Firebase и новое приложение Firebase.

Затем вы должны увидеть диалоговое окно для подключения нового приложения Firebase к проекту Android Studio.

Нажмите Подключиться .
Откройте Android-студию. На панели «Ассистент» вы увидите подтверждение того, что ваше приложение подключено к Firebase.

Добавьте мониторинг производительности �� свое приложение

На панели «Ассистент» в Android Studio нажмите «Добавить мониторинг производительности в ваше приложение» .

Вы должны увидеть диалоговое окно « Принять изменения», после чего Android Studio должна синхронизировать ваше приложение, чтобы убедиться, что все необходимые зависимости добавлены.

Наконец, вы должны увидеть сообщение об успехе на панели «Ассистент» в Android Studio о том, что все зависимости настроены правильно.

В качестве дополнительного шага включите ведение журнала отладки, следуя инструкциям в шаге «(Необязательно) Включить ведение журнала отладки». Эти же инструкции также доступны в общедоступной документации .

3. Запустите приложение

Теперь вы должны увидеть файл google-services.json в каталоге модуля (на уровне приложения) вашего приложения, и теперь ваше приложение должно скомпилироваться. В Android Studio нажмите «Выполнить» > «Запустить ��риложение», чтобы создать и запустить приложение на эмуляторе Android.

Когда приложение запущено, вы сначала должны увидеть такую заставку:

Затем через несколько секунд отобразится главная страница с изображением по умолчанию:

Что происходит под капотом?

Экран-заставка реализован в SplashScreenActivity и выполняет следующие действия:

В onCreate() мы инициализируем настройки Firebase Remote Config и извлекаем значения конфигурации, которые вы установите на панели управления Remote Config позже в этой лаборатории кода.
В executeTasksBasedOnRC() мы читаем значение конфигурации флага seasonal_image_url . Если URL-адрес указан в значении конфигурации, мы загружаем изображение синхронно.
После завершения загрузки приложение переходит к MainActivity и вызывает finish() чтобы завершить SplashScreenActivity .

В MainActivity , если seasonal_image_url определен через Remote Config, эта функция будет включена, и загруженное изображение будет отображаться в качестве фона главной страницы. В противном случае будет отображено изображение по умолчанию (показанное выше).

4. Настройте удаленную конфигурацию

Теперь, когда ваше приложение запущено, вы можете настроить новый флаг функции.

На левой панели консоли Firebase найдите раздел Engage и нажмите Remote Config .
Нажмите кнопку «Создать конфигурацию» , чтобы открыть форму конфигурации и добавить seasonal_image_url в качестве ключа параметра.
Нажмите «Добавить описание» и введите следующее описание: Shows a seasonal image (replaces default) in the main page when the restaurant list is empty.
Нажмите Добавить новое -> Условное значение -> Создать новое условие .
В качестве имени условия введите Seasonal image rollout .
В разделе Applies if... выберите User in random percentile <= 0% . (Вы хотите оставить эту функцию отключенной до тех пор, пока не будете готовы к развертыванию на более позднем этапе.)
Нажмите Создать условие . Вы будете использовать это условие позже, чтобы представить новую функцию своим пользователям.

Откройте форму «Создайте свой первый параметр» и найдите поле «Значение для сезонного изображения» . Введите URL-адрес, по которому будет загружено сезонное изображение: https://images.unsplash.com/photo-1552691021-7043334e0b51
Оставьте значение по умолчанию в виде пустой строки. Это означает, что будет показано изображение по умолчанию в базе кода, а не изображение, загруженное по URL-адресу.
Нажмите Сохранить .

Вы можете видеть, что новая конфигурация создана как черновик.

Нажмите «Опубликовать изменения» и подтвердите изменения вверху, чтобы обновить приложение.

5. Добавьте мониторинг времени загрузки данных.

Ваше приложение предварительно загружает некоторые данные перед отображением MainActivity и отображает заставку, чтобы скрыть этот процесс. Вы не хотите, чтобы ваши пользователи слишком долго ждали на этом экране, поэтому обычно полезно отслеживать, как долго отображается заставка.

Мониторинг производительности Firebase позволяет сделать именно это. Вы можете использовать специальные трассиров��и кода для мониторинга производительности определенного кода в вашем приложении, например времени загрузки данных и времени обработки вашей новой функции.

Чтобы отслеживать, как долго отображается экран-заставка, вы добавите трассировку пользовательского кода в SplashScreenActivity , который является Activity , реализующим экран-заставку.

Инициализируйте, создайте и запустите трассировку пользовательского кода с именем splash_screen_trace :

SplashScreenActivity.java

// ...
import com.google.firebase.perf.FirebasePerformance;
import com.google.firebase.perf.metrics.Trace;
// ...

public class SplashScreenActivity extends AppCompatActivity {

    private static final String TAG = "SplashScreenActivity";
    private static final String SEASONAL_IMAGE_URL_RC_FLAG = "seasonal_image_url";

    // TODO: Initialize splash_screen_trace
    private final Trace splashScreenTrace = FirebasePerformance.startTrace("splash_screen_trace");
    
    // ...
}

Завершите трассировку в методе onDestroy() SplashScreenActivity :

SplashScreenActivity.java

@Override
protected void onDestroy() {
    super.onDestroy();

    // TODO: Stop the splash_screen_trace here
    splashScreenTrace.stop();
}

Поскольку ваша новая функция загружает и обрабатывает изображение, вы добавите вторую трассировку пользовательского кода, которая будет отслеживать дополнительное время, которое ваша функция добавила в SplashScreenActivity .

Инициализируйте, создайте и запустите трассировку пользовательского кода с именем splash_seasonal_image_processing :

SplashScreenActivity.java

private void executeTasksBasedOnRC(FirebaseRemoteConfig rcConfig) {
    String seasonalImageUrl = rcConfig.getString(SEASONAL_IMAGE_URL_RC_FLAG);
    Log.d(TAG, SEASONAL_IMAGE_URL_RC_FLAG + ": " + seasonalImageUrl);

    if (!seasonalImageUrl.isEmpty()) {
        // TODO: Start the splash_seasonal_image_processing here
        final Trace seasonalImageProcessingTrace = FirebasePerformance
            .startTrace("splash_seasonal_image_processing");

        // ...
    }
}

Завершите трассировку в методах onLoadFailed() и onResourceReady() RequestListener :

SplashScreenActivity.java

Glide.with(SplashScreenActivity.this.getApplicationContext())
    .asBitmap()
    .load(seasonalImageUrl)
    .signature(new ObjectKey(Utils.getCacheUUID()))
    .listener(new RequestListener<Bitmap>() {
        @Override
        public boolean onLoadFailed(
            @Nullable GlideException e,
            Object model, Target<Bitmap> target,
            boolean isFirstResource) {

            // TODO: Stop the splash_seasonal_image_processing here
            seasonalImageProcessingTrace.stop();

            launchMainActivity();
            return true;
        }

        @Override
        public boolean onResourceReady(Bitmap resource, Object model,
            Target<Bitmap> target, DataSource dataSource,
            boolean isFirstResource) {

            // TODO: Stop the splash_seasonal_image_processing here
            seasonalImageProcessingTrace.stop();

            launchMainActivity();
            return true;
        }
     })
     .preload();

Теперь, когда вы добавили трассировки пользовательского кода для отслеживания продолжительности экрана-заставки ( splash_screen_trace) и времени обработки новой функции ( splash_seasonal_image_processing ), снова запустите приложение в Android Studio. Вы должны увидеть сообщение журнала, содержащее Logging trace metric: splash_screen_trace , за которой следует продолжительность трассировки. Вы не увидите сообщение журнала для splash_seasonal_image_processing поскольку вы еще не включили новую функцию.

6. Добавьте в трассировку пользовательский атрибут.

Для трассировок пользовательского кода мониторинг производительности автоматически регистрирует атрибуты по умолчанию (общие метаданные, такие как версия приложения, страна, устройство и т. д.), чтобы вы могли фильтровать данные для трассировки в консоли Firebase . Вы также можете добавлять и отслеживать пользовательские атрибуты .

В своем приложении вы только что добавили две трассировки пользовательского кода для отслеживания продолжительности экрана-заставки и времени обработки новой функции. Фактором, который может повлиять на эту продолжительность, является то, является ли отображаемое изображение изображением по умолчанию или изображение необходимо загрузить по URL-адресу. И кто знает – возможно, в конечном итоге у вас могут быть разные URL-адреса, с которых вы загружаете изображение.

Итак, давайте добавим пользовательский атрибут, представляющий URL-адрес сезонного изображения, к этим трассировкам пользовательского кода. Таким образом, вы сможете позже фильтровать данные о продолжительности по этим значениям.

Добавьте пользовательский атрибут ( seasonal_image_url_attribute ) для splash_screen_trace в начале метода executeTasksBasedOnRC :

SplashScreenActivity.java

private void executeTasksBasedOnRC(FirebaseRemoteConfig rcConfig) {
    String seasonalImageUrl = rcConfig.getString(SEASONAL_IMAGE_URL_RC_FLAG);
    Log.d(TAG, SEASONAL_IMAGE_URL_RC_FLAG + ": " + seasonalImageUrl);

    // TODO: Add a custom attribute "seasonal_image_url_attribute" to splash_screen_trace
    if (seasonalImageUrl.isEmpty()) {
        splashScreenTrace.putAttribute("seasonal_image_url_attribute", "unset");
    } else {
        splashScreenTrace.putAttribute("seasonal_image_url_attribute", seasonalImageUrl);
    }

    // ...
}

Добавьте тот же пользовательский атрибут для splash_seasonal_image_processing сразу после вызова startTrace("splash_seasonal_image_processing") :

SplashScreenActivity.java

if (!seasonalImageUrl.isEmpty()) {
    // TODO: Start the splash_seasonal_image_processing here
    final Trace seasonalImageProcessingTrace = FirebasePerformance
        .startTrace("splash_seasonal_image_processing");

    // TODO: Add a custom attribute "seasonal_image_url_attribute" to splash_seasonal_image_processing
    seasonalImageProcessingTrace
        .putAttribute("seasonal_image_url_attribute", seasonalImageUrl);

    // ...
}

Теперь, когда вы добавили пользовательский атрибут ( seasonal_image_url_attribute ) для обеих ваших пользовательских трассировок ( splash_screen_trace и splash_seasonal_image_processing ), снова запустите приложение в Android Studio. Вы должны увидеть сообщение журнала, содержащее Setting attribute 'seasonal_image_url_attribute' to 'unset' on trace 'splash_screen_trace'. Вы еще не включили параметр SeasonImageUrl удаленной конфигурации, поэтому значение атрибута не unset .

SDK для мониторинга производительности соберет данные трассировки и отправит их в Firebase. Вы можете просмотреть данные на панели мониторинга «Производительность» консоли Firebase, которую мы подробно объясним на следующем этапе лаборатории кода.

7. Настройте панель мониторинга производительности.

Настройте свою панель мониторинга для мониторинга вашей функции

В консоли Firebase выберите проект, в котором есть ваше приложение Friendly Eats.

На левой панели найдите раздел «Выпуск и мониторинг» , затем нажмите «Производительность» .

Вы должны увидеть свою панель показателей производительности с самыми первыми точками данных на доске показателей! SDK для мониторинга производительности собирает данные о производительности вашего приложения и отображает их в течение нескольких минут после сбора.

На этой доске показателей вы можете отслеживать ключевые показатели вашего приложения. Представление по умолчанию включает продолжительность трассировки времени запуска вашего приложения, но вы можете добавить метрики, котор��е вас интересуют больше всего. Поскольку вы отслеживаете добавленную новую функцию, вы можете настроить свою панель мониторинга для отображения продолжительности трассировки пользовательского кода splash_screen_trace .

Нажмите на одно из пустых полей «Выберите метрику» .
В диалоговом окне выберите тип трассировки «Пользовательские трассировки» и имя трассировки splash_screen_trace .

Нажмите «Выбрать метрику» , и вы увидите продолжительность splash_screen_trace , добавленную на вашу панель мониторинга!

Вы можете использовать эти же шаги, чтобы добавить другие важные для вас показатели, чтобы вы могли быстро увидеть, как их производительность меняется с течением времени и даже с разными выпусками.

Доска показателей — это мощный инструмент для отслеживания эффективности ключевых показателей, наблюдаемых вашими пользователями. Для этой лаборатории кода у вас есть небольшой набор данных в узком временном диапазоне, поэтому вы будете использовать другие представления информационной панели, которые помогут вам понять производительность развертывания функции.

8. Распространите свою функцию

Теперь, когда вы настроили мониторинг, вы готовы развернуть изменение удаленной конфигурации Firebase ( seasonal_image_url) , которое вы настроили ранее.

Чтобы внедрить изменение, вы вернетесь на страницу удаленной настройки в консоли Firebase, чтобы увеличить процентиль пользователя для вашего условия таргетинга. Обычно вы внедряете новые функции для небольшой части пользователей и расширяете их только тогда, когда уверены, что с ними нет проб��ем. Однако в этой кодовой лаборатории вы — единственные пользователи приложения, поэтому вы можете изменить процентиль на 100%.

Нажмите на вкладку «Условия» вверху страницы.
Щелкните условие Seasonal image rollout , которое вы добавили ранее.
Измените процентиль на 100%.
Нажмите Сохранить условие .
Нажмите «Опубликовать изменения» и подтвердите изменения.

Вернувшись в Android Studio, перезапустите приложение в эмуляторе, чтобы увидеть новую функцию. После заставки вы до��жны увидеть новый главный экран в пустом состоянии!

9. Проверьте изменения производительности

Теперь давайте проверим производительность загрузки заставки с помощью панели «Производительность» в консоли Firebase. На этом этапе лаборатории кода вы будете использовать различные части информационной панели для просмотра данных о производительности.

На главной вкладке «Панель мониторинга» прокрутите вниз до таблицы трассировок, затем щелкните вкладку «Пользовательские трассировки» . В этой таблице вы увидите добавленные ранее трассировки пользовательского кода, а также некоторые готовые трассировки .
Теперь, когда вы включили новую функцию, найдите трассировку пользовательского кода splash_seasonal_image_processing , которая измеряла время, необходимое для загрузки и обработки изображения. Из значения Duration трассировки видно, что загрузка и обработка занимают значительное время.

Поскольку у вас есть данные для splash_seasonal_image_processing , вы можете добавить продолжительность этой трассировки на свою доску показателей в верхней части вкладки «Панель мониторинга» .

Как и раньше, щелкните одно из пустых полей «Выберите метрику» . В диалоговом окне выберите тип трассировки Пользовательские трассировки и имя трассировки splash_seasonal_image_processing . Наконец, на��мите «Выбрать метрику» , чтобы добавить эту метрику на доску метрик.

Чтобы дополнительно подтвердить различия, вы можете поближе взглянуть на данные для splash_screen_trace . Нажмите карточку splash_screen_trace на доске показателей, затем нажмите « Просмотреть сведения о метрике» .

На странице сведений в левом нижнем углу вы увидите список атрибутов, включая созданный вами ранее настраиваемый атрибут. Нажмите настраиваемый атрибут seasonal_image_url_attribute , чтобы просмотреть продолжительность заставки для каждого URL-адреса сезонного изображения справа:

Значения длительности заставки, вероятно, будут немного отличаться от показанных на снимке экрана выше, но у вас должна быть более высокая продолжительность, когда изображение загружается по URL-адресу, а не при использовании изображения по умолчанию (обозначенного «не установлено»).

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

Нажмите «Производительность» вверху страницы, чтобы вернуться на главную вкладку панели мониторинга :
В таблице трассировок внизу страницы перейдите на вкладку Сетевые запросы . В этой таблице вы увидите все сетевые запросы вашего приложения , объединенные в шаблон�� URL-адресов , включая шаблон URL-адресов images.unsplash.com/** . Если вы сравните значение этого времени ответа с общим временем, необходимым для загрузки и обработки изображения (т. е. с длительностью трассировки splash_seasonal_image_processing ), вы увидите, что большая часть времени тратится на загрузку изображения.

Результаты производительности

Используя мониторинг производительности Firebase, вы заметили следующее влияние на конечных пользователей с включенной новой функцией:

Время, затрачиваемое на SplashScreenActivity увеличилось.
Продолжительность обработки splash_seasonal_image_processing была очень большой.
Задержка была вызвана временем ответа на загрузку изображения и соответствующим временем обработки, необходимым для изображения.

На следующем этапе вы смягчите влияние на производительность, откатив функцию и определив, как можно улучшить ее реализацию.

10. Откатить функцию

Увеличение времени ожидания ваших пользователей во время заставки нежелательно. Одним из ключевых преимуществ Remote Config является возможность приостановить и отменить развертывание без необходимости выпуска для пользователей еще одной версии. Это позволяет вам быстро реагировать на проблемы (например, проблемы с производительностью, обнаруженные на последнем этапе) и минимизировать количество недовольных пользователей.

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

Вернитесь на страницу Remote Config в консоли Firebase.
Нажмите «Условия» вверху страницы.
Нажмите на условие Seasonal image rollout которое вы добавили ранее.
Измените процентиль на 0%.
Нажмите Сохранить условие .
Нажмите «Опубликовать изменения» и подтвердите изменения.

Перезапустите пр��ложение в Android Studio, и вы должны увидеть исходный пустой главный экран:

11. Исправьте проблемы с производительностью.

Ранее в лаборатории кода вы обнаружили, что загрузка изображения для заставки приводит к замедлению работы вашего приложения. Присмотревшись к загруженному изображению, вы увидите, что используете исходное разрешение изображения, которое превышало 2 МБ! Одним из быстрых решений проблемы с производительностью является снижение качества до более подходящего разрешения, чтобы загрузка изображения занимала меньше времени.

Снова разверните значение Remote Config.

Вернитесь на страницу Remote Config в консоли Firebase.
Нажмите значок «Изменить» для параметра seasonal_image_url .
Обновите свиток «Значение для сезонного изображения» до https://images.unsplash.com/photo-1552691021-7043334e0b51?w=640 , затем нажмите «Сохранить» .

Нажмите на вкладку «Условия» вверху страницы.
Нажмите «Сезонное изображение» , затем установите процентиль обратно на 100 %.
Нажмите Сохранить условие .

Нажмите кнопку «Опубликовать изменения» .

12. Проверьте исправление и настройте оповещения.

Запустите приложение локально

��становив новое значение конфигурации для использования другого URL-адреса изображения загрузки, снова запустите приложение. На этот раз вы должны заметить, что время, проведенное на заставке, стало короче, чем раньше.

Просмотр эффективности изменений

Вернитесь на панель «Производительность» в консоли Firebase, чтобы увидеть, как выглядят показатели.

На этот раз вы будете использовать таблицу трассировок для перехода на страницу сведений. Внизу в таблице трассировок на вкладке «Пользовательские трассировки» щелкните пользовательскую трассировку splash_seasonal_image_processing , чтобы снова увидеть более подробное представление ее показателя продолжительности.

Нажмите на пользовательский атрибут seasonal_image_url_attribute чтобы снова увидеть разбивку пользовательских атрибутов. Если вы наведете курсор на URL-адреса, вы увидите значение, соответствующее новому URL-адресу изображения уменьшенного размера: https://images.unsplash.com/photo-1552691021-7043334e0b51?w=640 (с ?w=640 в конце). Значение продолжительности, связанное с этим изображением, значительно короче, чем значение для предыдущего изображения, и более приемлемо для ваших пользователей!

Теперь, когда вы улучшили производительность экрана-заставки, вы можете настроить оповещения, которые будут уведомлять вас, когда трассировка превышает установленный вами порог. Откройте панель мониторинга «Производительность» , щелкните значок меню переполнения (три точки) для Splash_screen_trace и выберите «Настройки оповещений» .

Нажмите на переключатель, чтобы включить оповещение о продолжительности . Установите пороговое значение немного выше значения, которое вы видели, чтобы, если ваш Splash_screen_trace превысит пороговое значение, вы получите электронное письмо.

Нажмите «Сохранить» , чтобы создать оповещение. Прокрутите вниз до таблицы трассировок , затем перейдите на вкладку Пользовательские трассировки , чтобы убедиться, что ваше оповещение включено!

13. Поздравляем!

Поздравляем! Вы включили Firebase Performance Monitoring SDK и собрали трассировки для измерения производительности новой функции! Вы отслеживали ключевые показатели производительности при развертывании новой функции и быстро реагировали при обнаружении проблем с производительностью. Все это стало возможным благодаря возможности вносить изменения в конфигурацию с помощью Remote Config и отслеживать проблемы с производительностью в режиме реального времени.

Что мы рассмотрели

Добавление SDK Firebase Performance Monitoring в ваше приложение
Добавление пользовательской трассировки кода в ваш код для измерения определенной функции.
Настройка параметра Remote Config и условного значения для управления/развертывания новой функции.
Понимание того, как использовать панель мониторинга производительности для выявления проблем во время развертывания.
Настройка оповещений о производительности, которые будут уведомлять вас, когда производительность вашего приложения превышает установленный вами порог.

Узнать больше

1. Обзор

Что вы узнаете

Как добавить мониторинг производительности Firebase в свое мобильное приложение, чтобы получать готовые показатели (например, время запуска приложения, медленные или зависшие кадры)
Как добавить пользовательские трассировки, чтобы понять критические пути кода в пути пользователя
Как использовать панель мониторинга производительности, чтобы понимать ваши показатели и отслеживать важные изменения, такие как внедрение функции.
Как настроить оповещения о производительности для мониторинга ключевых показателей
Как внедрить изменение удаленной конфигурации Firebase

Предварительные условия

Android Studio 4.0 или выше
Эмулятор Android с уровнем API 16 или выше.
Java версии 8 или выше
Базовое понимание Firebase Remote Config.

2. Настройте образец проекта

Загрузите код

$ git clone https://github.com/FirebaseExtended/codelab-feature-rollout-performance.git

Если на вашем компьютере нет Git, вы также можете загрузить код прямо с GitHub.

Подключите свое приложение к Firebase

Перейдите в Android Studio / Справка > Проверить наличие обновлений, чтобы убедиться, что вы используете последние версии Android Studio и Firebase Assistant.
Выберите «Инструменты» > «Firebase» , чтобы открыть панель «Ассистент» .

Выберите «Мониторинг производительности» , чтобы добавить его в свое приложение, затем нажмите «Начать работу с мониторингом производительности» .
Нажмите «Подключиться к Firebase» , чтобы подключить проект Android к Firebase (при этом в вашем браузере откроется консоль Firebase) .
В консоли Firebase нажмите «Добавить проект» и введите имя проекта Firebase (если у вас уже есть проект Firebase, вместо этого вы можете выбрать существующий проект) . Нажмите « Продолжить» и примите условия, чтобы создать проект Firebase и новое приложение Firebase.

Затем вы должны увидеть диалоговое окно для подключения нового приложения Firebase к проекту Android Studio.

Нажмите Подключиться .
Откройте Android-студию. На панели «Ассистент» вы увидите подтверждение того, что ваше приложение подключено к Firebase.

Добавьте мониторинг производительности в свое приложение

На панели «Ассистент» в Android Studio нажмите «Добавить мониторинг производительности в ваше приложение» .

3. Запустите приложение

Теперь вы должны увидеть файл google-services.json в каталоге модуля (на уровне приложения) вашего приложения, и теперь ваше приложение должно скомпилироваться. В Android Studio нажмите «Выполнить» > «Запустить приложение», чтобы создать и запустить приложение на эмуляторе Android.

Когда приложение запущено, вы сначала должны увидеть такую заставку:

Затем через несколько секунд отобразится главная страница с изображением по умолчанию:

Что происходит под капотом?

Экран-заставка реализован в SplashScreenActivity и выполняет следующие действия:

В onCreate() мы инициализируем настройки Firebase Remote Config и извлекаем значения конфигурации, которые вы установите на панели управления Remote Config позже в этой лаборатории кода.
В executeTasksBasedOnRC() мы читаем значение конфигурации флага seasonal_image_url . Если URL-адрес указан в значении конфигурации, мы загружаем изображение синхронно.
После завершения загрузки приложение переходит к MainActivity и вызывает finish() чтобы завершить SplashScreenActivity .

4. Настройте удаленную конфигурацию

Теперь, когда ваше приложение запущено, вы можете настроить новый флаг функции.

На левой панели консоли Firebase найдите раздел Engage и нажмите Remote Config .
Нажмите кнопку «Создать конфигурацию» , чтобы открыть форму конфигурации и добавить seasonal_image_url в качестве ключа параметра.
Нажмите «Добавить описание» и введите следующее описание: Shows a seasonal image (replaces default) in the main page when the restaurant list is empty.
Нажмите Добавить новое -> Условное значение -> Создать новое условие .
В качестве имени условия введите Seasonal image rollout .
В разделе Applies if... выберите User in random percentile <= 0% . (Вы хотите оставить эту функцию отключенной до тех пор, пока не будете готовы к развертыванию на более позднем этапе.)
Нажмите Создать условие . Вы будете использовать это условие позже, чтобы представить новую функцию своим пользователям.

Откройте форму «Создайте свой первый параметр» и найдите поле «Значение для сезонного изображения» . Введите URL-адрес, по которому будет загружено сезонное изображение: https://images.unsplash.com/photo-1552691021-7043334e0b51
Оставьте значение по умолчанию в виде пустой строки. Это означает, что будет отображаться изображение по умолчанию в базе кода, а не изображение, загруженное по URL-адресу.
Нажмите Сохранить .

Вы можете видеть, что новая конфигурация создана как черновик.

Нажмите «Опубликовать изменения» и подтвердите изменения вверху, чтобы обновить приложение.

5. Добавьте мониторинг времени загрузки данных.

Ваше приложение предварительно загружает некоторые данные перед отображением MainActivity и отображает заставку, чтобы скрыть этот п��оцесс. Вы не хотите, чтобы ваши пользователи слишком долго ждали на этом экране, поэтому обычно полезно отслеживать, как долго отображается заставка.

Мониторинг производительности Firebase позволяет сделать именно это. Вы можете использовать специальные трассировки кода для мониторинга производительности определенного кода в вашем приложении, например времени загрузки данных и времени обработки вашей новой функции.

Инициализируйте, создайте и запустите трассировку пользовательского кода с именем splash_screen_trace :

SplashScreenActivity.java

// ...
import com.google.firebase.perf.FirebasePerformance;
import com.google.firebase.perf.metrics.Trace;
// ...

public class SplashScreenActivity extends AppCompatActivity {

    private static final String TAG = "SplashScreenActivity";
    private static final String SEASONAL_IMAGE_URL_RC_FLAG = "seasonal_image_url";

    // TODO: Initialize splash_screen_trace
    private final Trace splashScreenTrace = FirebasePerformance.startTrace("splash_screen_trace");
    
    // ...
}

Завершите трассировку в методе onDestroy() SplashScreenActivity :

SplashScreenActivity.java

@Override
protected void onDestroy() {
    super.onDestroy();

    // TODO: Stop the splash_screen_trace here
    splashScreenTrace.stop();
}

Инициализируйте, создайте и запустите трассировку пользовательского кода с именем splash_seasonal_image_processing :

SplashScreenActivity.java

private void executeTasksBasedOnRC(FirebaseRemoteConfig rcConfig) {
    String seasonalImageUrl = rcConfig.getString(SEASONAL_IMAGE_URL_RC_FLAG);
    Log.d(TAG, SEASONAL_IMAGE_URL_RC_FLAG + ": " + seasonalImageUrl);

    if (!seasonalImageUrl.isEmpty()) {
        // TODO: Start the splash_seasonal_image_processing here
        final Trace seasonalImageProcessingTrace = FirebasePerformance
            .startTrace("splash_seasonal_image_processing");

        // ...
    }
}

Завершите трассировку в методах onLoadFailed() и onResourceReady() RequestListener :

SplashScreenActivity.java

Glide.with(SplashScreenActivity.this.getApplicationContext())
    .asBitmap()
    .load(seasonalImageUrl)
    .signature(new ObjectKey(Utils.getCacheUUID()))
    .listener(new RequestListener<Bitmap>() {
        @Override
        public boolean onLoadFailed(
            @Nullable GlideException e,
            Object model, Target<Bitmap> target,
            boolean isFirstResource) {

            // TODO: Stop the splash_seasonal_image_processing here
            seasonalImageProcessingTrace.stop();

            launchMainActivity();
            return true;
        }

        @Override
        public boolean onResourceReady(Bitmap resource, Object model,
            Target<Bitmap> target, DataSource dataSource,
            boolean isFirstResource) {

            // TODO: Stop the splash_seasonal_image_processing here
            seasonalImageProcessingTrace.stop();

            launchMainActivity();
            return true;
        }
     })
     .preload();

Теперь, когда вы добавили трассировки пользовательского кода для отслеживания продолжительности экрана-заставки ( splash_screen_trace) и времени обработки новой функции ( splash_seasonal_image_processing ), снова запустите приложение в Android Studio. Вы должны увидеть сообщение журнала, содержащее Logging trace metric: splash_screen_trace , за которой следует продолжительность трассировки. Вы не увидите сообщение журнала для splash_seasonal_image_processing , потому что вы еще не включили новую функцию.

6. Добавьте пользовательский атрибут в трассировку

Для пользовательских трассировки кода мониторинг производительности автоматически регистрирует атрибуты по умолчанию (общие метаданные, такие как версия приложения, страна, устройство и т. Д.), Чтобы вы могли отфильтровать данные для трассировки в консоли Firebase . Вы также можете добавить и отслеживать пользовательские атрибуты .

В вашем приложении вы только что добавили два пользовательских трассы кода для мониторинга продолжительности экрана Splash и времени обработки новой функции. Фактором, который может повлиять на эти продолжительности, является то, является ли отображаемое изображение изображением по умолчанию или если изображение должно быть загружено с URL. И кто знает - у вас могут быть разные URL -адреса, с которых вы загружаете изображение.

Итак, давайте добавим пользовательский атрибут, представляющий сезонный URL -адрес изображения в эт�� пользовательские следы кода. Таким образом, вы можете отфильтровать данные продолжительности с помощью этих значений позже.

Добавьте пользовательский атрибут ( seasonal_image_url_attribute ) для splash_screen_trace В начале метода executeTasksBasedOnRC :

Splashscreenactivity.java

private void executeTasksBasedOnRC(FirebaseRemoteConfig rcConfig) {
    String seasonalImageUrl = rcConfig.getString(SEASONAL_IMAGE_URL_RC_FLAG);
    Log.d(TAG, SEASONAL_IMAGE_URL_RC_FLAG + ": " + seasonalImageUrl);

    // TODO: Add a custom attribute "seasonal_image_url_attribute" to splash_screen_trace
    if (seasonalImageUrl.isEmpty()) {
        splashScreenTrace.putAttribute("seasonal_image_url_attribute", "unset");
    } else {
        splashScreenTrace.putAttribute("seasonal_image_url_attribute", seasonalImageUrl);
    }

    // ...
}

Добавьте тот же пользовательский атрибут для splash_seasonal_image_processing сразу после startTrace("splash_seasonal_image_processing") Вызов:

Splashscreenactivity.java

if (!seasonalImageUrl.isEmpty()) {
    // TODO: Start the splash_seasonal_image_processing here
    final Trace seasonalImageProcessingTrace = FirebasePerformance
        .startTrace("splash_seasonal_image_processing");

    // TODO: Add a custom attribute "seasonal_image_url_attribute" to splash_seasonal_image_processing
    seasonalImageProcessingTrace
        .putAttribute("seasonal_image_url_attribute", seasonalImageUrl);

    // ...
}

Теперь, когда вы добавили пользовательский атрибут ( seasonal_image_url_attribute ) для обоих ваших пользовательских трассов ( splash_screen_trace и splash_seasonal_image_processing ), снова запустите приложение в Android Studio. Вы должны увидеть сообщение о журнале, которое содержит Setting attribute 'seasonal_image_url_attribute' to 'unset' on trace 'splash_screen_trace'. Вы еще не включили удаленный параметр конфигурации SecoryAlimageUrl, поэтому значение атрибута не unset .

SDK мониторинга производительности будет собирать данные трассировки и отправить их на Firebase. Вы можете просмотреть данные на панели инструментов производительности консоли Firebase, которые мы подробно объясним на следующем этапе CodeLab.

7. Настройка панели мониторинга производительности

Настройте панель инструментов для мониторинга вашей функции

В консоли Firebase выберите проект, в котором есть ваше дружественное приложение Eats.

На левой панели найдите раздел «Выпуск и монитор» , затем нажмите производительность .

Вы должны увидеть свою панель мониторинга Performance с вашими самыми первыми точками данных в вашей доске метрик! SDK мониторинга производительности собирает данные о производительности из вашего приложения и отображает их в течение нескольких минут после сбора.

Эта доска метрик - это место, где вы можете отслеживать ключевые метрики для вашего приложения. Представление по умолчанию включает в себя продолжительность трассировки времени начала приложения, но вы можете добавить метрики, о которых вы больше всего заботитесь. Поскольку вы отслеживаете новую функцию, которую вы добавили, вы можете адаптировать свою панель панели, чтобы отобразить продолжительность пользовательского кода splash_screen_trace .

Нажмите на одно из пустых , выберите метрические поле.
В диалоговом окне выберите тип трассировки пользовательских трассов и имя трассировки splash_screen_trace .

Нажмите SELECT METRIC , и вы должны увидеть продолжительность splash_screen_trace добавленную на приборную панель!

Вы можете использовать эти же шаги, чтобы добавить другие метрики, о которых вы заботитесь, чтобы вы могли быстро увидеть, как их производительность меняется со временем и даже с разными выпусками.

Совет метрик является мощным инструментом для отслеживания производительности ключевых метрик, испытываемых вашими пользователями. Для этого CodeLab у вас есть небольшой набор данных в узком диапазоне времени, поэтому вы будете использовать другие виды на панели панели, которые помогут вам понять производительность развертывания функций.

8. Разверните свою функцию

Теперь, когда вы установили свой мониторинг, вы готовы развернуть удаленную конфигурацию Firebase ( seasonal_image_url) , которое вы настраиваете ранее.

Чтобы развернуть изменение, вы вернетесь на страницу удаленной конфигурации в консоли Firebase, чтобы увеличить процентиль пользователя вашего условия таргетинга. Обычно вы развертели новые функции на небольшую часть пользователей и увеличивают их только тогда, когда вы уверены, что с ним нет проблем. В этом коделабе, однако, вы единственные пользователи приложения, поэтому вы можете изменить процентиль на 100%.

Нажмите на вкладку «Условия» в верхней части страницы.
Нажмите на Seasonal image rollout , которое вы добавили ранее.
Измените процентиль на 100%.
Нажмите Сохранить условие .
Нажмите «Публикуйте изменения» и подтвердите изменения.

Вернувшись в Android Studio, перезапустите приложение в эмуляторе, чтобы увидеть новую функцию. После экрана Splash вы должны увидеть новый главный экран пустого состояния!

9. Проверьте изменения производительности

Теперь давайте посмотрим на производительность загрузки экрана Splash, используя панель мониторинга производительности в консоли Firebase. На этом этапе CodeLab вы используете разные части панели инструментов для просмотра данных производительности.

На главной вкладке приборной панели прокрутите вниз до таблицы Traces, затем нажмите на вкладку «Пользовательские трассы» . В этой таблице вы увидите дополнительные трассировки кода, которые вы добавили ранее, плюс некоторые из ящиков .
Теперь, когда вы включили новую функцию, ищите пользовательский кодовый трассировку splash_seasonal_image_processing , который измерил время, которое потребовалось для загрузки и обработки изображения. Из значения продолжительности трассировки вы ��ожете видеть, что эта загрузка и обработка занимают значительное количество времени.

Поскольку у вас есть данные для splash_seasonal_image_processing , вы можете добавить продолжительность этой трассировки в свою плату метрик в верхней части вкладки приборной панели .

Аналогично ранее, нажмите на одно из пустых выберите метрические поле. В диалоговом окне выберите пользовательские трассировки типа трассировки и имя трассировки splash_seasonal_image_processing . Наконец, нажмите «Выбрать метрику» , чтобы добавить эту метрику в доску метрик.

Чтобы дополнительно подтвердить различия, вы можете поближе взглянуть на данные для splash_screen_trace . Нажмите на карту splash_screen_trace в плате метрик, затем нажмите « Просмотреть показатели метрики» .

На странице «Подробности» вы увидите список атрибутов слева внизу, включая пользовательский атрибут, который вы создали ранее. Нажмите на пользовательский атрибут seasonal_image_url_attribute , чтобы просмотреть продолжительность экрана брызг для каждого сезонного URL -адреса справа:

Ваши значения продолжительности экрана, вероятно, немного отличаются от показа на снимке экрана выше, но вы должны иметь более длительную продолжительность, когда изображение загружается с URL -адреса в зависимости от использования изображения по умолчанию (представлено «unset»).

В этом коделабе причина такой более длительной продолжительности может быть простой, но в реальном приложении это может быть не так очевидно. Собранные данные о продолжительности будут поступать из разных устройств, запуская приложение в различных условиях сетевого соединения, и эти условия могут быть хуже, чем ваши ожидания. Давайте посмотрим, как вы рассмотрите эту проблему, если бы это была реальная ситуация.

Нажмите на производительность в верхней части страницы, чтобы вернуться на вкладку Main Dashboard :
В таблице трассы в нижней части страницы нажмите на вкладку «Сеть запросов» . В этой таблице вы увидите все сетевые запросы из вашего приложения , агрегированного в шаблоны URL , включая images.unsplash.com/** URL -шаблон. Если вы сравниваете значение этого времени ответа с общим временем, которое необходимо для загрузки и обработки изображений (то есть продолжительность трассировки splash_seasonal_image_processing ), вы можете увидеть, что большое количество времени потрачено на загрузку изображения.

Выводы производительности

Используя мониторинг производительности Firebase, вы увидели следующее влияние на конечных пользователей с включенной новой функцией:

Время, потраченное на SplashScreenActivity увеличилось.
Продолжительность для splash_seasonal_image_processing была очень большой.
Задержка была вызвана временем ответа для загрузки изображения и соответствующим временем обработки, необходимым для изображения.

На следующем шаге вы смягчите влияние на производительность, откачившись от функции и определив, как вы можете улучшить реализацию этой функции.

10. Отведите эту функцию

Увеличение времени ожидания ваших пользователей во время экрана Splash нежелательно. Одним из ключевых преимуществ удаленной конфигурации является возможность приостановить и отменить ваше развертывание без необходимости выпустить другую версию вашим пользователям. Это позволяет быстро реа��ировать на проблемы (например, проблемы с производительностью, которые вы обнаружили на последнем шаге) и минимизировать количество несчастных пользователей.

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

Вернитесь на страницу удаленной конфигурации в консоли Firebase.
Нажмите на условия в верхней части страницы.
Нажмите на Seasonal image rollout которое вы добавили ранее.
Измените процентиль на 0%.
Нажмите Сохранить условие .
Нажмите «Публикуйте изменения» и подтвердите изменения.

Перезагрузите приложение в Android Studio, и вы должны увидеть оригинальный основной экран пустого состояния:

11. Исправьте проблемы с производительностью

Ранее вы обнаружили в CodeLab, что загрузка изображения для вашего экрана Splash вызывает замедление для вашего приложения. Посмотрите на загруженное изображение, вы видите, что используете исходное разрешение изображения, которое было более 2 МБ! Одним из быстрых решений для вашей проблемы производительности является снижение качества до более подходящего разрешения, чтобы изображение занимало меньше времени для загрузки.

Еще раз развернуть удаленное значение конфигурации

Вернитесь на страницу удаленной конфигурации в консоли Firebase.
Нажмите на значок «Редактировать параметр seasonal_image_url .
Обновите значение для сезонного развертывания изображений на https://images.unsplash.com/photo-1552691021-7043334e0b51?w=640 , затем нажмите «Сохранить» .

Нажмите на вкладку «Условия» в верхней части страницы.
Нажмите на сезонный развертывание изображения , затем установите процентиль на 100%.
Нажмите Сохранить условие .

Нажмите кнопку «Публикация изменений» .

12. Проверьте исправление и настройку оповещений

Запустите приложение локально

С новым набором значений конфигурации для использования другого URL -адреса загрузки, запустите приложение снова. На этот раз вы должны заметить, что время, проведенное на экране Splash, короче, чем раньше.

Просмотреть производительность изменений

Вернитесь к управляемой панели Performance в консоли Firebase, чтобы увидеть, как выглядят метрики.

На этот раз вы используете таблицу трассов, чтобы перейти на страницу деталей. В таблице Traces, на вкладке «Пользовательские трассы» , нажмите на пользовательский трассировку splash_seasonal_image_processing чтобы снова увидеть более подробное представление о своем метрике продолжительности.

Нажмите на пользовательский атрибут seasonal_image_url_attribute чтобы снова увидеть разбивку пользовательских атрибутов. Если вы наведите на URL-адреса, вы увидите значение, соответствующее новому URL для изображения уменьшенного размера: https://images.unsplash.com/photo-1552691021-7043334e0b51?w=640 (с ?w=640 в конце). Значение продолжительности, связанное с этим изображением, значительно короче значения для пред��дущего изображения и более приемлемо для ваших пользователей!

Теперь, когда вы улучшили производительность вашего экрана Splash, вы можете настроить оповещени��, чтобы уведомить вас, когда трассировка превышает порог, который вы устанавливаете. Откройте инструментальную панель Performance и щелкните значок Menu Overlow (Three Dot) для SPLASH_SCREEN_TRACE и нажмите «Настройки оповещения» .

Нажмите на переключатель, чтобы включить предупреждение о продолжительности . Установите пороговое значение немного выше значения, которое вы видели, чтобы, если ваш splash_screen_trace превышает порог, вы получите электронное письмо.

Нажмите Сохранить , чтобы создать свое предупреждение. Прокрутите вниз до таблицы Traces , затем нажмите на вкладку «Пользовательские трассы» , чтобы увидеть, что ваше предупреждение включено!

13. Поздравляю!

Поздравляем! Вы включили SDK мониторинга производительности Firebase и собранные следы, чтобы измерить производительность новой функции! Вы контролировали ключевые показатели производительности для развертывания новой функции и быстро отреагировали, когда была обнаружена проблема с производительностью. Все это было возможно с возможностью внести изменения конфигурации с помо��ью удаленной конфигурации и мониторинга для проблем с производительностью в режиме реального времени.

Что мы рассмотрели

Добавление мониторинга производительности Firebase SDK в ваше приложение
Добавление пользовательского трассировки кода в ваш код для измерения конкретной функции
Настройка удаленного параметра конфигурации и условного значения для управления/развертывания новой функции
Понимание того, как использовать мониторинг мониторинга производительности для выявления проблем во время развертывания
Настройка предупреждений о производительности, чтобы уведомить вас, когда производительность вашего приложения пересекает порог, который вы установили