Настройка 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. Получите консультацию, если нужна помощь с нестандартными кейсами. Свяжитесь с нами, чтобы обсудить детали.