Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Nesta página, descrevemos algumas das configurações controladas pelo usuário que podem causar a exclusão de uma interrupção de uma instância do Spanner do contrato de nível de serviço (SLA) do Spanner, que exclui interrupções "causadas por fatores fora do controle razoável do Google". Ele também oferece diretrizes sobre como evitar essas configurações.
O Spanner gerencia muitos aspectos das operações de banco de dados, como divisão e rebalanceamento de dados, replicação, failover e todas as atualizações de hardware e software. É possível configurar muitos desses comportamentos com configurações integradas e APIs administrativas. Suas cargas de trabalho também dependem de outros componentes além do Spanner, como aplicativos e rede.
Essas configurações controladas pelo cliente podem aumentar o risco de inatividade da instância, dependendo da carga do banco de dados e de outros parâmetros de configuração.
Se a instância ficar inativa e o Google determinar que ela não está em conformidade com os limites operacionais descritos nesta página, qualquer período de inatividade resultante não será coberto (ou não será considerado) pelo SLA do Spanner.
Configurações excluídas do SLA do Spanner
As configurações a seguir são excluídas do SLA do Spanner:
Se a instância for configurada e usada de maneira que a carga de trabalho a sobrecarregue, ela não será coberta pelo SLA.
O tempo de inatividade das instâncias resultante de ações ou omissões voluntárias não é coberto pelo SLA.
Se você desativar a API Spanner
ou outras APIs Google Cloud necessárias para criar e se conectar ao
Spanner, ela não será coberta pelo SLA.
A indisponibilidade da API Spanner resultante da configuração de rede, como regras de proxy e firewall, não é coberta pelo SLA.
A indisponibilidade do aplicativo devido a clientes desatualizados ou mal configurados não é coberta pelo SLA. Em
particular, verifique se você está usando versões recentes do cliente com dependências
compatíveis. Por exemplo, os aplicativos Java precisam usar a BOM do Google (lista de materiais) com um gerenciador de pacotes, como Gradle ou Maven.
Recomendamos configurar alertas e monitoramento usando o
Cloud Monitoring.
Configurações a evitar
Para manter a cobertura do SLA do Spanner, evite as seguintes configurações:
Sobrecarga da CPU: se a utilização da CPU estiver consistentemente alta, a instância não estará dimensionada corretamente para a carga de trabalho e poderá não ser coberta pelo SLA. As recomendações de uso da CPU do Spanner fornecem sobrecarga para um evento de failover, em que os recursos de computação restantes ajudam a acomodar o tráfego de partes indisponíveis da instância. É possível usar as métricas de utilização da CPU do Spanner para monitorar o uso da CPU.
Armazenamento completo: o Spanner cobra apenas pelo armazenamento que você usa. No entanto, cada nó, ou unidade de computação, tem um limite para a quantidade de armazenamento que pode gerenciar. Se a instância não estiver dimensionada corretamente
para o armazenamento endereçável por nó, ela poderá não ser coberta
pelo SLA. É possível usar as métricas de utilização do armazenamento do Spanner para monitorar a utilização do armazenamento.
Limite de cota:os recursos de nó são limitados por cotas por usuário.
Não solicitar aumentos de cota com antecedência pode resultar em sobrecarga de recursos de computação, o que pode não ser coberto pelo SLA. As solicitações de aumento de cota que exigem aprovação do Google geralmente são atendidas em um dia.
Sessões com provisionamento insuficiente: os clientes do Spanner usam canais gRPC para se comunicar com endpoints Google Cloud para consultas e administração. Se os ambientes de cliente não fornecerem canais suficientes para atender ao volume de solicitações de uma carga de trabalho, os aplicativos poderão apresentar alta latência e baixa capacidade de processamento de solicitações, o que pode não ser coberto pelo SLA.
Sobrecarga de conexão:muitas APIs do Spanner podem ser retentadas com segurança em caso de falha temporária, como um deadlock de transação em uma consulta, um problema de rede ou limites de taxa para APIs administrativas. Novas tentativas muito
agressivas podem sobrecarregar as conexões atuais, causando esgotamento de recursos
ou limitação adicional. O aumento da latência ou a redução do
throughput podem não ser cobertos pelo SLA. Para mais informações, consulte
Como gerenciar tempos limite e novas tentativas do cliente.
Sobrecarga da unidade de disco rígido (HDD):o armazenamento em camadas permite armazenar dados do Spanner em uma combinação de unidades de estado sólido (SSD) e unidades de disco rígido (HDD). Se a carga de disco no armazenamento HDD atingir 100%, a latência da instância do Spanner vai aumentar significativamente e talvez não seja coberta pelo SLA. É possível usar as métricas de armazenamento em camadas do Spanner para monitorar a carga do disco.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-17 UTC."],[],[],null,["# Spanner operational guidelines\n\nThis page describes some of the user-controlled configurations that can cause an\noutage for a Spanner instance to be excluded from the\nSpanner Service Level Agreement (SLA), which excludes outages\n\"caused by factors outside of Google's reasonable control\". It also provides\nguidelines on how to avoid these configurations.\n\nSpanner manages many aspects of database operations, such as\nsplitting and rebalancing data, replication, failover, and all hardware and\nsoftware updates. You can configure many of these behaviors with built-in\nsettings and administrative APIs. Your workloads also depend on other components\nin addition to Spanner, such as your applications and network.\nThese customer-controlled configurations may increase the risk of instance\ndowntime, depending on your database load and other configuration parameters.\n\nIf your instance becomes unhealthy, and if Google determines that the instance\nis out of compliance with the operational limits described on this page, then\nany resulting downtime may not be covered by (or does not count against) the\nSpanner SLA.\n| **Note:** You're responsible for monitoring your Spanner instances and verifying that they are correctly sized and configured for the type of workloads that you're running.\n\nConfigurations excluded from the Spanner SLA\n--------------------------------------------\n\nThe following configurations are excluded from the Spanner SLA:\n\n- If your instance is configured and used in a way that causes the workload to overload the instance, then it isn't covered by the SLA.\n- Downtime of instances that results from your voluntary actions or inactions isn't covered by the SLA\n- If you disable the [Spanner API](/spanner/docs/getting-started/set-up#set_up_a_project) or other Google Cloud APIs that are required to create and connect to Spanner, then it isn't covered by the SLA.\n- Unavailability of the Spanner API that is the result of your network configuration, such as proxy and firewall rules, isn't covered by the SLA.\n- Application unavailability due to out-of-date or misconfigured [clients](/spanner/docs/reference/libraries) isn't covered by the SLA. In particular, verify that you are using recent client versions with supported dependencies. For example, Java applications should use [Google's BOM](/java/docs/bom) (bill of materials) with a package manager, such as Gradle or Maven.\n\nWe recommend that you set up alerts and monitoring using\n[Cloud Monitoring](/spanner/docs/monitoring-cloud).\n\n### Configurations to avoid\n\nTo maintain Spanner SLA coverage, you must avoid the following\nconfigurations:\n\n- **CPU overload** : If your CPU utilization is consistently high, then your instance isn't properly sized for your workload, and the instance might not be covered by the SLA. Spanner [CPU utilization recommendations](/spanner/docs/compute-capacity#change-compute-capacity) provide overhead for a failover event, where the remaining compute resources help to accommodate traffic from unavailable parts of the instance. You can use Spanner [CPU utilization metrics](/spanner/docs/cpu-utilization) to monitor CPU utilization.\n- **Full storage** : Spanner bills you only for the storage that you use. However, each node, or unit of compute, has a [limit](/spanner/quotas#database-limits) for the amount of storage it can manage. If your instance isn't properly sized for the addressable storage per node, then the instance might not be covered by the SLA. You can use Spanner [storage utilization metrics](/spanner/docs/storage-utilization) to monitor storage utilization.\n- **Quota limit:** Node resources are limited by per-user [quotas](/spanner/quotas). Failure to request quota increases in advance might result in compute resource overload, which might not be covered by the SLA. Quota increase requests that require approval from Google are typically fulfilled within one day.\n- **Under provisioned sessions** : Spanner clients use [gRPC channels](/spanner/docs/sessions#configure_the_number_of_sessions_and_grpc_channels_in_the_pools) to communicate with Google Cloud endpoints for queries and administration. If your client environments don't provide enough channels to support the request volume of a workload, your applications might experience high latency and low request throughput that might not be covered by the SLA.\n- **Connection overload:** Many Spanner APIs can be safely retried in the event of a transient failure, such as a transaction deadlock in a query, a network issue, or rate limits for administrative APIs. Overly aggressive retries might overwhelm existing connections, causing resource exhaustion or additional throttling. The increased latency or reduced throughput might not be covered by the SLA. For more information, see [managing client timeouts and retries](/spanner/docs/custom-timeout-and-retry).\n- **Hard disk drive (HDD) overload:** [Tiered storage](/spanner/docs/tiered-storage) lets you store your Spanner data on a mix of solid-state drives (SSD) and hard disk drives (HDD). If your disk load on HDD storage reaches 100%, your Spanner instance experiences significantly increased latency and might not be covered by the SLA. You can use Spanner [tiered storage metrics](/spanner/docs/monitoring-console#tiered_storage_charts_and_metrics) to monitor disk load.\n\nWhat's next\n-----------\n\n- Learn [best practices for improving Spanner performance and availability using the launch checklist](/spanner/docs/launch-checklist)."]]