---
title: "Cluster logs"
url: https://docs.corefinity.com/guides/corecluster/cluster-logs
type: guide
last_updated: 2026-11-13
feature: cluster-logs
---
# Cluster logs

Read the logs of every site in a CoreCluster in one place, and check how much log storage they use.

## Before you start

- Your organisation has a CoreCluster. Anyone in the organisation can read its sites' logs.

## Read a cluster's logs

1. **Open Logs**

   Go to **Managed Clusters**, choose the cluster, then **Logs**. Each line names the site it came from.

   _Screenshot: A CoreCluster's page with Logs chosen in the section menu. Above the lines are the sources, the time ranges, the Sites button, Production and All environments, and a chart of lines over time. Each line shows its time, its source, the site and environment it came from, and the message._

2. **Choose the sites**

   Choose **Sites**, tick the sites to read, then choose **Apply**. **All sites** ticks every site, and **Find a site** narrows a long list.

   _Screenshot: The Sites button ringed, with its list open: All sites at the top, then each site of the cluster with a tick box and its environment, two of them ticked, and Clear and Apply at the bottom._

3. **Choose the environments**

   Choose **Production** for the production environments only, or **All environments**.

   _Screenshot: All environments ringed beside Production, with the Cron source chosen. The lines are scheduled-task output from several sites, some marked Production and some Staging._

The lines of the chosen sites are listed together. Sources, time ranges, search, the live view and downloads work as on one site: see [Logs](/guides/sites/logs-and-monitoring/logs).

_Screenshot: The cluster's logs for the last six hours narrowed to the error level. The chart has one tall red bar, and the lines under it are a PHP fatal error, the web server's upstream timed out errors and the 504 requests, each naming its site._

## Check log storage

1. **Open the cluster's Overview**

   Go to **Managed Clusters** and choose the cluster. The **Logs** card shows how much log storage the cluster's sites use together and how long lines are kept.

   _Screenshot: A CoreCluster's Overview: the capacity bars above the cards Site health, Logs with the storage used and how long lines are kept, and Recent activity._

   _Screenshot: The Logs card on a cluster's Overview: the log storage used out of the cluster's allowance with a bar, the number of sites it covers and how long lines are kept, and the link See the logs._

To add log storage, choose **Add capacity…** in the cluster's **Package** section: see [Package, capacity and server type](/guides/corecluster/package-capacity-and-server-type).

## Automate this

**API:** [Search a CoreCluster's logs](https://docs.corefinity.com/api/reference/logs/query-cluster-logs.md), scope `read`

```bash
curl -X POST https://manage.corefinity.com/api/corestack/clusters/1017/logs/query \
  -H "Authorization: Bearer $COREFINITY_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "environment": "all",
    "range": "1h"
  }'
```

**MCP:** [`corecluster_logs_query`](https://docs.corefinity.com/mcp/tools/corecluster_logs_query.md), scope `read`

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

**Control Panel:** Managed Websites › your site › Logs & monitoring › Logs ([https://manage.corefinity.com/go/logs](https://manage.corefinity.com/go/logs))

## Related

- [Logs](/guides/sites/logs-and-monitoring/logs): Read and narrow a site's logs.
- [Saved queries and downloads](/guides/sites/logs-and-monitoring/saved-queries-and-exports): Save a search and download its lines.
- [Usage and activity](/guides/corecluster/usage-and-activity): See a cluster's usage and what changed.
