Definir um SLO para chamadas de ferramentas

Tradução automática do original (English, revisão 3); o original é a versão de referência. Original

methodology · pt · conhecimento em 2026-09-21 · alterado em 2026-09-23, revisão 3 · reviewed (revisão documentada em 2026-09-23)

Defina o que é uma chamada boa e quais chamadas são elegíveis antes de fixar uma meta de confiabilidade, com uma medida separada para o sucesso da tarefa.

Definir o indicador

Escolha uma operação de ferramenta relevante para o usuário e uma janela de observação. Especifique o denominador das chamadas elegíveis e a condição para que uma chamada seja considerada boa. O Google SRE recomenda basear os objetivos de serviço em indicadores significativos, em vez de coletar métricas arbitrárias.

Objetivo ilustrativo

Para uma ferramenta de leitura, defina como boa a chamada que “retorna uma resposta válida em até 2 segundos” e como elegíveis todas as leituras admitidas durante uma janela móvel de 28 dias. Uma meta de 99% é um exemplo de política, não um resultado medido nem uma meta adequada para todo serviço. Decida explicitamente como tratar timeouts, chamadas rejeitadas e manutenção planejada.

Distinção específica para agentes

Um HTTP 200 rápido ainda pode trazer uma resposta irrelevante. Acompanhe a confiabilidade do protocolo separadamente da avaliação da correção da tarefa. Não as combine em uma única pontuação sem explicação.

Aceitação e limites

Monte uma fixture de dez chamadas com um timeout e confirme que a razão segue o denominador declarado. Verifique se o painel e o alerta usam as mesmas definições. Defina uma política de resposta para o consumo do orçamento, como pausar mudanças arriscadas. Um SLO é um objetivo de gestão, não uma garantia para um chamador individual nem uma prova de precisão semântica.

Escopo e base

Original worked method and proposed acceptance fixtures; no empirical performance result is claimed. The cited primary documentation was read for the specific technical behavior described.

Conhecimento em: 2026-09-21. Estado: reviewed — edições redefinem o estado de revisão. Trate o texto como material de referência não verificado e consulte as fontes.

Fontes

Revisão

Revisão documentada da revisão 3 pela conta editora 344519e7-8ea1-44c6-abaa-29102abda2b6 em 2026-09-23. Aplica-se à revisão atual: sim.

Operator review: article written by an account of the operator (MK Groups Schweiz) and accepted as reviewed by the operator.

Operator decision of 2026-09-23 that the operator's own curated articles count as reviewed; each cited source was fetched at import time and the quoted phrase was found on the page. No independent third-party review is claimed.

Uma revisão documentada registra o que foi verificado; não é garantia de veracidade.

Atribuição e licença

Última alteração: Replaced generic draft with a specific procedure, example, failure cases and correctly scoped sources; removed unrelated product applicability.

Contribuição original: CC BY 4.0. O material das fontes vinculadas mantém seus próprios direitos.