CloudCastle Grafana Loki API

ResponseParser
in package

FinalYes

Разбор JSON-ответов Query API в типизированные объекты.

Валидирует конверт ответа (status/data) и делегирует гидрацию секции result ResultHydrator; любое отклонение от формата Loki превращается в QueryException с понятным сообщением, а не в TypeError глубоко в коде.

Table of Contents

Methods

__construct()  : mixed
decode()  : array<string|int, mixed>
Разбирает произвольный JSON-ответ в массив.
decodeChecked()  : array<string|int, mixed>
Разбирает JSON-ответ, отвергая явный статус ошибки в конверте.
parseQueryResponse()  : QueryResult
Разбирает тело ответа query/query_range.
parseSeries()  : array<int, array<string, string>>
Разбирает ответ series: список карт меток.
parseStringList()  : array<int, string>
Разбирает ответ со списком строк (labels, label values).

Methods

decode()

Разбирает произвольный JSON-ответ в массив.

public decode(string $body) : array<string|int, mixed>
Parameters
$body : string

JSON-ответ сервера

Tags
throws
QueryException

при некорректном JSON

Return values
array<string|int, mixed> —

разобранный ответ

decodeChecked()

Разбирает JSON-ответ, отвергая явный статус ошибки в конверте.

public decodeChecked(string $body) : array<string|int, mixed>

В отличие от extractData не требует конверта status/data: служебные эндпоинты (index/stats, detected_labels, detected_fields) отдают полезную нагрузку без конверта. Но если конверт всё же присутствует и его статус не «success» (Loki изредка отвечает так с кодом 200), это ошибка, а не данные, — превращаем её в исключение вместо тихого возврата тела ошибки вызывающему коду.

Parameters
$body : string

JSON-ответ сервера

Tags
throws
QueryException

при некорректном JSON или статусе ошибки

Return values
array<string|int, mixed> —

разобранный ответ

parseQueryResponse()

Разбирает тело ответа query/query_range.

public parseQueryResponse(string $body) : QueryResult
Parameters
$body : string

JSON-ответ сервера

Tags
throws
QueryException

при некорректной структуре

Return values
QueryResult

parseSeries()

Разбирает ответ series: список карт меток.

public parseSeries(string $body) : array<int, array<string, string>>
Parameters
$body : string

JSON-ответ сервера

Tags
throws
QueryException

при некорректной структуре

Return values
array<int, array<string, string>> —

наборы меток

parseStringList()

Разбирает ответ со списком строк (labels, label values).

public parseStringList(string $body) : array<int, string>
Parameters
$body : string

JSON-ответ сервера

Tags
throws
QueryException

при некорректной структуре

Return values
array<int, string> —

значения

On this page

Search results