CorefinityCorefinityDocs
Open the Control PanelControl Panel
Logs · 15 of 20

corecluster_logs_query

Query CoreCluster logs.

Scope readNo secrets returnedCoreCluster
On this page

When to use it

Search the logs of a CoreCluster's sites at once with LogsQL over a time window: the matching lines newest first, each naming its site, with a cursor for the next page; or one table per log account for a query ending in stats, uniq or top. Use it when a problem may come from another site on the same cluster; for one site, corestack_logs_query.

Ask for it

Prompt
Using the Corefinity MCP server, call corecluster_logs_query with cluster_id 812, sites [4211,4230], source web-error, range 1h. (Query CoreCluster logs.) Tell me what it returned.

Inputs

cluster_idintegerRequired

The CoreCluster. At least 1.

cursorstring

Next_cursor from the previous page. Up to 65,536 characters.

environmentstring

Production (the default): each site's production row; all: its environments too. Defaults to production.

productionall
facetsarray of strings

Fields whose top ten values to add (a records page only); a name that is not a field name is left out. Up to 20 items.

filtersobject

The filter builder's entries (level, text, fields), ANDed with the query.

fromstring

ISO 8601; with to, instead of range. Format: date-time.

limitinteger

Defaults to 200. 1 to 1000.

querystring

LogsQL, sent as written (* when empty). Up to 4,096 characters.

rangestring

Back from now, inside the cluster's retention.

15m1h6h24h7d30d
sitesarray of integers

The site ids (production rows) of this cluster to read, each once; omitted or empty: every site you may see on it. corestack_site_list with cluster_id names them. Up to 200 items.

sourcestring

One log source. Defaults to all.

allweb-accessweb-errorphpappcrondatabasecachesearchqueue
tostring

ISO 8601; defaults to now. Format: date-time.

Example call

tools/call
{
  "name": "corecluster_logs_query",
  "arguments": {
    "cluster_id": 812,
    "sites": [4211, 4230],
    "source": "web-error",
    "range": "1h"
  }
}

If it is refused

ReasonWhat to do
logs_not_collectedNone of the sites read has its logs collected on this cluster yet (or none is left after sites, environment and the token's pins); nothing to read.
logs_unavailableThis source's logs start once the sites' next platform update has applied.
query_too_wideThe read covers too many sites or too much text at once; name fewer sites, add a source or narrow the window.
logs_cluster_unavailableLogs cannot be read at the moment; try again shortly.
tenant_mismatchAlso answers a platform cluster, and a sites entry that is not one of this cluster's sites you may see.
invalid_argumentsWith fields.cursor: the cursor is not this call's — another token's or person's, another query's, or past its window. Run the query again.
scope_requiredThe token lacks a scope this call needs. Open the link in the answer to add it, then call again.
pin_refusedThe 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_limitedToo many calls. Wait for the number of seconds the answer names.
temporarily_unavailableThe Control Panel could not answer just now. Nothing was started; try again shortly.
internal_errorSomething went wrong on our side. Quote the trace id to support.
logs_busySee how this server works.

The answer

  • kind is records (the lines newest first, next_cursor for the next page — send it back with the same arguments and window) or table (one table per log account for a query ending in an aggregating pipe; no cursor).
  • Every line carries site {id, label, environment}. A query with any pipe is shown without site names (site is null throughout, and warnings says so): a pipe can drop or rewrite the field a line's site is read from.
  • tenant is the cluster's logs tenant (quota and retention), or null when the read spans several. window {from, to} holds the absolute instants read; send them as from / to to read the same window again.
  • A page cursor works only for this token and person, with the same query and window.
  • A large page comes as a link, as corestack_logs_query's: its metadata with linked {uri, …} and a resource_link to corestack://logs/pages/{ref}; read it with resources/read before it expires, under the same token.

A token limited to some sites

The read holds only the rows the token's pins cover — its lines, and an export's file. A sites entry outside the pins is pin_refused naming that site. Under a token limited to some environments of a site, leave sites out and send environment: "all": the read then covers exactly the rows the token may read.

The same task elsewhere

Was this helpful?
Open in ClaudeOpen in ChatGPT