# Коды ошибок

Справочник кодов ошибок и их описание

> Индекс всей документации в markdown: https://statuser.cloud/llms.txt — там перечислены остальные статьи. Всё одним файлом: https://statuser.cloud/llms-full.txt. Документация API: https://statuser.cloud/api-reference.md

## Доступность по тарифам

Доступно на всех тарифах

Справочник кодов не зависит от тарифа, но часть кодов относится к проверкам, доступным не на всех тарифах, — например, ошибки SSL, домена и DNS.

Сравнение тарифов: https://statuser.cloud/pricing

---

В Statuser обрабатывается **больше 100 уникальных ошибок**, каждая из которых имеет свой код. Это позволяет быстро понять, что произошло и какие действия нужно предпринять для решения проблемы.

Для удобства все ошибки сгруппированы по типам и имеют краткое описание.

#### Ошибки сети

Ошибки, связанные с проблемами подключения или прерываниями в сетевом соединении.

| Ошибка                     | Подробное описание                                             |
|----------------------------|-----------------------------------------------------------------|
| Подключение отклонено      | Сервер отклонил запрос на подключение. |
| Соединение было сброшено   | Соединение с сервером было сброшено на этапе обмена данными.   |
| Сеть недоступна            | Невозможно достичь указанной сети.     |
| Нарушено соединение        | Соединение было прервано на стороне клиента или сервера.       |
| Доступ запрещён            | Запрос на соединение был отклонён из-за отсутствия прав доступа. |
| Хост недоступен            | Указанный хост недоступен для подключения. |
| Сокет был закрыт           | Сокет был закрыт перед завершением операции обмена данными.    |
| Превышено время ожидания подключения | Время ожидания ответа от сервера истекло. |

#### 4xx ошибки HTTP

Ошибки, возникающие из-за неверных запросов, например, из-за неправильного формата данных или отсутствия доступа.

| Ошибка                          | Подробное описание                                                                   |
|---------------------------------|-------------------------------------------------------------------------------------|
| 400 Bad Request                 | Неверный запрос, сервер не может понять или обработать запрос из-за синтаксической ошибки. |
| 401 Unauthorized                | Неавторизованный доступ, требуется аутентификация для выполнения запроса.            |
| 402 Payment Required            | Требуется оплата для продолжения запроса.                                            |
| 403 Forbidden                   | Доступ к ресурсу запрещён.                                                          |
| 404 Not Found                   | Ресурс не найден на сервере.                                                        |
| 405 Method Not Allowed          | Метод HTTP не разрешён для данного ресурса.                                         |
| 406 Not Acceptable              | Формат ответа, указанный в запросе, не поддерживается сервером.                     |
| 407 Proxy Authentication Required | Требуется аутентификация через прокси-сервер для выполнения запроса.                |
| 408 Request Timeout             | Превышено время ожидания запроса от клиента.                                         |
| 409 Conflict                    | Конфликт с текущим состоянием ресурса, запрос не может быть выполнен.                |
| 410 Gone                        | Ресурс был удалён и больше не доступен.                                              |
| 411 Length Required             | Не указан размер содержимого запроса.                                               |
| 412 Precondition Failed         | Не выполнено одно из условий для выполнения запроса.                                |
| 413 Payload Too Large           | Тело запроса слишком велико для обработки сервером.                                 |
| 414 URI Too Long                | URI запроса слишком длинный для обработки сервером.                                 |
| 415 Unsupported Media Type      | Тип медиа в запросе не поддерживается сервером.                                      |
| 416 Range Not Satisfiable       | Запрашиваемый диапазон данных не может быть удовлетворён сервером.                  |
| 417 Expectation Failed          | Ожидания, указанные в запросе, не могут быть выполнены сервером.                    |
| 418 I'm a teapot                | Это шутка, сервер возвращает ответ "я чайник".                                      |
| 421 Misdirected Request         | Запрос направлен не на тот сервер, который может его обработать.                   |
| 422 Unprocessable Entity        | Запрос не может быть обработан из-за синтаксической ошибки в содержимом.            |
| 423 Locked                      | Ресурс заблокирован и не может быть изменён.                                         |
| 424 Failed Dependency           | Запрос не может быть выполнен из-за сбоя в зависимых запросах.                      |
| 425 Too Early                   | Запрос поступил слишком рано, сервер ещё не готов к его обработке.                  |
| 426 Upgrade Required            | Требуется обновление протокола для выполнения запроса.                              |
| 428 Precondition Required       | Требуется выполнение предварительных условий для выполнения запроса.               |
| 429 Too Many Requests           | Слишком много запросов было отправлено за короткий промежуток времени.             |
| 431 Header Fields Too Large     | Заголовки запроса слишком большие для обработки сервером.                           |
| 451 Unavailable For Legal Reasons | Доступ к ресурсу ограничен по юридическим причинам.                                 |

#### 5xx ошибки HTTP

Ошибки, возникающие на сервере, находящемся под мониторингом, когда он не может обработать запрос из-за внутренних проблем.

| Ошибка                          | Подробное описание                                                                 |
|---------------------------------|-----------------------------------------------------------------------------------|
| 500 Internal Server Error       | Внутренняя ошибка сервера, запрос не может быть выполнен из-за проблем на сервере.|
| 501 Not Implemented             | Сервер не поддерживает функциональность, необходимую для выполнения запроса.     |
| 502 Bad Gateway                 | Ошибка шлюза, сервер получил некорректный ответ от вышестоящего сервера.          |
| 503 Service Unavailable         | Сервис временно недоступен, возможно, из-за перегрузки или технического обслуживания.|
| 504 Gateway Timeout             | Превышено время ожидания ответа от вышестоящего сервера.                          |
| 505 HTTP Version Not Supported  | Запрашиваемая версия HTTP не поддерживается сервером.                             |
| 506 Variant Also Negotiates     | Ошибка при попытке согласования варианта контента на сервере.                    |
| 507 Insufficient Storage        | На сервере недостаточно места для выполнения запроса.                             |
| 508 Loop Detected               | Обнаружен бесконечный цикл при обработке запроса.                                 |
| 510 Not Extended                | Запрос требует дополнительных расширений, которые не поддерживаются сервером.   |
| 511 Network Authentication Required | Требуется аутентификация для доступа к сети.                                      |

#### Ошибки Nginx

Ошибки, связанные с проблемами конфигурации и обработки запросов в веб-сервере Nginx.

| Ошибка                     | Подробное описание                                                    |
|----------------------------|------------------------------------------------------------------------|
| Нет ответа от сервера         | Сервер не предоставил ответ и закрыл соединение, возможно, из-за внутренней ошибки.|
| Слишком большой заголовок | Размер заголовка запроса превышает допустимые ограничения, установленные на сервере.|
| Неверный клиентский сертификат    | Клиентский сертификат недействителен или не соответствует требованиям сервера.    |
| Требуется клиентский сертификат  | Для установления соединения требуется предоставить корректный клиентский сертификат.|
| HTTP-запрос на HTTPS-порт | Запрос с использованием HTTP протокола отправлен на порт, ожидающий HTTPS соединения. |
| Клиент закрыл соединение          | Клиент завершил соединение до получения полного ответа от сервера.                |

#### Ошибки Cloudflare

Ошибки, связанные с проблемами конфигурации и обработки запросов при использовании Cloudflare.

| Ошибка                     | Подробное описание                                                    |
|----------------------------|------------------------------------------------------------------------|
| Неизвестный ответ             | Сервер вернул пустой или неизвестный ответ.         |
| Сервер недоступен             | Сервер отказал в соединении.                        |
| Таймаут соединения            | Превышено время ожидания соединения с сервером.     |
| Неверные DNS-записи           | Сервер недоступен, возможно из-за неверных DNS-записей. |
| Таймаут HTTP-ответа           | Превышено время ожидания HTTP-ответа от сервера.    |
| Ошибка SSL/TLS рукопожатия    | Произошла ошибка при установлении SSL/TLS соединения.|
| Неверный SSL-сертификат       | Установлен некорректный SSL-сертификат на сервере.  |

#### Ошибки AWS

Ошибки, происходящие в облачной инфраструктуре AWS, связанные с некорректной конфигурацией или аутентификацией.

| Ошибка                         | Подробное описание                                                                                 |
|--------------------------------|-----------------------------------------------------------------------------------------------------|
| Клиент закрыл соединение       | Соединение было завершено клиентом до истечения установленного времени ожидания.                   |
| Слишком много IP-адресов       | Количество IP-адресов в заголовке X-Forwarded-For превышает допустимый лимит (30).                 |
| Несовместимость протоколов     | Версии протоколов, используемые клиентом и сервером, несовместимы для установления соединения.     |
| Ошибка аутентификации          | Запрос не был аутентифицирован из-за ошибок взаимодействия с провайдером идентификации.            |

#### Ошибки при поиске текста

Ошибки, возникающие при проверке наличия/отсутствия текста в HTTP‑ответе.

| Ошибка | Подробное описание |
|---|---|
| Текст не найден | Указанный текст не найден в ответе (в режиме «Успех, если текст есть»). |
| Текст найден | Текст найден в ответе, но ожидалось отсутствие (в режиме «Успех, если текста нет»). |

#### Ошибки DNS

Ошибки, связанные с разрешением доменных имен и поиском серверов по их именам.

| Ошибка                     | Подробное описание                                                    |
|----------------------------|------------------------------------------------------------------------|
| Хост не найден             | Указанный хост не найден в DNS. Это может быть связано с некорректным именем хоста или его отсутствием в системе имен. |
| Временная ошибка DNS       | Произошла временная ошибка при обращении к DNS. |
| Указанный адрес недоступен | Указанный IP-адрес недоступен или не может быть использован для подключения. |

### Ошибки SSL

Ошибки, возникающие при установлении защищённого SSL-соединения.

| Ошибка                                   | Подробное описание                                                                              |
|------------------------------------------|--------------------------------------------------------------------------------------------------|
| Самоподписанный сертификат               | Установлен самоподписанный сертификат, который не может быть проверен доверенными центрами сертификации. |
| Самоподписанный сертификат в цепочке     | В цепочке сертификатов найден самоподписанный сертификат, что нарушает требования безопасности.  |
| Неверное имя в TLS сертификате           | Имя хоста не соответствует имени, указанному в поле **Subject Alternative Name** TLS-сертификата.   |
| Невозможно проверить подпись сертификата | Подпись сертификата не может быть проверена, вероятно, из-за отсутствия доверия к его центру сертификации. |
| Срок действия сертификата истёк          | Срок действия TLS-сертификата истёк, требуется его обновление.                                  |
| Сертификат ещё недействителен            | Сертификат еще не начал действовать. |
| Размер параметров DH слишком мал         | Размер параметров Диффи-Хеллмана (DH) слишком мал для обеспечения безопасного соединения.        |
| TLS повторное согласование отключено     | Попытка выполнения повторного согласования в TLS-соединении была отклонена, так как эта функция отключена. |

#### Ошибки cURL

Для выполнения запросов из Statuser используется библиотека cURL. Для этой библиотеки может возникнуть ряд ошибок, которые могут быть связаны с некорректными параметрами запроса, сетевыми проблемами или ошибками на сервере.

| Ошибка                          | Подробное описание                                                                   |
|---------------------------------|-------------------------------------------------------------------------------------|
| Неподдерживаемый протокол       | Указанный протокол не поддерживается текущей версией cURL.                           |
| Ошибка инициализации            | Не удалось выполнить начальную настройку cURL для запроса.                           |
| Неверный URL                    | Синтаксис URL указан неверно, проверьте формат.                                      |
| Функция отключена               | Требуемая функция или опция отключена в данной сборке cURL.                         |
| Прокси не найден                | Указанный прокси-сервер не может быть разрешён.                                     |
| Хост не найден                  | Указанный хост не может быть разрешён (ошибка DNS).                                 |
| Хост недоступен                 | Не удалось установить соединение с указанным хостом.                                |
| Непонятный ответ сервера        | Сервер отправил данные, которые cURL не смог разобрать.                             |
| Доступ к FTP запрещён           | Сервер FTP отклонил вход или доступ к ресурсу.                                      |
| Ошибка FTP-подключения          | Ошибка при ожидании активного подключения FTP.                                      |
| Неверный ответ PASS             | Сервер FTP отправил непонятный ответ на команду PASS.                               |
| Таймаут FTP                     | Превышено время ожидания активного подключения FTP.                                 |
| Неверный ответ PASV             | Сервер FTP отправил непонятный ответ на команду PASV.                               |
| Неверный формат 227             | Неправильный формат строки 227, отправленной сервером FTP.                          |
| Неверный IP-адрес               | Не удалось разрешить IP-адрес хоста из строки 227.                                  |
| Ошибка HTTP/2                   | Произошла ошибка в слое HTTP/2.                                                     |
| Ошибка режима FTP               | Не удалось переключиться на бинарный режим передачи данных.                         |
| Частичная загрузка              | Была передана только часть файла.                                                   |
| Ошибка загрузки FTP             | Не удалось загрузить файл с FTP-сервера.                                            |
| Ошибка команды QUOTE            | Ошибка при выполнении пользовательской команды QUOTE.                               |
| HTTP-ошибка                     | Сервер вернул ошибку HTTP (код 400 или выше).                                       |
| Ошибка записи                   | Произошла ошибка при записи данных.                                                 |
| Ошибка отправки FTP             | Не удалось отправить файл на FTP-сервер.                                            |
| Ошибка чтения                   | Произошла ошибка при чтении данных.                                                 |
| Недостаточно памяти             | Не хватает памяти для выполнения операции.                                          |
| Таймаут операции                | Превышено время ожидания выполнения операции.                                       |
| Ошибка команды PORT             | Ошибка при выполнении команды PORT в FTP.                                           |
| Ошибка команды REST             | Ошибка при выполнении команды REST в FTP.                                           |
| Ошибка RANGE                    | Ошибка при обработке диапазона данных.                                              |
| Ошибка POST                     | Ошибка при генерации или отправке POST-запроса.                                     |
| Ошибка SSL                      | Не удалось установить SSL-соединение.                                               |
| Ошибка возобновления            | Не удалось возобновить загрузку файла.                                              |
| Файл не читается               | Указанный файл не может быть прочитан.                                              |
| Ошибка LDAP-привязки           | Ошибка при попытке привязки к серверу LDAP.                                         |
| Ошибка LDAP-поиска             | Ошибка при выполнении поиска в LDAP.                                                |
| Функция не найдена              | Требуемая функция LDAP не найдена.                                                 |
| Операция прервана               | Операция была прервана callback-функцией.                                           |
| Неверный аргумент               | Функция вызвана с некорректным параметром.                                          |
| Ошибка интерфейса               | Ошибка при использовании сетевого интерфейса.                                       |
| Слишком много редиректов        | Превышено допустимое количество редиректов.                                         |
| Неизвестная опция               | Использована неизвестная или неподдерживаемая опция.                                |
| Ошибка telnet                   | Неверный синтаксис в опции telnet.                                                  |
| Ошибка сертификата              | Ошибка при проверке SSL-сертификата сервера.                                        |
| Нет ответа                      | Сервер не отправил никаких данных.                                                  |
| SSL-движок не найден            | Указанный SSL-движок не найден.                                                     |
| Ошибка SSL-движка               | Не удалось установить SSL-движок по умолчанию.                                      |
| Ошибка отправки                 | Произошла ошибка при отправке данных.                                               |
| Ошибка получения                | Произошла ошибка при получении данных.                                              |
| Проблема с сертификатом         | Проблема с локальным SSL-сертификатом.                                              |
| Ошибка шифра                    | Не удалось использовать указанный шифр.                                             |
| Ошибка CA                       | Ошибка при проверке CA-сертификата.                                                 |
| Неверное кодирование            | Неверное кодирование содержимого ответа.                                            |
| Неверный URL LDAP               | Указанный URL для LDAP имеет неверный формат.                                       |
| Файл слишком большой            | Размер файла превышает допустимый лимит.                                            |
| Ошибка SSL                      | Общая ошибка при использовании SSL.                                                 |
| Ошибка перемотки                | Ошибка при перемотке данных для повторной отправки.                                 |
| Ошибка инициализации SSL        | Не удалось инициализировать SSL-движок.                                             |
| Ошибка входа                    | Ошибка при попытке входа на сервер.                                                 |
| Файл не найден (TFTP)           | Указанный файл не найден на TFTP-сервере.                                           |
| Ошибка прав (TFTP)              | Недостаточно прав для доступа к файлу на TFTP-сервере.                              |
| Место закончилось               | Недостаточно места на TFTP-сервере для выполнения операции.                         |
| Недопустимая операция           | Попытка выполнить недопустимую операцию на TFTP-сервере.                            |
| Неизвестный ID                  | Неизвестный идентификатор передачи TFTP.                                            |
| Файл существует                 | Указанный файл уже существует на TFTP-сервере.                                      |
| Пользователь не найден          | Указанный пользователь не существует на TFTP-сервере.                               |
| Ошибка преобразования           | Ошибка при преобразовании символов.                                                 |
| Требуется преобразование        | Требуется преобразование символов, но оно не было выполнено.                        |
| Ошибка CA-файла                 | Ошибка при чтении CA-сертификата.                                                   |
| Файл не найден                  | Удалённый файл не найден.                                                           |
| Ошибка SSH                      | Произошла ошибка в SSH-сессии.                                                      |
| Ошибка завершения SSL           | Ошибка при завершении SSL-соединения.                                               |
| Повторить запрос                | Запрос должен быть повторён.                                                        |
| Ошибка CRL-файла                | Ошибка при чтении CRL-файла.                                                        |
| Ошибка издателя                 | Ошибка при проверке издателя сертификата.                                           |
| Ошибка PRET                     | Ошибка при выполнении команды PRET в FTP.                                           |
| Ошибка CSeq                     | Неправильная последовательность CSeq в RTSP.                                        |
| Ошибка сессии RTSP              | Ошибка в идентификаторе сессии RTSP.                                                |
| Ошибка списка файлов            | Ошибка при разборе списка файлов FTP.                                               |
| Ошибка chunk                    | Ошибка в callback-функции chunk.                                                    |
| Нет соединения                  | Нет доступного соединения для выполнения запроса.                                   |
| Неверный ключ                   | Ошибка при проверке публичного ключа.                                               |
| Неверный статус                 | Неверный статус SSL-сертификата.                                                    |
| Ошибка потока HTTP/2            | Ошибка в потоке HTTP/2.                                                             |

#### Общие ошибки

Иногда при проверках могут возникать ошибки, которые не описаны в Statuser.
Например, такое может произойти, если приложение отдает какой-то собственный код ошибки, который не описан в официальных стандартах.

В этом случае будет выведен один из общих кодов.

| Ошибка                  | Подробное описание                                                    |
|-------------------------|-----------------------------------------------------------------------|
| Неизвестная ошибка Ping | Произошла ошибка при выполнении Ping-запроса, причина не установлена. |
| Неизвестная ошибка TCP  | Возникла ошибка при установлении TCP-соединения, причина неизвестна.  |
| Неизвестная ошибка HTTP | Произошла ошибка при выполнении HTTP-запроса, причина не определена.  |
| Код ответа не входит в список успешных | Сервер вернул HTTP-код, который не входит в список ожидаемых успешных кодов, заданных в настройках сервера. |
| Неизвестная ошибка      | Произошла неизвестная ошибка.                                         |

#### Ошибки Heartbeat

Ошибки, связанные с мониторингом Heartbeat (входящие запросы от ваших задач/сервисов).

| Код ошибки          | Подробное описание                                                       |
| ------------------- | ------------------------------------------------------------------------ |
| `heartbeat_timeout` | Heartbeat не пришёл в ожидаемый интервал (с учётом допустимой задержки). |
| `heartbeat_failure` | Задача явно сообщила об ошибке через endpoint `/fail`.                   |

---

Источник: https://statuser.cloud/docs/error-codes
