Интерфейс подключения в Kibana
В данном документе описаны операции, доступные для управляемых коннекторов и самоуправляемых коннекторов с использованием пользовательского интерфейса.
В пользовательском интерфейсе Kibana перейдите в Поиск > Содержимое > Коннекторы из главного меню или используйте поле глобального поиска. Здесь вы можете просмотреть сводку всех ваших коннекторов и задач синхронизации, а также создать новые коннекторы.
В версии 8.12 мы представили набор API коннекторов для создания и управления коннекторами Elastic и задачами синхронизации, а также инструмент командной строки. Используйте эти инструменты, если хотите работать с коннекторами и задачами синхронизации программно, не используя пользовательский интерфейс.
Создание и настройка коннекторов
Ваш коннектор записывает данные в индекс Elasticsearch.
Чтобы создать управляемые коннекторы или самоуправляемые самоуправляемые коннекторы, используйте кнопки под Поиск > Содержимое > Коннекторы. После выбора типа источника данных, который вы хотите синхронизировать, вам будет предложено создать индекс Elasticsearch.
Управление индексами коннекторов
Просмотр и управление всеми индексами Elasticsearch, управляемыми коннекторами.
В пользовательском интерфейсе Kibana перейдите в Поиск > Содержимое > Коннекторы из главного меню или используйте поле глобального поиска. Здесь вы можете просмотреть список индексов коннекторов и их атрибутов, включая состояние коннектора и статус загрузки.
В этом интерфейсе вы можете просмотреть подробности каждого существующего индекса или удалить индекс. Или вы можете создать новый индекс коннектора.
Для этих операций требуется доступ к Kibana и дополнительные привилегии к индексам.
Настройка отображения и параметров индекса коннектора
Elasticsearch хранит ваши данные в виде документов в индексе. Каждый индекс состоит из набора полей, и каждое поле имеет тип (например, keyword, boolean или date).
Отображение — это процесс определения того, как документ и содержащиеся в нём поля хранятся и индексируются. Коннекторы используют динамическое отображение для автоматического создания отображения на основе данных, извлечённых из источника.
Параметры индекса — это конфигурации, которые могут быть настроены для каждого индекса. Они контролируют такие вещи, как производительность индекса, используемые ресурсы и обработку операций.
При создании индекса с помощью коннектора, индекс создается с стандартными оптимизированными для поиска шаблонами отображения полей и параметрами индекса. Отображения для определённых полей затем динамически создаются на основе данных, извлечённых из источника.
Вы можете просмотреть отображение вашего индекса следующими способами:
- В пользовательском интерфейсе Kibana: Перейдите в Поиск > Содержимое > Индексы > YOUR-INDEX > Отображение индекса
- С помощью API: Используйте API получения отображения
Вы можете вручную изменить отображение и параметры через API Elasticsearch:
- Используйте API обновления отображения индекса для обновления отображения индекса.
- Используйте API обновления параметров индекса для обновления параметров индекса.
Важно отметить, что эти обновления более сложны, когда индекс уже содержит данные.
Дополнительную информацию см. в следующих разделах.
Настройка отображения и параметров перед синхронизацией данных
Обновление отображения и параметров проще, когда ваш индекс не содержит данных. Если вы создаёте и подключаете новый индекс во время настройки коннектора, вы можете настроить отображение и параметры перед синхронизацией данных, используя упомянутые ранее API.
Настройка отображения и параметров после синхронизации данных
После добавления данных в Elasticsearch с помощью динамического отображения, вы не можете напрямую обновлять существующее отображение полей. Если вы уже синхронизировали данные в индекс и хотите изменить отображение, вам необходимо переиндексировать ваши данные.
Рабочий процесс для этих обновлений следующий:
- Создайте новый индекс с желаемым отображением и параметрами.
- Переиндексируйте ваши данные из старого индекса в этот новый индекс.
- Удалите старый индекс.
- (Необязательно) Используйте псевдоним, если вы хотите сохранить старое имя индекса.
- Подключите ваш коннектор к новому индексу или псевдониму.
Управление повторяющимися синхронизациями
После создания индекса, который будет управляться коннектором, вы можете настроить автоматическую повторяющуюся синхронизацию.
В пользовательском интерфейсе Kibana перейдите в Поиск > Содержимое > Коннекторы из главного меню или используйте поле глобального поиска.
Выберите индекс для настройки, а затем выберите вкладку Расписание.
В этом интерфейсе вы можете включить или выключить запланированные:
- Полную синхронизацию содержимого
- Инкрементальную синхронизацию содержимого (если поддерживается)
- Синхронизацию управления доступом (если поддерживается)
При включении вы также можете управлять расписанием синхронизации.
Для этой операции требуется доступ к Kibana и к write привилегии к индексам для .elastic-connectors индекса.
В качестве альтернативы, вы можете выполнить синхронизацию один раз.
После включения повторяющейся синхронизации или синхронизации один раз начнется первая синхронизация. (Возможно, потребуется небольшая задержка, прежде чем служба коннекторов начнет первую синхронизацию.) Возможно, вам захочется просмотреть подробности индекса, чтобы увидеть состояние или ошибки, или просмотреть синхронизированные документы.
Синхронизация один раз
После создания индекса, который будет управляться коннектором, вы можете запросить однократную синхронизацию в любое время.
В пользовательском интерфейсе Kibana перейдите в Поиск > Содержимое > Индексы Elasticsearch из главного меню или используйте поле глобального поиска.
Затем выберите индекс для синхронизации.
Независимо от активной вкладки, кнопка Синхронизировать всегда отображается в правом верхнем углу. Нажмите эту кнопку, чтобы открыть параметры синхронизации:
- Полное содержимое
- Инкрементальное содержимое (если поддерживается)
- Управление доступом (если поддерживается)
Выберите один из вариантов, чтобы запросить синхронизацию. (Возможно, потребуется небольшая задержка, прежде чем служба коннекторов начнет синхронизацию.)
Для этой операции требуется доступ к Kibana и к write привилегии к индексам для .elastic-connectors индекса.
Отмена синхронизации
После начала синхронизации вы можете отменить её, прежде чем она завершится.
В пользовательском интерфейсе Kibana перейдите в Поиск > Содержимое > Индексы Elasticsearch из главного меню или используйте поле глобального поиска.
Затем выберите индекс с выполняющейся синхронизацией.
Независимо от активной вкладки, кнопка Синхронизировать всегда отображается в правом верхнем углу. Нажмите эту кнопку, чтобы открыть параметры синхронизации, и выберите Отмена синхронизаций, чтобы отменить активные синхронизации. Это отменит текущую задачу и отметит все ожидающие и приостановленные задачи как отменённые. (Возможно, потребуется небольшая задержка, прежде чем служба коннекторов отменит синхронизации.)
Для этой операции требуется доступ к Kibana и к write привилегии к индексам для .elastic-connectors и .elastic-connectors-sync-jobs индексов.
Просмотр статуса
Просмотрите подробности индекса, чтобы увидеть различные сведения, которые сообщают о состоянии индекса и коннектора.
В пользовательском интерфейсе Kibana перейдите в Поиск > Содержимое > Индексы Elasticsearch из главного меню или используйте поле глобального поиска.
Затем выберите индекс для просмотра.
Вкладка Обзор содержит различные сведения, включая:
- Общая информация об индексе коннектора, например: имя, описание, тип загрузки, тип коннектора и анализатор языка.
- Любые ошибки, влияющие на коннектор или процесс синхронизации.
- Текущий статус загрузки (см. возможные значения ниже).
- Текущее количество документов.
Возможные значения статуса загрузки:
- Незавершенный - коннектор еще не настроен.
- Настроенный - коннектор настроен.
- Подключенный - коннектор может успешно подключиться к источнику данных.
- Ошибка - коннектор не смог подключиться к источнику данных.
- Ошибка коннектора - коннектор не обнаружил никаких обновлений более 30 минут.
- Ошибка синхронизации - коннектор потерпел неудачу в последней задаче синхронизации.
Эта вкладка также отображает историю последних синхронизаций, включая статус синхронизации (см. возможные значения ниже).
Возможные значения статуса синхронизации:
- Ожидание синхронизации - начальный статус задачи, задача ожидает обработки.
- Синхронизация в процессе - задача выполняется.
- Отмена синхронизации - была запрошена отмена задачи.
- Синхронизация отменена - задача была отменена.
- Синхронизация приостановлена - задача была приостановлена из-за остановки службы, и её можно возобновить при перезапуске службы.
- Синхронизация завершена - задача завершена успешно.
- Ошибка синхронизации - задача завершилась неудачно.
Для каждой синхронизации выберите кнопку view, чтобы отобразить подробности задачи, включая:
- Идентификатор задачи
- Статистику документов, включая: количество добавленных/удаленных документов, общее количество документов и объем добавленных документов
- Журналы событий
- Правила синхронизации, которые были активны при запросе синхронизации
- Пайплайны, которые были активны при запросе синхронизации
Для этой операции требуется доступ к Kibana и read привилегии индекса для индекса .elastic-connectors.
Просмотр документов
Просмотр документов, синхронизированных коннектором из данных. Кроме того, просмотр отображений индекса для определения текущей схемы документов.
В пользовательском интерфейсе Kibana перейдите в Поиск > Содержимое > Индексы Elasticsearch из главного меню или используйте поле глобального поиска.
Затем выберите индекс для просмотра.
Выберите вкладку Документы для просмотра синхронизированных документов. Выберите вкладку Отображения индекса для просмотра отображений индекса, созданных коннектором.
При настройке нового коннектора убедитесь, что вы получаете ожидаемые документы и поля из источника данных. Если нет, см. Устранение неполадок для получения помощи.
Для этих операций требуется доступ к Kibana и read и manage привилегии индекса для индекса, содержащего документы.
См. Безопасность для получения подробностей о безопасности.
Управление правилами синхронизации
Используйте правила синхронизации, чтобы ограничить выбор документов, извлекаемых из источника данных, или ограничить выбор извлеченных документов, которые сохраняются в Elastic.
В пользовательском интерфейсе Kibana перейдите в Поиск > Содержимое > Индексы Elasticsearch из главного меню или используйте поле глобального поиска.
Затем выберите индекс для управления и выберите вкладку Правила синхронизации.
Управление пайплайнами загрузки
Используйте пайплайны загрузки, чтобы преобразовать извлеченные данные перед сохранением их в Elastic.
В пользовательском интерфейсе Kibana перейдите в Поиск > Содержимое > Индексы Elasticsearch из главного меню или используйте поле глобального поиска.
Затем выберите индекс для управления и выберите вкладку Пайплайны.
© 2023-2025 Elasticsearch
As of September 2024, Elasticsearch is available under a choice of three licenses: the Server Side Public License (SSPL), the Elastic License, or the AGPLv3 (OSI approved).
Elasticsearch and the Elasticsearch logo are trademarks of Elasticsearch B.V., registered in the U.S. and in other countries.
https://www.elastic.co/guide/en/elasticsearch/reference/8.17/es-connectors-usage.html