Установка и настройка Sentry для отслеживания ошибок WordPress

Зачем нужен Sentry в WordPress

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

Диагностика проблемы: почему стандартного лога недостаточно

WordPress по умолчанию выводит ошибки в debug.log или на экран (если включен WP_DEBUG), но это не всегда удобно и информативно:

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

Если вы сталкиваетесь с непонятными багами, которые сложно отловить, Sentry сильно упростит работу.

Пошаговое решение: интеграция Sentry в WordPress

1. Регистрация и создание проекта в Sentry

Зарегистрируйтесь на sentry.io, создайте новый проект на PHP (Laravel или Generic PHP подойдет).

2. Установка SDK Sentry для PHP

На сервере с WordPress в корне проекта выполните команду (если есть Composer):

composer require sentry/sdk

Если Composer недоступен, скачайте SDK с репозитория и подключите вручную.

3. Инициализация Sentry в functions.php вашей темы или в кастомном плагине

use Sentry\SentrySdk;
use Sentry\State\Hub;

add_action('init', function() {
  if ( !class_exists('Sentry\init') ) {
    return; // SDK не загружен
  }

  \Sentry\init(['dsn' => 'ВАШ_DSN_СЮДА',
    'environment' => defined('WP_ENV') ? WP_ENV : 'production',
    'release' => defined('WP_VERSION') ? WP_VERSION : 'unknown',
  ]);

  // Пример добавления пользовательских тегов
  $user_id = get_current_user_id();
  if ($user_id) {
    \Sentry\configureScope(function (\Sentry\State\Scope $scope) use ($user_id): void {
      $scope->setUser(['id' => $user_id]);
    });
  }
});

4. Отправка тестовой ошибки

add_action('admin_init', function() {
  if (isset($_GET['test_sentry'])) {
    throw new Exception('Тестовое исключение для проверки Sentry');
  }
});

Зайдите в админку с параметром ?test_sentry=1 и проверьте, что ошибка появилась в вашем Sentry-проекте.

Проверка результата после внедрения

• Сделайте несколько тестовых ошибок с разным контекстом (например, для авторизованного и неавторизованного пользователя).
• Проверьте, что ошибки отображаются в интерфейсе Sentry с правильными метками и стеком вызовов.
• Убедитесь, что не происходит дублирования ошибок или ложных срабатываний.

Частые ошибки и как исправить

• SDK не подключается: проверьте, что composer установлен и автозагрузка работает. Для ручного подключения убедитесь, что путь к SDK корректен.
• Отсутствует DSN или он неверен: DSN должен быть точной строкой из настроек проекта Sentry.
• Ошибки не отправляются в Sentry: проверьте настройки сервера, firewall и доступ к внешним сервисам.
• Проблемы с перформансом: вызов Sentry\init() должен быть один раз при инициализации, избегайте повторных инициализаций.

Практические советы по безопасности и производительности

• Не отправляйте в Sentry чувствительные данные (пароли, полные формы). Используйте фильтры в configureScope для очистки данных.
• Отключите Sentry на локальной или тестовой среде через условие по константе или домену.
• Используйте в Sentry фильтры для игнорирования незначительных или ожидаемых ошибок.
• Регулярно обновляйте SDK, чтобы использовать последние исправления и улучшения.

Сравнение вариантов интеграции Sentry в WordPress