GET один SLO
Получает параметр указанной цели уровня обслуживания (SLO).
Если указаны параметры from и to , SLO рассчитывается для этого таймфрейма; в противном случае используется собственный таймфрейм SLO.
Запрос создает в качестве полезной нагрузки application/json
формат.
GET | Managed | https://{your-domain}/e/{your-environment-id}/api/v2/slo/{id}
|
Cреда ActiveGate | https://{your-activegate-domain}/e/{your-environment-id}/api/v2/slo/{id}
|
Аутентификация
Чтобы выполнить этот запрос, вам нужен токен доступа с областью действия Read SLO ( slo.read
) . Чтобы узнать, как его получить и использовать, см. раздел Токены и аутентификация .
Параметры
Параметр | Тип | Описание | In | Необходимость |
---|---|---|---|---|
from | string | Начало запрошенного таймфрейма.
Вы можете использовать один из следующих форматов:
Если не задано, используется относительный двухнедельный таймфрейм ( |
query | по желанию |
to | string | Конец запрошенного периода времени.
Вы можете использовать один из следующих форматов:
Если не установлено, используется текущая метка времени. |
query | по желанию |
id | string | Идентификатор требуемого SLO. | path | требуется |
timeFrame | string | Таймфрейм для расчета значений SLO:
Если не задано, используется Элемент может содержать эти значения
|
query | по желанию |
Ответ
Коды ответов
Код | Тип | Описание |
---|---|---|
200 | SLO | Успех. Ответ содержит параметры и расчетные значения запрошенного SLO. |
400 | ErrorEnvelope | Не удалось. Ввод недействителен. |
404 | ErrorEnvelope | Не удалось. Запрошенный ресурс не существует. |
Объекты тела ответа
Объект SLO
Параметры целевого уровня обслуживания (SLO).
Элемент | Тип | Описание |
---|---|---|
string[] | УСТАРЕЛО
Фильтр сущностей для получения количества проблем, связанных с SLO. Генерируется автоматически, если в SLO не был добавлен фильтр. | |
metricExpression | string | Процентное выражение метрики для расчета SLO. |
boolean | УСТАРЕЛО
Тип метрики для расчета SLO:
Список доступных метрик см. на странице встроенных метрик или попробуйте вызов API GET метрик . | |
string | УСТАРЕЛО
Процентная метрика для расчета SLO. Требуется, если для параметра useRateMetric установлено значение | |
string | УСТАРЕЛО
Метрика количества успехов (числитель при расчете рейтинга). Требуется, если для параметра useRateMetric установлено значение | |
string | УСТАРЕЛО
Метрика общего количества (знаменатель при расчете скорости). Требуется, если для параметра useRateMetric установлено значение | |
evaluationType | string | Тип оценки SLO.
Элемент может содержать эти значения
|
errorBudgetBurnRate | SloBurnRate | Ошибка оценки скорости сжигания бюджета для целевого уровня обслуживания (SLO). |
evaluatedPercentage | number | Расчетное значение SLO. Имеет значение оцениваемого SLO или значение -1 :
|
burnRateMetricKey | string | Ключ скорости сжигания бюджета ошибок для выражения метрики. |
errorBudgetMetricKey | string | Ключ бюджета ошибок для выражения метрики. |
normalizedErrorBudgetMetricKey | string | Ключ нормализованного бюджета ошибок для выражения метрики. |
number | УСТАРЕЛО
Значение числителя, используемое для оценки SLO, когда для параметра useRateMetric установлено значение | |
number | УСТАРЕЛО
Значение знаменателя, используемое для оценки SLO, когда для параметра useRateMetric установлено значение | |
relatedOpenProblems | integer | Количество ОТКРЫТЫХ проблем, связанных с SLO.
Имеет значение, |
relatedTotalProblems | integer | Общее количество проблем, связанных с SLO.
Имеет значение, |
hasAccess | boolean | SLO доступен через настройки, если hasAccess имеет значение true .
|
errorBudget | number | Бюджет ошибки рассчитанного SLO.
Бюджет ошибок — это разница между расчетным и целевым значениями. Положительное число означает, что все хорошо; отрицательное число означает проблемы. |
metricKey | string | Ключ для метрического выражения. После создания метрические ключи нельзя изменить. |
timeframe | string | Сроки оценки SLO. Используйте синтаксис глобального селектора таймфреймов. |
filter | string | Фильтр объектов для оценки SLO. Используйте синтаксис селектора объектов . |
description | string | Краткое описание SLO. |
enabled | boolean | SLO включен ( true ) или отключен ( false ).
|
status | string | Статус рассчитанного SLO.
Элемент может содержать эти значения
|
error | string | Ошибка расчета SLO.
Если значение отличается от |
warning | number | Предупреждающее значение SLO.
В состоянии предупреждения SLO все еще выполняется, но приближается к отказу. |
name | string | Название SLO. |
id | string | Идентификатор SLO |
target | number | Целевое значение SLO. |
Объект SloBurnRate
Ошибка оценки скорости сжигания бюджета для целевого уровня обслуживания (SLO).
Элемент | Тип | Описание |
---|---|---|
burnRateVisualizationEnabled | boolean | Визуализация скорости сжигания бюджета ошибок включена ( true ) или отключена ( false ).
В случае |
fastBurnThreshold | number | Порог между медленной и быстрой скоростью горения. |
sloValue | number | Расчетное значение SLO для таймфрейма, выбранного для расчета скорости выгорания. |
estimatedTimeToConsumeErrorBudget | number | Расчетное время, оставшееся для использования бюджета ошибок в часах. |
burnRateType | string | Расчетный тип скорости горения.
Имеет значение «БЫСТРО», «МЕДЛЕННО» или «НЕТ». Элемент может содержать эти значения
|
burnRateValue | number | Скорость записи SLO, рассчитанная за последний час. |
JSON-модель тела ответа
{
"problemFilters": "[type(\"SERVICE\")]",
"metricExpression": "(100)*(builtin:service.errors.server.successCount:splitBy())/(builtin:service.requestCount.server:splitBy())",
"useRateMetric": true,
"metricRate": "builtin:service.successes.server.rate",
"metricNumerator": "builtin:service.errors.server.successCount",
"metricDenominator": "builtin:service.requestCount.server",
"evaluationType": "AGGREGATE",
"errorBudgetBurnRate": {
"burnRateVisualizationEnabled": true,
"fastBurnThreshold": 1.5,
"sloValue": 95,
"estimatedTimeToConsumeErrorBudget": 24,
"burnRateType": "SLOW",
"burnRateValue": 1.25
},
"evaluatedPercentage": 96.25,
"burnRateMetricKey": "func:slo.errorBudgetBurnRate.payment_service_availability",
"errorBudgetMetricKey": "func:slo.errorBudget.payment_service_availability",
"normalizedErrorBudgetMetricKey": "func:slo.normalizedErrorBudget.payment_service_availability",
"numeratorValue": 80,
"denominatorValue": 90,
"relatedOpenProblems": 1,
"relatedTotalProblems": 1,
"hasAccess": true,
"errorBudget": 1.25,
"metricKey": "func:slo.payment_service_availability",
"timeframe": "-1d",
"filter": "type(\"SERVICE\")",
"description": "Rate of successful payments per week",
"enabled": true,
"status": "WARNING",
"error": "NONE",
"warning": 97.5,
"name": "Payment service availability",
"id": "123e4567-e89b-42d3-a456-556642440000",
"target": 95
}