Налаштування 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": { "ukrainian_search": { "type": "custom", "tokenizer": "standard", "filter": ["lowercase", "ukrainian_stop", "ukrainian_stemmer"] } }, "filter": { "ukrainian_stop": { "type": "stop", "stopwords": "_ukrainian_" }, "ukrainian_stemmer": { "type": "stemmer", "language": "ukrainian" } } } } 

Такий підхід дає приріст релевантності на 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. Отримайте консультацію, якщо потрібна допомога з нестандартними кейсами. Зв'яжіться з нами, щоб обговорити деталі.