Диагностика и устранение неисправностей¶

Сервисы VK People Hub¶

Ошибка 401 при заходе в портал¶

При заходе в портал пользователь может увидеть ошибку 401 — Ошибка при создании UserProfileKeycloak. Другой пользователь с таким username существует. Данная ошибка заключается в том, что данного пользователя добавили в сервис KeyCloak, потом удалили и создали заново с таким же username Для исправления данной ошибки нужно удалить данного пользователя из KeyCloak и создать заново с новым уникальным username.

Ошибка — Файловое хранилище еще не создано¶

При попытке зайти в личное файловое хранилище пользователь может увидеть ошибку — Файловое хранилище еще не создано. Данная ошибка возникает из-за того, что сервис создания личного файлового хранилища еще не обработал учетную запись данного пользователя из KeyCloak. Данная обработка происходит раз в час. Пользователю нужно попробовать воспользоваться личным файловым хранилищем через час.

Истек срок действия токена — token expire¶

При работе в портале может возникнуть ошибка — token expire. Причина данной ошибки — истечения срока действия токена. Для решения данной ошибки нужно обновить портал кнопкой F5 или в случае неудачи точечно получить новый токен из KeyCloak.

Ошибка 403 при получении токена¶

При возникновении ошибки 403 при получении токена, нужно убедиться, что в переменных окружения стоит верная audience, realm и KEYCLOAK_API_BASE_URL (адрес KeyCloak).

Ошибка при попытке загрузить файл¶

При попытке загрузить файл куда-либо внутри портала может возникнуть ошибка — Размер файла очень большой. Для ее исправления нужно выставить корректный максимальный размер файла. По умолчанию максимальный размер файла для загрузки на портал — 2Гбайта.

Прикладное программное обеспечение¶

Kafka¶

Kafka брокер не запускается из-за нехватки памяти.¶

Необходимо увеличить параметр Xmx в heapOpts: -Xmx1024m -Xms1024m. Необходимо увеличить лимиты ресурсов в values helm chart.

Продюсер не может отправить сообщения на топик из-за ограничений по размеру сообщения.¶

Необходимо увеличить параметр message.max.bytes в конфигурации топика или продюсера.

Minio¶

Minio сервер выдает ошибку «Access Denied» при попытке доступа к объектам.¶

Необходимо проверить корректность настроек доступа, включая правильные ключи доступа и секреты.

Недоступность Minio сервера из-за неправильной конфигурации ingress в Kubernetes.¶

Необходимо проверить настройки Ingress и убедиться, что сервис Minio правильно доступен извне.

PostgreSQL¶

Ошибка «Connection refused» при попытке подключения к PostgreSQL¶

Необходимо проверить корректность настроек подключения к PostgreSQL, убедиться, что указан правильный хост и порт. Проверить доступность базы данных и состояние контейнера PostgreSQL.

Произошел сбой при обновлении базы данных из-за отсутствия места на диске.¶

Необходимо освободить место на диске или увеличить размер данных на сервере.

Redis¶

Redis сервер периодически отключается из-за истечения времени жизни соединения.¶

Необходимо увеличить таймаут на соединение в конфигурации Redis.

Keycloak¶

Ошибка аутентификации пользователей из-за неправильной конфигурации клиентского приложения. В ответах API запроса сервиса «Отсутствует токен в запросе» или «Неверный токен».¶

Необходимо проверить настройки клиентского приложения в Keycloak и убедиться, что они совпадают с конфигурацией на сервере (jwt_pub_token или keycloak_audince).

Проблемы с обновлением паролей пользователей через Keycloak.¶

Необходимо пересмотреть настройки политики паролей и прав доступа к изменению паролей.