Мониторинг приложений Ключ-АСТРОМ

Материал из Документация Ключ-АСТРОМ

Мониторинг приложений Ключ-АСТРОМ

В этом руководстве показано, как настроить мониторинг в вашем приложении Ключ-АСТРОМ. В настоящее время существует два способа самомониторинга приложений: мониторинг реальных пользователей (RUM) собирает данные о взаимодействии пользователей с приложением, а логи функций приложения предоставляют информацию об ошибках и данные логов вашего приложения.

Приоритет — защита данных

В современную цифровую эпоху конфиденциальность имеет первостепенное значение. Обеспечение конфиденциальности — это не только этическая обязанность, но и важнейший фактор для поддержания доверия пользователей и соблюдения постоянно меняющихся правил защиты данных. Ключ-АСТРОМ предоставляет инструменты для обеспечения конфиденциальности и безопасности данных в системах управления правами пользователя (RUM) и логах функций приложений. Подробности смотрите в соответствующем разделе.

Кончик: Регулярно проверяйте и обновляйте конфигурации в соответствии с передовыми методами и стандартами защиты данных.

Мониторинг реальных пользователей (RUM)

Получите глубокое понимание поведения пользователей вашего приложения с помощью мониторинга реальных пользователей Ключ-АСТРОМ. Быстро выявляйте ошибки, анализируйте коды ответов и углубляйтесь в анализ пользовательских сессий. Все данные мониторинга направляются либо в специально настроенную среду, либо в среду, где развернуто приложение Ключ-АСТРОМ.

Примечание: В настоящее время функция воспроизведения сеансов не поддерживается для пользовательских приложений.

Настройка RUM

Для перенаправления данных мониторинга вашего приложения Ключ-АСТРОМ в целевую среду необходимо создать приложение RUM:

  1. Перейдите в нужную целевую среду.
  2. Откройте приложение Фронтенд и в выпадающем меню в правом верхнем углу выберите Настроить мониторинг без агентов.
  3. Укажите описательное имя и нажмите Добавить веб-приложение.
  4. В разделе кода <script> скопируйте URL-адрес, содержащийся в атрибуте src (например, https://js-cdn.astromkey.com/jstag/1234567890a/bf12345678/1234567890abcdef_complete.js).
  5. Используйте этот скрипт в файле конфигурации вашего приложения для свойства selfMonitoringAgent:
app.config.json
{
  "environmentUrl": "<Your-Environment-URL>",
  "app": {
    "id": "<Your-App-ID>",
    "name": "<Your-App-Name>",
    "version": "0.0.0",
    "description": "<Your-App-Description>",
    "scopes": [],
    "selfMonitoringAgent": "https://js-cdn.astromkey.com/jstag/1234567890a/bf12345678/1234567890abcdef_complete.js"
  }
}

Сохраните изменения и повторно разверните приложение. Теперь мониторинг RUM настроен!

Кончик: Убедитесь, что для настройки мониторинга без агентов используется JavaScript RUM версии >1.271. Чтобы проверить это (после добавления веб-приложения):

  1. Перейдите во внешний интерфейс приложения и выберите недавно добавленное веб-приложение.
  2. В выпадающем меню в правом верхнем углу выберите Редактировать.
  3. Прокрутите вниз и разверните раздел Настройка.
  4. Выберите обновления JavaScript для RUM и убедитесь, что выбранная версия равна/больше 1.271.

Защита конфиденциальности с помощью RUM

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

Логи функций приложения

Найдите в логах ошибки или определенные пользовательские записи, связанные с функциями вашего приложения. Логи для функций приложения Ключ-АСТРОМ автоматически отображаются в среде, где работает приложение. Учитывайте это при развертывании приложения в производственной среде.

Доступ к логам функций приложения

Дополнительная настройка не требуется. Логи автоматически отправляются в среду, где развернуто ваше приложение Ключ-АСТРОМ.

Чтобы просмотреть их, например, запустите Блокноты и выполните следующий запрос:

fetch logs
| filter dt.app.id == "<Your-App-ID>"

Обеспечение конфиденциальности с помощью логов функций приложений

При использовании команд типа console.log(data) в функциях вашего приложения Ключ-АСТРОМ следует проявлять осторожность в отношении характера и конфиденциальности записываемых данных. Логи, независимо от их уровня, накапливаются в среде, где работает приложение. Подробное руководство по маскированию логов содержит методы предотвращения непреднамеренной утечки данных.

Трассировка функций приложения

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

В приложении Распределенная трассировка вы можете легко исследовать трассировки функций вашего приложения. Чтобы найти нужные трассировки, используйте AppId с тегом фильтра Service и конкретное имя функции приложения с тегом фильтра Endpoint.

Настройка уровня логирования и отчетов трассировки

  1. Перейти в раздел Общие.
  2. Разверните панель Настройки мониторинга приложений и:
    • Настройте глобальный уровень детализации логов для всех логов функций Ключ-АСТРОМ.
    • Включайте и выключайте отображение результатов трассировки.
  3. Для настроек, специфичных для конкретного приложения, вы можете задать отдельные параметры на уровне приложения.