the client's query transport.
client configuration (query URL and credentials).
clock (tests).
The configured collections ([sourceTable], or []); Better Stack has no listing API here.
Runs SQL and returns the rows. Without a FORMAT clause, FORMAT JSONEachRow is appended;
FORMAT JSON/JSONEachRow (also with output_format_json_array_of_rows) are parsed, other
formats throw ValidationError (use queryRaw). A ClickHouse exception appended to a
200 response is raised as the mapped error.
Runs SQL and returns the response text unchanged. params are bound server side
({name:Type} placeholders + param_<name> URL parameters).
Renders the searchLogs SQL: one runnable statement with escaped SQL literals (DECISIONS 13); only query binds parameters server side.
LogQueryClient.search: query is the contains text, searched in the configured
sourceTable.
Searches hot and cold logs of a collection (remote(<source>_logs) UNION ALL
s3Cluster(primary, <source>_s3)), inclusive time window, literal substring match, newest
first by default. Rows are normalized (logRecordFromRow) and deduplicated on
(dt, raw); nextCursor is set when more rows exist.
Optionalopts: TailOptionsOptionalopts: WaitForLogOptions
SQL query client for Better Stack Logs (ClickHouse HTTP interface with the connection's own Basic credentials). Implements LogQueryClient:
searchruns searchLogs on the configuredsourceTable,tailpollssearch,listStreamsreturns the configured collection andlistLabelsis unsupported (Better Stack has no labels).