Справочник по коннектору Elastic Slack

Этот коннектор доступен в качестве самоуправляемого самоуправляемого коннектора из фреймворка Elastic Connector.

Этот самоуправляемый коннектор совместим с версиями Elastic 8.10.0+.

Чтобы использовать этот коннектор, выполните все требования самоуправляемых коннекторов.

Чтобы создать новый коннектор Slack:

Вы можете использовать Elasticsearch API создания коннектора для создания нового самоуправляемого коннектора Slack.

Например:

resp = client.connector.put(
    connector_id="my-{service-name-stub}-connector",
    index_name="my-elasticsearch-index",
    name="Content synced from {service-name}",
    service_type="{service-name-stub}",
)
print(resp)

const response = await client.connector.put({
  connector_id: "my-{service-name-stub}-connector",
  index_name: "my-elasticsearch-index",
  name: "Content synced from {service-name}",
  service_type: "{service-name-stub}",
});
console.log(response);

PUT _connector/my-slack-connector
{
  "index_name": "my-elasticsearch-index",
  "name": "Content synced from Slack",
  "service_type": "slack"
}

Для получения подробностей обо всех доступных API коннекторов обратитесь к документации API Elasticsearch.

Чтобы использовать этот коннектор как самоуправляемый коннектор, используйте рабочие процессы Коннектора в пользовательском интерфейсе Kibana.

Для дополнительных операций см. Пользовательский интерфейс коннекторов в Kibana.

При создании вы получите учетные данные, которые используются коннектором для аутентификации. Также будет создан новый бот-пользователь.

Чтобы создать приложение, выполните следующие шаги:

Вы можете развернуть коннектор Slack как самоуправляемый коннектор с помощью Docker. Следуйте этим инструкциям.

curl https://raw.githubusercontent.com/elastic/connectors/main/config.yml.example --output ~/connectors-config/config.yml

# When connecting to your cloud deployment you should edit the host value
elasticsearch.host: http://host.docker.internal:9200
elasticsearch.api_key: <ELASTICSEARCH_API_KEY>

connectors:
  -
    connector_id: <CONNECTOR_ID_FROM_KIBANA>
    service_type: slack
    api_key: <CONNECTOR_API_KEY_FROM_KIBANA> # Optional. If not provided, the connector will use the elasticsearch.api_key instead

docker run \
-v ~/connectors-config:/config \
--network "elastic" \
--tty \
--rm \
docker.elastic.co/enterprise-search/elastic-connectors:8.17.3 \
/app/bin/elastic-ingest \
-c /config/config.yml

Обратитесь к DOCKER.md в репозитории elastic/connectors для получения дополнительной информации.

Найдите все доступные Docker образы в официальном репозитории.

Для настройки этого коннектора требуются следующие параметры:

Базовые правила синхронизации идентичны для всех коннекторов и доступны по умолчанию.

Расширенные правила синхронизации недоступны для этого коннектора в текущей версии.

Дополнительную информацию см. в Типы правил синхронизации.

Этот коннектор в настоящее время не поддерживает обработку вложений Slack или других двоичных файлов.

Коннектор синхронизирует следующие объекты и сущности:

Фреймворк подключения позволяет операторам выполнять функциональные тесты с реальным источником данных. Для получения более подробной информации см. Тестирование подключения.

Для выполнения тестирования от «конца до конца» для подключения к GitHub выполните следующую команду:

$ make ftest NAME=slack

Для ускорения тестов добавьте флаг DATA_SIZE=small:

make ftest NAME=slack DATA_SIZE=small

В настоящее время для данного подключения известных проблем нет. Список известных проблем для всех подключений см. в Известные проблемы.

См. Устранение неполадок.

См. Безопасность.