> For the complete documentation index, see [llms.txt](https://mariadb.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://mariadb.com/docs/gridgain/gridgain-8/tuning-and-troubleshooting.md).

# Tuning and Troubleshooting

Guidance for tuning a GridGain 8 cluster and troubleshooting it, including performance tuning, capacity planning, and debugging.

This section covers the practices that keep a GridGain cluster fast and available: performance and tuning techniques, capacity and disk-space planning, monitoring and maintenance operations, and troubleshooting common issues.

{% hint style="info" %}
GridGain also supports cross-datacenter replication for disaster recovery and geographic high availability — see [Data Center Replication](/docs/gridgain/gridgain-8/gridgain8-management/backup-and-replication/data-center-replication.md).
{% endhint %}

{% columns %}
{% column %}
{% content-ref url="/pages/5ce6Iv2Xrqyht3AxcZYk" %}
[Performance Tuning](/docs/gridgain/gridgain-8/tuning-and-troubleshooting/performance-tuning.md)
{% endcontent-ref %}
{% endcolumn %}

{% column %}
Tuning GridGain 8 for throughput and latency: general practices, memory and JVM, persistence, SQL, memory quotas, and thread pools.
{% endcolumn %}
{% endcolumns %}

{% columns %}
{% column %}
{% content-ref url="/pages/2rR1KZaYOwkx2wztvqRI" %}
[Handling Large Objects](/docs/gridgain/gridgain-8/tuning-and-troubleshooting/handling-large-objects.md)
{% endcontent-ref %}
{% endcolumn %}

{% column %}
Considerations for storing and processing large objects in GridGain, including multipage objects, concurrency, field counts, and schemas.
{% endcolumn %}
{% endcolumns %}

{% columns %}
{% column %}
{% content-ref url="/pages/fonB9wdmtekfxfOmJer5" %}
[Troubleshooting and Debugging](/docs/gridgain/gridgain-8/tuning-and-troubleshooting/troubleshooting.md)
{% endcontent-ref %}
{% endcolumn %}

{% column %}
Common tips and techniques for debugging and troubleshooting GridGain and Ignite deployments, including persistence, thin clients, GC issues, and node recovery.
{% endcolumn %}
{% endcolumns %}

{% columns %}
{% column %}
{% content-ref url="/pages/gWmvkUHHrOybwW6XiCaM" %}
[Critical Failures Handling](/docs/gridgain/gridgain-8/tuning-and-troubleshooting/critical-failures-handling.md)
{% endcontent-ref %}
{% endcolumn %}

{% column %}
How GridGain detects critical failures, configures the failure handler, and runs health checks on critical system workers.
{% endcolumn %}
{% endcolumns %}

{% columns %}
{% column %}
{% content-ref url="/pages/RhNaL2cThsmWapcPY2OZ" %}
[Monitoring Rebalance Progress](/docs/gridgain/gridgain-8/tuning-and-troubleshooting/monitoring-rebalance.md)
{% endcontent-ref %}
{% endcolumn %}

{% column %}
Methods for tracking GridGain data rebalance progress and status using the control script, cache-group metrics, cache-level metrics, and log patterns.
{% endcolumn %}
{% endcolumns %}

{% columns %}
{% column %}
{% content-ref url="/pages/iz4bJYLz5cGLFuT97Tcx" %}
[Capacity Planning](/docs/gridgain/gridgain-8/tuning-and-troubleshooting/capacity-planning.md)
{% endcontent-ref %}
{% endcolumn %}

{% column %}
Techniques for planning and identifying the minimum hardware requirements for a GridGain deployment, covering memory, heap, compute, and disk usage.
{% endcolumn %}
{% endcolumns %}

{% columns %}
{% column %}
{% content-ref url="/pages/UniWcsMQoO3fTnYdU6Ts" %}
[Empirical Estimation of Disk Capacity Usage](/docs/gridgain/gridgain-8/tuning-and-troubleshooting/disk-capacity-estimation.md)
{% endcontent-ref %}
{% endcolumn %}

{% column %}
An empirical approach to estimating how much disk space your data will require when loaded into GridGain's internal binary format.
{% endcolumn %}
{% endcolumns %}