Начало работы с Raygun: мониторинг и отчеты о сбоях для разработчиков приложений
This sponsored post features a product relevant to our readers while meeting our editorial guidelines for being objective and educational.
() translation by (you can also view the original English article)
Введение в Raygun
Большинство не пишет об ошибках в своем программном обеспечении, но вы когда-нибудь рассматривали, сколько проблем может существовать в ваших приложениях, о которых вы даже не подозреваете?
Вы когда-нибудь получали запросы от поддержки и не могли воспроизвести проблему, или вы часами просматривали логи, чтобы найти основные причины проблем? Мы все встречались с этим, имея дело с неожиданными проблемами, которые происходят в нашей кодовой базе.
Не всегда понятно, что было причиной проблемы, ваша команда может тратить часы на просматривая логи, чтобы исправить проблему.
Raygun предлагает решение этой проблемы с помощью мониторинга вашего приложения в реальном времени,, помогая вам определить, какое улучшение необходимо сделать оперативно. Кроме того, Raygun предлагает функциональные возможности рабочего процесса для совместной работы с вашими коллегами-разработчиками вплоть до развертывания исправлений..



Платформа Raygun предлагает основные инструменты разработки программного обеспечения, которые помогают следить за веб и мобильными приложениями при возникновении проблем. Предлагается программное обеспечение для отчета о сбоях, которое помогает обнаруживать, диагностировать и устранять любые исключения, с которыми сталкиваются ваши пользователи, и инструмент Real User Monitoring, который контролирует каждый сеанс пользователя для таких вещей, как медленная загрузка ассетов, скриптов и запросов, которые могут замедлить производительность вашего приложения , Raygun охватывает все базовые кейсы.
Сегодня мы рассмотрим, как настроить отчеты об ошибках и сбоях в реальном времени для ваших приложений с помощью Raygun, в соответствии с тем, какой язык программирования и платформа используется.
Если вы когда-либо нажимали «Не отправлять» в диалоговом окне отчетов о сбоях операционной системы, вы знаете, что немногие пользователи активно сообщают об ошибках - большинство избегает лишних телодвижений.
Фактически, опрос Compuware сообщил, что только 16% пользователей пытались отправить отчеты об ошибках более чем в два раза. Очень важно знать, о сбоях вашего программного обеспечения. Raygun делает это легко.
Всего несколькими строками кода, вы можете интегрировать Raygun в среду разработки за считанные минуты. Raygun поддерживает все основные языки программирования и платформы, поэтому просто выберите язык, с которого вы хотите начать. Вы мгновенно начнете получать сообщения об ошибках и сбоях и сможете изучать диагностическую информацию и отслеживать трассировки на приборной панели Raygun.
В этом уроке я покажу вам примеры мониторинга приложений JavaScript, таких как Ghost и WordPress основанный на PHP, но Raygun работает повсеместно: фронтенд, бекенд, веб и мобильные.



Определяя проблемы и сообщая вам, где именно искать их, Raygun помогает вам создавать более безопасное и надежное программное обеспечение, чтобы радовать ваших пользователей и обеспечить их возвращение.
Что еще более важно, Raygun построен для команд и поддерживает интеграцию для программного обеспечения для разработчиков, таких как командные чаты, например Slack и Hipchat, инструменты управления проектами, например JIRA и Sprintly, а также для трекинга задач, например GitHub и Bitbucket. Raygun дает вашей команде гарантии, что ваше программное обеспечение работает так, как вы ожидаете.
Как здорово получать уведомления Slack в режиме реального времени для всей вашей команды, когда ваши клиенты сталкиваются с ошибками, проблемами и сбоями!



В этом туториале я проделаю настройку приложения с Raygun шаг за шагом.
Если у вас есть какие-либо просьбы о статье или вопросы и комментарии, пожалуйста, разместите их ниже. Вы также можете связаться со мной на Twitter @lookaheadio или отправить мне сообщение по электронной почте напрямую.
Начнем
Одной из самых мощных функций Raygun является то, что он работает со всеми основными языками программирования и платформами, и это на удивление легко интегрировать. Просто скопируйте и вставьте код в свое приложение, и Raygun начнет отслеживать ошибки. В случае с WordPress есть предустановленный плагин.
Интеграция Raygun с вашим приложением
После регистрации вам будет представлен короткий мастер интеграции Raygun. Он начинается с выбора вашего языка. Вот начальная панель, которую вы увидите:



Вот пример интеграции для использования с любым кодом или платформой JavaScript.
Использование Raygun с JavaScript
Когда вы выберете JavaScript, вам будет показан ваш Ключ API приложения (ключ будет одинаковым для всех выбранных вами платформ и специфичен для приложения). Для каждой среды или языка, который вы хотите контролировать, вы должны создать отдельное приложение для организации ошибок в разных кодовых базах.
Raygun прост в использовании, независимо от того, какую систему управления пакетами JavaScript вы предпочитаете:



Пример с Bower:
1 |
bower install raygun4js
|
Из NuGet, откройте консоль и выполните команду:
1 |
Install-Package raygun4js |
Но вы также можете просто загрузить библиотеку из CDN от Raygun в своем приложении:
1 |
<script type="text/javascript" src="http://cdn.raygun.io/raygun4js/raygun.min.js"></script> |
Вы также можете скачать модифицированную версию для продакшена или полный исходник для разработки и интегрировать своим способом.
Чтобы начать перехватывать исключения в своем приложении, вызовите Raygun.init с помощью ключа API, а затем вызовите команду attach
:
1 |
<script src="dist/raygun.min.js"></script> |
2 |
<script> |
3 |
Raygun.init('your-api-key-goes-here').attach(); |
4 |
</script> |
Если вы хотите быстрее настроить приложение на основе JavaScript, чтобы попробовать Raygun, вы можете попробовать мой учебный курс Envato Tuts +, посвященный платформе блогов Ghost с открытым исходным кодом.
Для этого урока я собираюсь использовать Raygun с блогом WordPress, так как ошибки PHP и JavaScript могут быть пойманы аналогичным образом.
Отладка с WordPress
Чтобы установить Raygun для WordPress, вам нужен плагин Raygun WordPress:



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



Через минуту вы увидите ошибки, собранные на панели управления Raygun. Если нет, нажмите кнопку «Отправить тестовую ошибку», чтобы вызвать ее.
Панель управления Raygun
Сначала вы увидите пустую панель:



Но как только вы выбрали свой язык и интегрировали свое приложение, вы увидите такую панель инструментов, как эта. Raygun помог мне открыть изобилие исходных кодов тем WordPress, которые не были обновлены до последней версии PHP.



Отслеживание ошибок при развертывании кода
Когда вы интегрируете Raygun с инструментами развертывания, он может отслеживать ошибки в соответствии с определенными версиями выпущенного программного обеспечения. Это поможет вам быстро и легко выявить и устранить неисправные релизы:



Вы можете прочитать о том, как интегрировать сценарии развертывания с тегами Raygun в документации. Raygun предоставляет руководства для работы с: Octopus Deploy, Bash, Powershell, Capistrano, Rake, Grunt, Atlassian Bamboo и FAKE - F# Make.
Управление статусами ошибок Raygun
В настоящее время Raygun позволяет назначать группы ошибок одному из пяти статусов. Это:
- Активный
- Исправлено
- Исправлено в версии x.xx
- Игнорируется
- Постоянно игнорируется
Когда первая ошибка получена, ей назначается Active и она отображается на первой вкладке. Затем вы можете принять меры, чтобы изменить ее на другой статус.
Например, как только я активировал Raygun с помощью WordPress и обнаружил множество проблем совместимости PHP связанных с темой, моя очередь электронной почты начала заполняться, но это было легко разрешено, указанием Raygun уведомлять меня только о новых отчетах.
Вы также можете легко фильтровать и управлять проблемами по статусу через интерфейс. Например, было бы легко удалить все ошибки, устраненные в WordPress версии 4.3.
Подробные обзоры ошибок Raygun
Когда вы нажимаете на ошибки, Raygun показывает вам подробный вид со стеком трассировки и сводкой на которую влияют пользователи и браузеры или устройства:



В подробном обзоре Raygun также позволяет вам и вашей команде комментировать и обсуждать конкретные проблемы:



Отслеживание пользователей Raygun
Если вы реализуете отслеживание пользователей с помощью интеграции Raygun, вы можете точно увидеть, какие из ваших аутентифицированных пользователей столкнулись с определенными ошибками и как часто:



Raygun предлагает доступною документацию для связывания отчетов об ошибках с текущим пользователем. Вот пример для JavaScript:
По умолчанию Raygun4JS назначает уникальный анонимный идентификатор для текущего пользователя. Это сохраняется как файл cookie. Если текущий пользователь изменится, чтобы сбросить его и назначить новый ID, вы можете вызвать:
1 |
Raygun.resetAnonymousUser(); |
Чтобы отключить отслеживание анонимного пользователя, вызовите Raygun.init('apikey', {disableAnonymousUserTracking: true});
.
Вы можете предоставить дополнительную информацию о пользователе, зарегистрированном в данный момент, Raygun, вызвав: Raygun.setUse('unique_user_identifier');
.
Этот метод принимает дополнительные параметры, которые используются при представлении отчетов о пользователях, которые столкнулись с ошибками. Полная сигнатура метода:
1 |
setUser: function (user, isAnonymous, email, fullName, firstName, uuid) |
Управление вашей командой
Raygun построен вокруг отслеживания проблем в команде разработчиков. В области настроек легко добавлять приложения, которые вы отслеживаете, и приглашать членов команды для участия:



Как уже упоминалось выше, Raygun легко интегрируется с другими инструментами на для команды, такими как чат (Slack, Hipchat и т. д.), Управление проектами (JIRA, Sprintly и т. д.) и трекеры (GitHub, Bitbucket и т. д.).
Полезные инструменты для поддержки клиентов
Поддержка Raygun отличная. В дополнение к веб-документации и электронным руководствам, есть полезный вспомогательный персонал (например, Ник), готовый помочь вам глубже погрузиться в сервис. Ник стал доступен только после того, как я начал использовать сервис:



API Raygun
Если вы хотите настроить триггеры событий, вы можете публиковать сообщения об ошибках через Raygun API, которые вы бы хотели получить от своего приложения. Это может быть полезно для разработчиков, желающих интегрировать мониторинг или специализированную отчетность через свои службы или упростить процесс разработки.
Мониторинг реального пользователя Raygun Pulse
Наконец, несмотря на то, что мы говорили о настройке программного обеспечения Raygun Crash Reporting, добавление Pulse - Real User Monitoring так же просто при добавлении фрагмента кода Raygun.
Pulse предоставляет вам все данные сеанса от «реальных» пользователей, когда они взаимодействуют с вашими приложениями. Это намного мощнее, чем традиционное синтетическое тестирование, поскольку данные берутся непосредственно из браузера пользователя, позволяя вам увидеть, как уникальное устройство пользователя, браузер, ОС, местоположение или скорость соединения повлияли на производительность приложения. Медленные сценарии, запросы и ассеты могут быть определены как причина низкой производительности и оптимизированы для улучшения общей производительности вашего приложения.



В паре Pulse с Crash Reporting data у вас есть все инструменты, доступные для обеспечения того, чтобы ваши клиенты получали отличный сервис.
В итоге
Надеюсь, вы нашли Raygun простым в использовании и полезным для ваших требований к развитию. Напомним, вот некоторые из основных преимуществ:
- Raygun предоставляет полный обзор проблем во всем стеке разработки. Интеллектуальная группировка ошибок позволяет увидеть проблемы с наивысшим приоритетом, а не набрасывать вас уведомлениями для каждой ошибки.
- Raygun поддерживает все основные языки программирования и платформы. Каждый разработчик может использовать его. Время разработки дорогое, поэтому перестаньте тратить время на поиски ошибок. Исправляйте проблемы быстрее и создавайте больше возможностей!
- Raygun построен для команд. Вы можете приглашать неограниченное количество членов команды на свою учетную запись - никаких ограничений. Raygun помогает вам создать рабочий процесс команды для исправления ошибок и предоставляет пользовательские уведомления и ежедневный дайджест событий ошибок для всей вашей команды.
- Для крупных корпоративных организаций Raygun Enterprise может предоставлять поддержку облака или размещать self-hosted версию сервиса для ваших нужд.
Когда вы попробуете Raygun, пожалуйста, оставьте нам ваши вопросы и комментарии ниже. Вы также можете связаться со мной с помощью Twitter @lookaheadio или отправить мне письмо по электронной почте. Или, если Raygun сэкономит вам немного времени, вы можете просмотреть мою страницу инструктора Envato Tuts+ для ознакомления с другими учебниками, которые я написал.