corestack_ logs_ query
Query logs.
When to use it
Search a site's logs with LogsQL over a time window: the matching lines newest first with a cursor for the next page, or one table per log account for a query ending in stats, uniq or top.
Ask for it
Using the Corefinity MCP server, call corestack_logs_query with site_id 4211. (Query logs.) Tell me what it returned.Inputs
next_cursor from the previous page. Up to 65,536 characters.
A row of the same site: production or one of its environments. Omitted: the row site_id names. At least 1.
Fields whose top ten values to add (a records page only). Up to 20 items.
The filter builder's entries (level, text, fields), ANDed with the query.
ISO 8601; with to, instead of range. Format: date-time.
Defaults to 200. 1 to 1000.
LogsQL, sent as written (* when empty). Up to 4,096 characters.
Back from now, inside the site's retention.
15m1h6h24h7d30dEnv (the default): that one row; site: every environment of the site you may see. Defaults to env.
envsiteThe site (any of its environments answers for its group). At least 1.
One log source (corestack_logs_streams_list says which this row has). Defaults to all.
allweb-accessweb-errorphpappcrondatabasecachesearchqueueISO 8601; defaults to now. Format: date-time.
Example call
{
"name": "corestack_logs_query",
"arguments": {
"site_id": 4211
}
}If it is refused
| Reason | What to do |
|---|---|
invalid_arguments | The arguments do not match the tool's input schema, or the Control Panel refused a field. Fix the fields named in the answer and call again. |
tenant_mismatch | The object does not exist or the token may not see it. Check the id. |
scope_required | The token lacks a scope this call needs. Open the link in the answer to add it, then call again. |
pin_refused | The grant is limited to chosen clusters, sites or environments, and this call is outside them. Open the link in the answer to widen it. |
rate_limited | Too many calls. Wait for the number of seconds the answer names. |
temporarily_unavailable | The Control Panel could not answer just now. Nothing was started; try again shortly. |
internal_error | Something went wrong on our side. Quote the trace id to support. |
The answer
- The answer's
kindisrecords(the lines newest first,next_cursorfor the next page — send it back with the samelimitandwindow) ortable(one table per log account for a query ending in an aggregating pipe; no cursor). - Its
window{from, to}holds the absolute instants the page was read over, arangeresolved back from now. Send these asfrom/toto read the same window again (later pages, the histogram) instead of arangethat moves with the clock. - A large page comes as a link. A page larger than an answer carries inline (256 KB by default) answers its
metadata —
kind,window,next_cursor,effective_query,tenant— withlinked {uri,and abytes, rows, expires_ at, message} resource_linktocorestack://logs/pages/{ref}. Read that URI withresources/readbefore it expires (an hour by default): it answers the whole page as this tool's JSON, under the same token. Or call again with a smallerlimit. The link works only for the token and person it was issued to.