Type to search.

Cluster read-only block

ECH

Elastic Cloud Hosted lets you manage and configure one or more deployments of the versioned Elastic Stack, hosted on Elastic Cloud.

Availability

  • Generally available

    This functionality is generally available and ready for production usage.

ECK

Elastic Cloud on Kubernetes extends Kubernetes orchestration capabilities to allow you to deploy and manage components of the Elastic Stack.

Availability

  • Generally available

    This functionality is generally available and ready for production usage.

This documentation corresponds to the latest patch available for each minor version. If you're not using the latest patch, check the release notes for changes.

ECE

Elastic Cloud Enterprise is a self-managed orchestration platform for deploying and managing the Elastic Stack at scale.

Availability

  • Generally available

    This functionality is generally available and ready for production usage.

This documentation corresponds to the latest patch available for each minor version. If you're not using the latest patch, check the release notes for changes.

Self-managed

Self-managed deployments are Elastic Stack deployments managed without the assistance of an orchestrator.

Availability

  • Generally available

    This functionality is generally available and ready for production usage.

This documentation corresponds to the latest patch available for each minor version. If you're not using the latest patch, check the release notes for changes.

A cluster-wide read-only block is enabled. Indexing and other write operations are rejected until the block is cleared.

Note

For a complete list of insights, refer to AutoOps insights.

Field Value
Component Elasticsearch
Severity High
Scope Cluster
Domains cluster-health

The following is an example of what you might see when this insight is triggered. Real insights use live data and links from your deployment or cluster.

cluster.blocks.read_only is true. The cluster accepts only read operations, but indexing and updates are blocked.

Note

AutoOps shows different recommendations depending on how their conditions match your deployment or cluster.

Clear cluster read-only block

Condition: Shown when enough disk space.

Clear the cluster read-only block so indexing can resume. Use the action below, or set cluster.blocks.read_only to null in cluster settings.

JSON
PUT _cluster/settings
{
  "transient": {
    "cluster.blocks.read_only": null
  },
  "persistent": {
    "cluster.blocks.read_only": null
  }
}
Note

Requires the manage cluster privilege. Requires Elasticsearch 8.0.0 or later. This action changes cluster or index configuration.

Free disk before clearing read-only block

Condition: Shown when not enough disk space.

Disk space is critically low. Increase disk space or delete old indices before you clear the read-only block. Deleting indices is permanent; confirm backups first.

When cluster.blocks.read_only is true, Elasticsearch rejects write traffic cluster-wide. Searches and other reads can continue, but new and updated documents cannot be stored.

Operators often enable this block during maintenance so the cluster stays searchable without accepting writes. If the block is left on after maintenance, ingest pipelines fail and applications cannot index.

Clear the block when the work that required it is finished, and only after you confirm the cluster has enough disk and capacity to accept writes again.