Получает параметр указанной цели уровня обслуживания (SLO).
Если указаны параметры from и to , SLO рассчитывается для этого таймфрейма; в противном случае используется собственный таймфрейм SLO.
Запрос создает в качестве полезной нагрузки application/json формат.
| GET | АппОптима | https://{your-domain}/e/{your-environment-id}/api/v2/slo/{id}
|
| Cреда АктивногоШлюза | 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
}