slo-implementation

Visão Geral

O que é o slo-implementation?

o slo-implementation é uma skill prática para definir e implementar Indicadores de Nível de Serviço (SLIs), Objetivos de Nível de Serviço (SLOs) e orçamentos de erro. Ele oferece uma abordagem estruturada para medir e gerenciar a confiabilidade do serviço, facilitando o equilíbrio entre estabilidade operacional e velocidade de desenvolvimento.

Para Quem é Esta Skill?

Esta skill é destinada a equipes de Engenharia de Confiabilidade de Site (SRE), engenheiros DevOps e qualquer pessoa responsável por manter a qualidade e disponibilidade do serviço. É especialmente útil quando você precisa:

• Estabelecer metas claras de confiabilidade
• Medir o desempenho do serviço do ponto de vista do usuário
• Implementar orçamentos de erro para orientar decisões de lançamento
• Configurar alertas e monitoramento baseados em SLOs

Problemas que Resolve

• Fornece um framework claro para definir e acompanhar SLIs e SLOs
• Ajuda equipes a estabelecer metas realistas de confiabilidade e medir o progresso
• Suporta políticas de orçamento de erro para equilibrar inovação e confiabilidade
• Permite alertas e respostas a incidentes baseadas em dados

Como Usar

Passos para Instalação

1. Adicione a skill ao seu projeto:

   npx skills add https://github.com/wshobson/agents --skill slo-implementation
   

2. Revise a documentação principal:

   • Comece pelo SKILL.md para uma visão geral e fluxo de trabalho.
   • Explore arquivos complementares como README.md, AGENTS.md, metadata.json e quaisquer diretórios rules/, resources/ ou references/ para contexto detalhado e exemplos.

3. Adapte ao seu ambiente:

   • Use os templates de SLI e SLO fornecidos como ponto de partida, mas personalize-os para a arquitetura do seu serviço, ferramentas de monitoramento e requisitos de negócio.
   • Consulte os exemplos de consultas Prometheus para SLIs de disponibilidade, latência e durabilidade, ou crie os seus próprios baseados na sua pilha de métricas.

Conceitos-Chave e Fluxo de Trabalho

• Hierarquia SLI/SLO/SLA:
  • SLA: Contrato externo com clientes
  • SLO: Meta interna de confiabilidade
  • SLI: Medição real do desempenho do serviço
• Definindo SLIs:
  • Tipos comuns incluem disponibilidade, latência e durabilidade
  • Exemplos de consultas Prometheus são fornecidos para cada um
• Estabelecendo SLOs e Orçamentos de Erro:
  • Use as tabelas e referências incluídas para definir metas significativas
  • Acompanhe os orçamentos de erro para orientar decisões de lançamento e rollback

Quando Usar o slo-implementation

• Ao lançar novos serviços ou APIs
• Para melhorar a confiabilidade de sistemas existentes
• Implementando práticas de SRE na sua organização
• Configurando monitoramento e alertas baseados no impacto real ao usuário

Perguntas Frequentes

O que o slo-implementation realmente faz?

Ele oferece um framework e templates práticos para definir, acompanhar e aplicar SLIs, SLOs e orçamentos de erro. Isso ajuda as equipes a medir a confiabilidade do serviço e responder proativamente a incidentes.

Como começo a usar o slo-implementation?

Instale a skill usando o comando npx fornecido, depois revise o SKILL.md e arquivos relacionados para entender o fluxo de trabalho recomendado. Adapte os templates e consultas para sua própria pilha de monitoramento e metas de confiabilidade.

Posso usar o slo-implementation com minhas ferramentas de monitoramento atuais?

Sim. A skill fornece exemplos de consultas Prometheus, mas você pode adaptar a abordagem para qualquer sistema de métricas ou monitoramento que suporte medições similares.

O slo-implementation é só para equipes de SRE?

Embora tenha sido projetado com as melhores práticas de SRE em mente, qualquer equipe de engenharia que queira melhorar a confiabilidade e o desempenho do serviço pode se beneficiar do uso desta skill.

Onde encontro mais exemplos ou referências?

Confira o diretório references/ na árvore de arquivos da skill para definições adicionais de SLOs e guias de implementação. Use a aba Arquivos para navegar por todos os recursos e scripts disponíveis.