Настройка Elasticsearch/OpenSearch для поиска Magento 2

В проектах с каталогом более 10 000 SKU стандартный MySQL-поиск в Magento 2 давал задержки до 3–5 секунд на запрос, а релевантность страдала — товары не находились по частичному совпадению или морфологии. Начиная с версии 2.4.0 MySQL-поиск полностью удалён из ядра, и Elasticsearch или OpenSearch стали обязательными. Мы настраиваем поисковую инфраструктуру так, чтобы пользователь получал точные результаты за 100–200 мс, а конверсия росла на 15–30%.

Почему Elasticsearch/OpenSearch обязательны для Magento?

Современные версии Magento (2.4.4+) не поддерживают MySQL-поиск. Без Elasticsearch или OpenSearch вы не сможете выполнять полнотекстовый поиск, фасетную фильтрацию и автодополнение. OpenSearch, форк Elasticsearch с лицензией Apache 2.0, предпочтительнее для новых проектов — он активнее развивается и не имеет ограничений по использованию.

OpenSearch быстрее внедряет новые возможности (например, k-NN поиск) и имеет более прозрачную модель разработки.

Как мы настраиваем поиск под русский язык?

Стандартный анализатор Magento не учитывает русскую морфологию: слово «платье» не найдёт «платья». Мы подключаем плагин analysis-icu и настраиваем кастомный анализатор:

PUT /magento2_product_1/_settings { "analysis": { "analyzer": { "russian_search": { "type": "custom", "tokenizer": "standard", "filter": ["lowercase", "russian_stop", "russian_stemmer"] } }, "filter": { "russian_stop": { "type": "stop", "stopwords": "_russian_" }, "russian_stemmer": { "type": "stemmer", "language": "russian" } } } } 

Такой подход даёт прирост релевантности на 40–60% по сравнению с дефолтным анализатором. Без этого русскоязычные пользователи не найдут товары по склонениям и падежам, что напрямую снижает конверсию.

Что такое индексация без остановки поиска?

Magento использует alias-схему: magento2_product_1 (активный) и magento2_product_1_v2 (при переиндексации). Это позволяет обновлять индекс без остановки поиска — экономия на инфраструктуре за счёт zero-downtime reindex. Маппинг атрибутов управляется через Magento\Elasticsearch\Model\Adapter\FieldMapper. Кастомные атрибуты, помеченные как searchable или filterable, автоматически включаются в индекс:

class CustomFieldMapper extends FieldMapper { public function getFieldName($attributeCode, $context = []) { if ($attributeCode === 'ean_code') { return 'keyword_ean_code'; // точное совпадение } return parent::getFieldName($attributeCode, $context); } } 

Alias-схема гарантирует, что во время перестройки индекса старый остаётся активным. После завершения индекс переключается атомарно. Это исключает потерю данных и простои.

Установка OpenSearch для production

Рекомендуем Docker или пакетную установку на отдельный сервер. Для разработки подойдёт single-node конфигурация:

# docker-compose.yml services: opensearch: image: opensearchproject/opensearch:2.11.0 environment: - discovery.type=single-node - DISABLE_SECURITY_PLUGIN=true - OPENSEARCH_JAVA_OPTS=-Xms2g -Xmx2g ports: - "9200:9200" ulimits: memlock: soft: -1 hard: -1 volumes: - opensearch-data:/usr/share/opensearch/data 

В production-кластере минимально 3 ноды (1 master + 2 data). Пример конфигурации data-ноды:

# /etc/opensearch/opensearch.yml cluster.name: magento-search node.name: data-node-1 node.roles: [data, ingest] network.host: 0.0.0.0 discovery.seed_hosts: ["master-node:9300"] cluster.initial_cluster_manager_nodes: ["master-node"] path.data: /var/lib/opensearch path.logs: /var/log/opensearch indices.memory.index_buffer_size: 20% thread_pool.write.queue_size: 1000 

Дополнительно настройте heap size не выше 50% от доступной памяти и включите мониторинг через _cluster/health.

Подключение Magento к OpenSearch

bin/magento config:set catalog/search/engine opensearch bin/magento config:set catalog/search/opensearch_server_hostname 127.0.0.1 bin/magento config:set catalog/search/opensearch_server_port 9200 bin/magento config:set catalog/search/opensearch_index_prefix magento2 bin/magento config:set catalog/search/opensearch_enable_auth 0 bin/magento config:set catalog/search/opensearch_server_timeout 15 bin/magento indexer:reindex catalogsearch_fulltext bin/magento cache:flush curl -X GET "localhost:9200/_cat/indices/magento2*?v&pretty" curl -X GET "localhost:9200/magento2_product_1/_mapping?pretty" | head -80 

Как настроить релевантность пошагово?

1. Задайте веса атрибутов (название, описание) в админке Magento (значения 1–10).
2. Программно переопределите Magento\Elasticsearch\SearchAdapter\Query\Builder\Match для кастомных правил.
3. Включите fuzziness для полей с высоким весом — это исправляет опечатки.
4. Добавьте кастомный анализатор русского языка (как показано выше).
5. Проверьте результаты через slow logs и настройте пороги.

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

Что входит в работу по настройке поиска

• Аудит текущей конфигурации и производительности
• Установка и настройка кластера OpenSearch (или Elasticsearch)
• Интеграция с Magento 2, включая кастомные анализаторы и веса
• Оптимизация под русский язык (морфология, стемминг)
• Настройка alias-индексов для zero-downtime reindex
• Конфигурация мониторинга (slow logs, cluster health)
• Документация и обучение команды
• Поддержка после релиза (1 месяц)

Под ключ мы выполняем настройку за 3–5 дней, в зависимости от сложности каталога. Свяжитесь с нами для оценки вашего проекта — мы предложим оптимальное решение и сроки. Получите консультацию по настройке поиска Magento 2 — мы оценим ваш проект и предложим оптимальное решение.

Сроки настройки

Мониторинг и troubleshooting

Ключевые метрики: Heap usage (не выше 75% от -Xmx), Search latency (p95 < 200 мс), Indexing rate. Для диагностики используем slow logs. Частая проблема: mapper [price_0_1] cannot be changed from type [float] to [double]. Решение — удалить и пересоздать индекс командой curl -X DELETE "localhost:9200/magento2_product_*" && bin/magento indexer:reindex catalogsearch_fulltext. Получите консультацию, если нужна помощь с нестандартными кейсами. Свяжитесь с нами, чтобы обсудить детали.