10. Observabilidade em serverless

Este capítulo nasce das 30 questões publicadas sobre Observabilidade em serverless. A leitura do acervo revelou 30 núcleos de conhecimento, aqui reorganizados como uma explicação progressiva: primeiro o vocabulário e o modelo mental, depois os mecanismos, as decisões de implementação, os limites e a forma de verificar o comportamento do sistema.

A apostila termina aplicando os fundamentos a arquiteturas baseadas em eventos e serviços gerenciados. Funções, estado externo, escala, observabilidade, segurança, custo e dependência do provedor formam uma única decisão arquitetural. Este é o capítulo 10 de 20 da disciplina Computação Serverless. Ele retoma Orquestração de workflows serverless e utiliza essa base para avançar. Na sequência, estudaremos Segurança em arquiteturas serverless.

O fio condutor

O desenvolvimento de software começa com um problema e avança por decisões que precisam permanecer compreensíveis e verificáveis. Requisitos orientam modelos; modelos orientam código e arquitetura; testes verificam comportamento; e a operação devolve informações para o próximo ciclo. Uma falha importante no início tende a se espalhar pelas etapas seguintes.

Neste capítulo, use Observabilidade em serverless para acompanhar quatro perguntas: qual problema precisa ser resolvido, como o mecanismo funciona, que consequências a escolha produz e como o resultado será verificado. Essa sequência transforma termos técnicos em decisões que podem ser explicadas e testadas.

Parte 1 — Fundamentos e vocabulário

Começamos por Parte 1 — Fundamentos e vocabulário, pois essa base organiza os conceitos e exemplos que aparecerão no restante do capítulo.

Um log estruturado expõe atributos como chaves consultáveis, em vez de obrigar a

O ponto de partida é estabelecer o significado do conceito e o problema que ele procura organizar. Um log estruturado expõe atributos como chaves consultáveis, em vez de obrigar a plataforma a extrair informação de frases livres. Isso permite localizar todas as etapas de um pedido por correlationId e calcular contagens por tipo de erro com consultas consistentes. A estrutura, porém, não dispensa convenções de nomes nem o cuidado de omitir segredos e dados pessoais. A regra ganha sentido quando suas consequências orientam a implementação.

Para aplicar Um log estruturado expõe atributos como chaves consultáveis, em vez de obrigar a, acompanhe a execução desde a entrada até a saída e anote pré-condições, mudança de estado, custo e falhas possíveis. Assim o conceito deixa de ser um rótulo e passa a orientar decisões.

Use como teste da compreensão: Logs estruturados, por exemplo em JSON, facilitam a filtragem e a agregação por campos como nível, serviço e identificador de correlação, em comparação com mensagens de texto sem formato estável. Depois verifique a afirmação com execução controlada, teste automatizado, análise do contrato, medição ou documentação da versão correspondente. A evidência deve reproduzir a propriedade afirmada, inclusive nos casos de erro e de fronteira.

Invocations conta as vezes em que o código da função começou a executar,

A partir dessa distinção, o próximo elemento completa o fluxo. Invocations conta as vezes em que o código da função começou a executar, independentemente de o resultado posterior ser sucesso ou erro. Errors é outra métrica e representa invocações que terminaram com erro da função, não um conjunto totalmente separado de chamadas. Assim, uma mesma execução malsucedida contribui para Invocations e para Errors. Observe como definição, mecanismo e efeito permanecem ligados.