CorefinityCorefinityDocs
Open the Control PanelControl Panel
Logs · 24 of 25

List a site's log sources

Answers the log sources of the environment, whether each one is collected, the limits of a read, the logs quota and the time ranges on offer.

GET/api/corestack/sites/{site}/logs/streams

Path parameters

siteintegerRequired

The id of a site row. A website's production site and each of its environments has its own id. Digits only. At least 1.

Query parameters

environment_idinteger

The site row id of another environment of the same website to read instead of {site}. At least 1.

scopestring

env reads the one environment. site reads every environment of the website that you can see. Defaults to env.

envsite

Returns

200 The sources, limits, quota and ranges.

Fields of the 200 answer
limitsobjectRequired
Fields
max_limitintegerRequired

The most lines a page.

max_query_bytesintegerRequired
max_range_daysintegerRequired

How far back a read may start, in days.

queries_per_minuteintegerRequired

The reads a minute one person may make, across the Control Panel, the API and MCP.

timeout_secondsintegerRequired
rangesarray of stringsRequired

The ranges a read may use.

15m1h6h24h7d30d
sourcesarray of objectsRequired
Fields of each item
availablebooleanRequired
keystringRequired

A log source. all reads every source. search and queue exist only on platforms that run them; the sources list says which ones an environment has. Defaults to all.

allweb-accessweb-errorphpappcrondatabasecachesearchqueue
labelstringRequired
reasonstring or nullRequired

Why the source is not available: not_collected (the environment does not run it), or contract_v3 or tenant_pending (it starts once the environment's next platform update has applied). Null when available.

not_collectedcontract_v3tenant_pendingnull
tenantobjectRequired

The logs quota the lines count against.

Fields
percentintegerRequired

How much of the quota is used.

quota_gbintegerRequired
retention_daysintegerRequired

How many days lines are kept for.

statestringRequired

ok, warning when the quota is nearly used, over_quota, or unavailable.

okwarningover_quotaunavailable
stored_gbnumberRequired
unpack_jsonbooleanRequired

True when a line written as JSON is answered with its keys as fields.

If it is refused

StatusReasonWhat to do
401noneSend a valid token as Authorization: Bearer <token>.
403company_unavailableYour company is unavailable.
403scope_requiredUse a token with the scope named in scope.
403two_factor_requiredTurn on two-factor on your account, then send again.
404feature_offThis feature is not on for your organisation yet.
409logs_not_collectedLogs are not being collected for the environment yet. Try again later, or contact support.
422invalidFix the field named in field; errors says why.
429rate_limitedWait for the seconds in Retry-After.
503logs_busyLogs are busy at the moment. Try again in a few seconds.
503logs_cluster_unavailableLogs are not available at the moment. Try again shortly.

Reasons are listed by name in Errors and refusals.

The same task elsewhere

curl https://manage.corefinity.com/api/corestack/sites/1042/logs/streams \
  -H "Authorization: Bearer $COREFINITY_TOKEN" \
  -H "Accept: application/json"
{
  "limits": {
    "max_limit": 1000,
    "max_query_bytes": 4096,
    "max_range_days": 90,
    "queries_per_minute": 150,
    "timeout_seconds": 15
  },
  "ranges": [
    "15m",
    "1h",
    "6h",
    "24h",
    "7d",
    "30d"
  ],
  "sources": [
    {
      "available": true,
      "key": "all",
      "label": "All",
      "reason": null
    },
    {
      "available": true,
      "key": "web-access",
      "label": "Web access",
      "reason": null
    },
    {
      "available": true,
      "key": "web-error",
      "label": "Web errors",
      "reason": null
    },
    {
      "available": true,
      "key": "php",
      "label": "PHP",
      "reason": null
    },
    {
      "available": true,
      "key": "app",
      "label": "Application",
      "reason": null
    },
    {
      "available": true,
      "key": "cron",
      "label": "Cron",
      "reason": null
    },
    {
      "available": true,
      "key": "database",
      "label": "Database",
      "reason": null
    },
    {
      "available": true,
      "key": "cache",
      "label": "Cache",
      "reason": null
    },
    {
      "available": false,
      "key": "search",
      "label": "Search",
      "reason": "not_collected"
    },
    {
      "available": false,
      "key": "queue",
      "label": "Queue",
      "reason": "not_collected"
    }
  ],
  "tenant": {
    "percent": 42,
    "quota_gb": 20,
    "retention_days": 90,
    "state": "ok",
    "stored_gb": 8.4
  },
  "unpack_json": true
}
Try it
Held in this tab's memory only. Never stored or sent to us.

Use a token with only the read scope. How to make one

Was this helpful?
Open in ClaudeOpen in ChatGPT