Имя файла ошибки 503 не соответствует формату, указанному в регламенте

Обновлено: 02.07.2024

pycodestyle — это инструмент для проверки вашего кода Python на соответствие некоторым соглашениям о стилях в PEP 8.

Функции¶

Отказ от ответственности¶

Эта утилита не обеспечивает соблюдение всех правил PEP 8. Она помогает проверить, применяются ли некоторые соглашения о кодировании, но она не претендует на то, чтобы быть исчерпывающей. Некоторые правила невозможно выразить с помощью простого алгоритма, а другие правила являются лишь рекомендациями, которые при необходимости можно обойти.

Всегда помните это утверждение из PEP 8:

Руководство по стилю — это последовательность. Согласованность с этим руководством по стилю очень важна. Согласованность внутри проекта важнее. Наиболее важна согласованность в рамках одного модуля или функции.

Среди прочего, эти функции в настоящее время не входят в область действия библиотеки pycodestyle:

Установка¶

Вы можете установить, обновить и удалить pycodestyle.py с помощью следующих команд:

Пример использования и вывода¶

Вы также можете заставить pycodestyle.py показывать исходный код для каждой ошибки и даже соответствующий текст из PEP 8:

Или вы можете отобразить, как часто обнаруживалась каждая ошибка:

Вы также можете заставить pycodestyle.py показывать текст ошибки в разных форматах, используя --format с параметрами default/pylint/custom:

Переменные в пользовательском формате

< td>путь
Переменная Значение
имя файла
строка номер строки
col Номер столбца
code Код ошибки
text< /td> Текст ошибки

Быстрая помощь доступна в командной строке:

Конфигурация¶

Поведение можно настроить на двух уровнях: уровне пользователя и уровне проекта.

На уровне пользователя настройки считываются из следующих мест:

Если в Windows: ~\.pycodestyle В противном случае, если определена переменная среды XDG_CONFIG_HOME: XDG_CONFIG_HOME/pycodestyle В противном случае, если XDG_CONFIG_HOME не определена: ~/.config/pycodestyle

На уровне проекта считывается файл setup.cfg или файл tox.ini, если они есть. Если ни в одном из этих файлов нет раздела [pycodestyle], конфигурация конкретного проекта не загружается.

Коды ошибок¶

Это текущий список кодов ошибок и предупреждений:

(*) В конфигурации по умолчанию проверки E121, E123, E126, E133, E226, E241, E242, E704, W503, W504 и W505 игнорируются, поскольку они не являются единогласно принятыми правилами, а PEP 8 не применяется. их. Обратите внимание, что если используется опция --ignore=errors, конфигурация по умолчанию будет переопределена и будет игнорироваться только те проверки, которые вы пропустите. Проверка W503 является взаимоисключающей с проверкой W504. Проверка E133 является взаимоисключающей с проверкой E123. Используйте переключатель --hang-closed, чтобы сообщить об ошибке E133 вместо E123. Используйте переключатель --max-doc-length=n, чтобы сообщить о W505.

Исходная версия продукта: Internet Information Services 7.0 и более поздние версии
Исходный номер базы знаний: 943891

Введение

Расположение файла журнала

IIS 7.0 и более поздние версии по умолчанию помещают файлы журналов в следующую папку:
inetpub\logs\Logfiles

Эта папка содержит отдельные каталоги для каждого веб-сайта World Wide Web. Файлы журналов создаются в каталогах ежедневно и по умолчанию именуются с использованием даты. Например, файл журнала может называться exYYMMDD.log.

1xx – Информационное

  • 100 – Продолжить.
  • 101 – Переключение протоколов.

2xx – успех

  • 200 — ОК. Запрос клиента выполнен успешно.
  • 201 – Создано.
  • 202 – Принято.
  • 203 – Неофициальная информация.
  • 204 – Нет содержания.
  • 205 – Сбросить содержимое.
  • 206 – частичное содержание.

3xx – перенаправление

  • 301 – навсегда перемещено.
  • 302 – Объект перемещен.
  • 304 – не изменено.
  • 307 – Временная переадресация.

4xx — ошибка клиента

400 – Неверный запрос. Запрос не может быть понят сервером из-за неправильного синтаксиса. Клиент не должен повторять запрос без изменений.

  • 400.1 – Недопустимый заголовок назначения.
  • 400.2 – Недопустимый заголовок глубины.
  • 400.3 — Недопустимый заголовок.
  • 400.4 – Неверный заголовок перезаписи.
  • 400.5 – Недопустимый заголовок перевода.
  • 400.6 – Недопустимое тело запроса.
  • 400.7 – Недопустимая длина содержимого.
  • 400.8 – Недопустимый тайм-аут.
  • 400.9 – Недопустимый токен блокировки.

401 — Доступ запрещен.

  • 401.1 – Ошибка входа в систему.
  • 401.2 — Ошибка входа в систему из-за конфигурации сервера.
  • 401.3 — Неавторизовано из-за списка управления доступом к ресурсу.
  • 401.4 – Ошибка авторизации фильтром.
  • 401.5 – Ошибка авторизации приложением ISAPI/CGI.
  • 401.501 — Отказано в доступе: слишком много запросов с одного IP-адреса клиента; Ограничение динамического IP-адреса Достигнут предел скорости одновременных запросов.
  • 401.502 — Запрещено: слишком много запросов с одного IP-адреса клиента; Ограничение динамического IP-адреса Достигнут предел максимальной частоты запросов.
  • 401.503 — Доступ запрещен: IP-адрес включен в список запрещенных IP-ограничений.
  • 401.504 – Доступ запрещен: имя хоста включено в список запрещенных IP-ограничений.
  • 403.1 – Доступ к выполнению запрещен.
  • 403.2 — Доступ для чтения запрещен.
  • 403.3 — Доступ для записи запрещен.
  • 403.4 – требуется SSL.
  • 403.5 – требуется SSL 128.
  • 403.6 — IP-адрес отклонен.
  • 403.7 – требуется сертификат клиента.
  • 403.8 — Доступ к сайту запрещен.
  • 403.9 – Запрещено: слишком много клиентов пытаются подключиться к веб-серверу.
  • 403.10 — Запрещено: веб-сервер настроен на отказ в доступе для выполнения.
  • 403.11 — Запрещено: пароль изменен.
  • 403.12 – Отказано в доступе к картографу.
  • 403.13 – Сертификат клиента отозван.
  • 403.14 – Отказано в размещении в каталоге.
  • 403.15 – Запрещено: клиентские лицензии превысили ограничения на веб-сервере.
  • 403.16 – Сертификат клиента ненадежен или недействителен.
  • 403.17 – срок действия сертификата клиента истек или еще недействителен.
  • 403.18 – невозможно выполнить запрошенный URL-адрес в текущем пуле приложений.
  • 403.19 — Не удается выполнить приложения CGI для клиента в этом пуле приложений.
  • 403.20 – Запрещено: не удалось выполнить вход с использованием паспорта.
  • 403.21 – Запрещено: доступ к источнику запрещен.
  • 403.22 – Запрещено: бесконечная глубина запрещена.
  • 403.501 — Запрещено: слишком много запросов с одного IP-адреса клиента; Ограничение динамического IP-адреса Достигнут предел скорости одновременных запросов.
  • 403.502 — Запрещено: слишком много запросов с одного IP-адреса клиента; Ограничение динамического IP-адреса Достигнут предел максимальной частоты запросов.
  • 403.503 — Запрещено: IP-адрес включен в список запрещенных IP-ограничений.
  • 403.504 — Запрещено: имя хоста включено в список запрещенных IP-ограничений.

404.0 – Не найдено.

404.1 — Сайт не найден.

404.2 — ограничение ISAPI или CGI.

404.3 – ограничение типа многоцелевых расширений почты Интернета (MIME).

404.4 – обработчик не настроен.

404.5 – отклонено конфигурацией фильтрации запросов.

404.6 — Глагол отклонен.

404.7 – Отказано в расширении файла.

404.8 — Скрытое пространство имен.

404.9 — Атрибут файла скрыт.

404.10 — Слишком длинный заголовок запроса.

404.11 — Запрос содержит двойную управляющую последовательность.

404.12 – запрос содержит высокоразрядные символы.

404.13 — Слишком большая длина содержимого.

404.14 – слишком длинный URL-адрес запроса.

404.15 – Слишком длинная строка запроса.

404.16 — DAV-запрос отправлен обработчику статических файлов.

404.17 — динамическое содержимое сопоставляется с обработчиком статических файлов с помощью сопоставления MIME с подстановочными знаками.

404.18 – последовательность строки запроса отклонена.

404.19 – отклонено правилом фильтрации.

404.20 — Слишком много сегментов URL

404.501 – Не найдено: слишком много запросов с одного IP-адреса клиента; Ограничение динамического IP-адреса Достигнут предел скорости одновременных запросов.

404.502 – Не найдено: слишком много запросов с одного IP-адреса клиента; Ограничение динамического IP-адреса Достигнут предел максимальной частоты запросов.

404.503 - Not Found: IP-адрес включен в список запрещенных IP-ограничений

404.504 — Not Found: имя хоста включено в список запрещенных IP-ограничений

405 – метод не разрешен.

406 — Браузер клиента не принимает тип MIME запрошенной страницы.

408 – время ожидания запроса истекло.

412 – Предварительное условие не выполнено.

5xx — ошибка сервера

500 – Внутренняя ошибка сервера.

500.0 — Произошла ошибка модуля или ISAPI.

500.11 — Приложение закрывается на веб-сервере.

500.12 — Приложение перезагружается на веб-сервере.

500.13 — веб-сервер слишком занят.

500.15 — прямые запросы к Global.asax не допускаются.

500.19 — Недопустимые данные конфигурации.

500.21 — Модуль не распознан.

500.50 — Ошибка перезаписи при обработке уведомления RQ_BEGIN_REQUEST. Произошла ошибка конфигурации или выполнения входящего правила.

Здесь считывается конфигурация распределенных правил как для входящих, так и для исходящих правил.

500.51 — Ошибка перезаписи во время обработки уведомления GL_PRE_BEGIN_REQUEST. Произошла глобальная ошибка конфигурации или выполнения глобального правила.

Здесь читается глобальная конфигурация правил.

500.52 — Ошибка перезаписи при обработке уведомления RQ_SEND_RESPONSE. Произошло выполнение исходящего правила.

500.53 — Ошибка перезаписи во время обработки уведомления RQ_RELEASE_REQUEST_STATE. Произошла ошибка выполнения исходящего правила. Правило настроено на выполнение до обновления выходного пользовательского кэша.

500.100 – Внутренняя ошибка ASP.

501 – значения заголовка указывают на нереализованную конфигурацию.

502 – веб-сервер получил неверный ответ, выступая в качестве шлюза или прокси-сервера.

  • 502.1 – тайм-аут приложения CGI.
  • 502.2 – Неверный шлюз: преждевременный выход.
  • 502.3 – Неверный шлюз: ошибка соединения с сервером пересылки (ARR).
  • 502.4 — Неисправный шлюз: нет сервера (ARR).

503 – Служба недоступна.

Подкод Описание
400.10 Неверный X- Заголовок Forwarded-For (XFF)
400.11 Недопустимый запрос WebSocket

Ссылки

Отказ от ответственности за стороннюю информацию

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

В этом разделе содержится справочная информация об ошибках Amazon S3.

Темы

Ответы на ошибки REST

При возникновении ошибки информация в заголовке содержит следующее:

Тело ответа также содержит информацию об ошибке. В следующем образце ответа об ошибке показана структура элементов ответа, общих для всех ответов об ошибках REST.

В следующей таблице объясняются элементы ответа на ошибку REST.

Код ошибки – это строка, однозначно идентифицирующая состояние ошибки. Он предназначен для чтения и понимания программами, которые обнаруживают и обрабатывают ошибки по типу. Дополнительные сведения см. в разделе Список кодов ошибок.

Контейнер для всех элементов ошибок.

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

Идентификатор запроса, связанного с ошибкой.

Корзина или объект, вызвавший ошибку.

Многие ответы об ошибках содержат дополнительные структурированные данные, предназначенные для прочтения и понимания разработчиком, выполняющим диагностику программных ошибок. Например, если вы отправляете заголовок Content-MD5 с запросом REST PUT, который не соответствует дайджесту, рассчитанному на сервере, вы получаете ошибку BadDigest. Ответ об ошибке также включает в качестве элементов сведений дайджест, рассчитанный сервером, и дайджест, который вы сказали серверу ожидать. Во время разработки вы можете использовать эту информацию для диагностики ошибки. В рабочей среде хорошо работающая программа может включить эту информацию в свой журнал ошибок.

Информацию об общих элементах ответа см. в разделе "Ответы об ошибках".

Список кодов ошибок

В следующей таблице перечислены коды ошибок Amazon S3.

Для Amazon S3 на Outposts корзина, которую вы пытались создать, уже существует в вашей Outpost и принадлежит вам.

409 Конфликт (во всех регионах, кроме us-east-1)

Эта ошибка может возникнуть по следующим причинам:

Указанный аргумент недействителен.

В запросе отсутствовал обязательный заголовок.

Указанный аргумент был неполным или имел неверный формат.

Указанный аргумент должен иметь длину больше или равную 3.

Эта ошибка может возникнуть по следующим причинам:

В запросе используется неправильная версия подписи. Используйте AWS4-HMAC-SHA256 (версия подписи 4).

Точку доступа можно создать только для существующего сегмента.

Точка доступа не может быть удалена.

Точка доступа может быть указана только для существующего сегмента.

Следующий токен недействителен.

В правиле жизненного цикла должно быть указано хотя бы одно действие.

Необходимо указать хотя бы одно правило жизненного цикла.

Количество правил жизненного цикла не должно превышать разрешенного предела в 1000 правил.

Недопустимый диапазон параметра MaxResults.

Amazon S3 Transfer Acceleration не поддерживается для корзин с именами, несовместимыми с DNS.

Amazon S3 Transfer Acceleration не поддерживается для сегментов с точками (.) в именах.

Конечная точка Amazon S3 Transfer Acceleration поддерживает только запросы виртуального стиля.

Ускорение передачи Amazon S3 не настроено для этого сегмента.

Ускорение передачи Amazon S3 отключено в этом сегменте.

Ускорение передачи Amazon S3 не поддерживается в этом сегменте. Для получения помощи обратитесь в службу поддержки AWS .

Ускорение передачи Amazon S3 нельзя включить для этого сегмента. Для получения помощи обратитесь в службу поддержки AWS.

Указанный тег не существует.

Список кодов ошибок содержимого объекта SELECT

В следующей таблице приведены специальные ошибки, которые может возвращать SELECT Object Content. Общие сведения об ошибках Amazon S3 и список кодов ошибок см. в разделе Ответы на ошибки.

Список кодов ошибок, связанных с репликацией

В следующей таблице приведены специальные ошибки, которые может возвращать операция репликации. Общие сведения об ошибках Amazon S3 и список кодов ошибок см. в разделе Ответы на ошибки.

Обзор формата

Формат ответа API — JSON. Каждый успешный запрос API возвращает код состояния 2xx.

  • 400 Bad Request, когда параметры отсутствуют или неверны.
  • 422 Unprocessable Entity, когда выражение не может быть выполнено (RFC4918).
  • 503 Служба недоступна, когда время ожидания запросов истекает или прерывается.

Другие коды, отличные от 2xx, могут быть возвращены для ошибок, возникших до достижения конечной точки API.

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

Формат конверта ответа JSON выглядит следующим образом:

Общие заполнители определяются следующим образом:

Примечание. Имена параметров запроса, которые могут повторяться, заканчиваются на [] .

Выражения запросов

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

Мгновенные запросы

Следующая конечная точка оценивает мгновенный запрос в определенный момент времени:

Параметры запроса URL:

  • query= : строка запроса выражения Prometheus.
  • time= : отметка времени оценки. Необязательно.
  • timeout= : время ожидания оценки. Необязательный. По умолчанию имеет значение флага -query.timeout и ограничивается им.

Если параметр времени опущен, используется текущее время сервера.

Вы можете закодировать эти параметры в URL-адресе непосредственно в тексте запроса, используя метод POST и заголовок Content-Type: application/x-www-form-urlencoded. Это полезно при указании большого запроса, который может нарушить ограничения на количество символов в URL на стороне сервера.

Раздел данных результата запроса имеет следующий формат:

относится к данным результата запроса, формат которых зависит от типа результата. См. форматы результатов выражения запроса.

В следующем примере вычисляется выражение up в момент времени 2015-07-01T20:10:51.781Z :

Запросы диапазона

Следующая конечная точка оценивает запрос выражения за определенный период времени:

Параметры запроса URL:

  • query= : строка запроса выражения Prometheus.
  • start= : отметка времени начала включительно.
  • end= : отметка времени окончания включительно.
  • step= : ширина шага разрешения запроса в формате длительности или числа с плавающей запятой в секундах.
  • timeout= : время ожидания оценки. Необязательный. По умолчанию имеет значение флага -query.timeout и ограничивается им.

Вы можете закодировать эти параметры в URL-адресе непосредственно в тексте запроса, используя метод POST и заголовок Content-Type: application/x-www-form-urlencoded. Это полезно при указании большого запроса, который может нарушить ограничения на количество символов в URL на стороне сервера.

Раздел данных результата запроса имеет следующий формат:

Формат заполнителя см. в формате вектора диапазона.

В следующем примере выражение вычисляется в диапазоне 30 секунд с разрешением запроса 15 секунд.

Запрос метаданных

Prometheus предлагает набор конечных точек API для запроса метаданных о сериях и их метках.

ПРИМЕЧАНИЕ. Эти конечные точки API могут возвращать метаданные для рядов, для которых нет образца в выбранном временном диапазоне, и/или для рядов, образцы которых были помечены как удаленные через конечную точку API для удаления. Точный объем дополнительно возвращаемых метаданных серии – это деталь реализации, которая может измениться в будущем.

Поиск серий по сопоставителям ярлыков

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

Параметры запроса URL:

  • match[]= : Аргумент селектора повторяющейся серии, который выбирает возвращаемую серию. Должен быть указан хотя бы один аргумент match[].
  • start= : отметка времени начала.
  • end= : отметка времени окончания.

Вы можете закодировать эти параметры в URL-адресе непосредственно в тексте запроса, используя метод POST и заголовок Content-Type: application/x-www-form-urlencoded. Это полезно при указании большого или динамического количества селекторов серий, которые могут нарушить ограничения на количество символов в URL на стороне сервера.

Раздел данных результата запроса состоит из списка объектов, содержащих пары "имя-значение" метки, которые идентифицируют каждую серию.

В следующем примере возвращаются все ряды, соответствующие селекторам up или process_start_time_seconds :

Получение названий ярлыков

Следующая конечная точка возвращает список имен ярлыков:

Параметры запроса URL:

  • start= : метка времени начала. Необязательно.
  • end= : Отметка времени окончания. Необязательно.
  • match[]= : Аргумент селектора повторяющейся серии, который выбирает серию, из которой считываются имена меток. Необязательно.

Раздел данных ответа JSON представляет собой список имен строковых меток.

Вот пример.

Запрос значений ярлыков

Следующая конечная точка возвращает список значений ярлыка для указанного имени ярлыка:

Параметры запроса URL:

  • start= : метка времени начала. Необязательно.
  • end= : Отметка времени окончания. Необязательно.
  • match[]= : Аргумент селектора повторяющейся серии, который выбирает серию, из которой считываются значения метки. Необязательно.

Раздел данных ответа JSON представляет собой список строковых значений меток.

В этом примере запрашиваются все значения ярлыков для ярлыка задания:

Запрос образцов

Это экспериментальный вариант, который может измениться в будущем. Следующая конечная точка возвращает список экземпляров действительного запроса PromQL для определенного диапазона времени:

Параметры запроса URL:

  • query= : строка запроса выражения Prometheus.
  • start= : отметка времени начала.
  • end= : отметка времени окончания.

Форматы результатов запроса выражения

Запросы-выражения могут возвращать следующие значения ответа в свойстве результата раздела данных. заполнители — это числовые образцы значений. JSON не поддерживает специальные значения с плавающей запятой, такие как NaN , Inf и -Inf , поэтому образцы значений передаются как строки JSON в кавычках, а не как необработанные числа.

Векторы диапазона

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

Мгновенные векторы

Мгновенные векторы возвращаются как тип результата vector . Соответствующее свойство результата имеет следующий формат:

Скаляры

Скалярные результаты возвращаются как скалярный тип результата. Соответствующее свойство результата имеет следующий формат:

Строки

Результаты типа String возвращаются как строка типа результата. Соответствующее свойство результата имеет следующий формат:

Цели

Следующая конечная точка возвращает обзор текущего состояния обнаружения цели Prometheus:

Как активные, так и отброшенные цели по умолчанию являются частью ответа. labels представляет набор меток после перемаркировки. обнаруженные метки представляют собой неизмененные метки, полученные во время обнаружения службы до того, как произошло изменение метки.

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

Правила

Конечная точка /rules API возвращает список загруженных в данный момент правил оповещения и записи. Кроме того, он возвращает текущие активные оповещения, запущенные экземпляром Prometheus каждого правила оповещения.

Поскольку конечная точка /rules является довольно новой, она не имеет таких же гарантий стабильности, как всеобъемлющий API v1.

Параметры запроса URL: - type=alert|record : возвращает только правила оповещения (например, type=alert ) или правила записи (например, type=record ). Если параметр отсутствует или пуст, фильтрация не выполняется.

Оповещения

Конечная точка /alerts возвращает список всех активных оповещений.

Поскольку конечная точка /alerts является довольно новой, она не имеет таких же гарантий стабильности, как всеобъемлющий API v1.

Запрос целевых метаданных

Следующая конечная точка возвращает метаданные о метриках, извлеченных в настоящее время из целей. Это экспериментальный вариант, который может измениться в будущем.

Параметры запроса URL:

  • match_target= : селекторы ярлыков, соответствующие целям по их наборам ярлыков. Если оставить поле пустым, будут выбраны все цели.
  • metric= : имя показателя, для которого необходимо получить метаданные. Все метаданные показателей извлекаются, если оставить их пустыми.
  • limit= : максимальное количество целей для сопоставления.

Раздел данных результата запроса состоит из списка объектов, содержащих метаданные показателей, и набора целевых меток.

В следующем примере возвращаются все записи метаданных для показателя go_goroutines из первых двух целей с меткой job="prometheus" .

В следующем примере возвращаются метаданные для всех показателей для всех целей с экземпляром метки json">curl -G http://localhost:9091/api/v1/targets/metadata \ --data-urlencode 'match_target=' < " status": "success", "data": [ // . < "target": < "instance": "127.0.0.1:9090", "job": "prometheus" >, "metric": "prometheus_treecache_zookeeper_failures_total", "type": "counter", "help": "Общее количество сбоев ZooKeeper.", "unit": "" >, < "target": < "instance": "127.0.0.1:9090", "job": "prometheus" >, "metric": "prometheus_tsdb_reloads_total", "type": " counter", "help": "Количество раз, когда база данных перезагружала блочные данные с диска.", "unit": "" >, // . ] >

Запрос метаданных метрики

Он возвращает метаданные о показателях, которые в настоящее время удалены из целей. Однако он не предоставляет никакой целевой информации. Это считается экспериментальным и может измениться в будущем.

Параметры запроса URL:

  • limit= : максимальное количество возвращаемых показателей.
  • metric= : имя показателя для фильтрации метаданных. Все метаданные показателей извлекаются, если оставить их пустыми.

Раздел данных результата запроса состоит из объекта, где каждый ключ представляет собой имя метрики, а каждое значение представляет собой список уникальных объектов метаданных, представленных для этого имени метрики во всех целях.

Алерт-менеджеры

Следующая конечная точка возвращает обзор текущего состояния обнаружения Prometheus alertmanager:

Как активные, так и удаленные Alertmanager являются частью ответа.

Статус

Следующие конечные точки статуса отображают текущую конфигурацию Prometheus.

Конфигурация

Следующая конечная точка возвращает текущий загруженный файл конфигурации:

Конфигурация возвращается в виде файла дампа YAML. Из-за ограничений библиотеки YAML комментарии YAML не включены.

Флаги

Следующая конечная точка возвращает значения флагов, с которыми был настроен Prometheus:

Все значения имеют тип результата string .

Информация о времени выполнения

Следующая конечная точка возвращает различные свойства информации о сервере Prometheus во время выполнения:

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

Информация о сборке

Следующая конечная точка возвращает различные свойства информации о сборке сервера Prometheus:

Все значения имеют тип результата string .

Статистика TSDB

Следующая конечная точка возвращает различную кардинальность статистики о TSDB Prometheus:

  • headStats: предоставляет следующие данные о головном блоке TSDB:
    • numSeries: количество серий.
    • chunkCount: количество фрагментов.
    • minTime: текущая минимальная метка времени в миллисекундах.
    • maxTime: текущая максимальная метка времени в миллисекундах.

    Статистика воспроизведения WAL

    Следующая конечная точка возвращает информацию о воспроизведении WAL:

    чтение: количество воспроизведенных на данный момент сегментов. total: общее количество сегментов, которые необходимо воспроизвести. progress: Ход повтора (0–100%). состояние: состояние повтора. Возможные состояния: - ожидание: ожидание начала воспроизведения. - в процессе: идет повтор. - сделано: воспроизведение завершено.

    ПРИМЕЧАНИЕ. Эта конечная точка доступна до того, как сервер будет помечен как готовый, и обновляется в режиме реального времени, чтобы упростить мониторинг хода воспроизведения WAL.

    API администратора TSDB

    Это API-интерфейсы, предоставляющие функции базы данных опытным пользователям. Эти API не включены, если не задан параметр --web.enable-admin-api.

    Снимок

    Snapshot создает снимок всех текущих данных в snapshots/ - в каталоге данных TSDB и возвращает каталог в качестве ответа. При необходимости будут пропущены данные моментального снимка, которые присутствуют только в головном блоке и еще не были сжаты на диск.

    Параметры запроса URL:

    • skip_head= : пропустить данные, присутствующие в блоке заголовка. Необязательно.

    Снимок теперь существует по адресу /snapshots/20171210T211224Z-2be650b6d019eb54

    Новое в версии 2.1 и поддержка PUT из версии 2.9

    Удалить серию

    DeleteSeries удаляет данные для выбранных серий во временном диапазоне. Фактические данные по-прежнему существуют на диске и очищаются при будущих сжатиях или могут быть очищены явным образом путем нажатия на конечную точку Clean Tombstones.

    В случае успеха возвращается код 204.

    Параметры запроса URL:

    • match[]= : повторяющийся аргумент сопоставления меток, который выбирает серию для удаления. Должен быть указан хотя бы один аргумент match[].
    • start= : метка времени начала. Необязательно, по умолчанию установлено минимально возможное время.
    • end= : Отметка времени окончания. Необязательно и по умолчанию максимально возможное время.

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

    ПРИМЕЧАНИЕ. Эта конечная точка помечает выборки из серии как удаленные, но не обязательно предотвратит возврат связанных метаданных серии в запросах метаданных для затронутого диапазона времени (даже после очистки надгробий). Точный объем удаления метаданных зависит от реализации и может измениться в будущем.

    Новое в версии 2.1 и поддержка PUT из версии 2.9

    Очистить надгробия

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

    В случае успеха возвращается код 204.

    Это не требует параметров или тела.

    Новое в версии 2.1 и поддержка PUT из версии 2.9

    Удаленный приемник записи

    Prometheus можно настроить как приемник для протокола удаленной записи Prometheus. Это не считается эффективным способом приема образцов. Используйте его с осторожностью для конкретных случаев использования с небольшим объемом. Он не подходит для замены сбора данных с помощью парсинга и превращения Prometheus в систему сбора метрик на основе push-уведомлений.

    Читайте также: