Observabilidade de APIs

Definições e como implementar, com exemplos em Go

Transcript

1. Observabilidade de APIs
2. Elton Minetto ๏ Escrevo códigos, sou professor, palestrante, e escritor ๏ Escrevo no https://eltonminetto.dev e no x ๏ Principal Software Engineer @ PicPay
3. Monitoramento x observabilidade
4. Monitoramento de APIs
5. Permite que as equipes observem e entendam o estado de suas APIs ou até mesmo sistemas. É baseado na coleta de conjuntos predefinidos de métricas ou logs
7. Observabilidade de APIs
8. A observabilidade é baseada na exploração de propriedades e padrões não definidos com antecedência. Invoca um sentimento de transparência, é uma forma de monitoramento baseado em métricas expostas pelo sistema
10. MELT
11. ๏ Metrics - Medições numéricas coletadas e rastreadas ao longo do tempo. ๏ Events - Snapshots de mudanças de estado significativas. ๏ Logs - Uma transcrição detalhada do comportamento do sistema. ๏ Traces - uma rota de interações entre componentes, juntamente com um contexto associado.
12. Metrics ๏ Um status numérico em um momento (como % de CPU usada) ๏ Medições agregadas (como uma contagem de eventos em um minuto ou uma taxa de eventos por minuto)
13. For the minute of 3:34-3:35pm on 2/21/2019, there were three purchases totaling $2.75.
14. RED metrics ๏ R ate - O número de solicitações que o serviço está processando por segundo. ๏ E rror - O número de solicitações com falha por segundo. ๏ D uration - A quantidade de tempo que cada solicitação leva.
15. Events Um evento pode ser definido como uma ação discreta que acontece em um momento no tempo.
16. At 3:34pm on 2/21/2019, a bag of BBQ chips was purchased for $1.
17. Logs Linhas de texto que um sistema produz quando certos blocos de código são executados. Os desenvolvedores dependem muito deles para solucionar problemas de seu código e veri fi car e interrogar retroativamente a execução do código.
18. 2/21/2019 15:34:03: { actionType: purchaseCompleted, machineId: 2099, itemName: ‘Tasty BBQ Chips’, itemValue: 1.00 }
19. Traces Traces – ou mais precisamente, “traces distribuídos” – são amostras de cadeias causais de eventos (ou transações) entre diferentes componentes em um ecossistema de microsserviços.
20. Digamos que nossa máquina de venda automática aceite dinheiro e cartões de crédito. Se um usuário fizer uma compra com cartão de crédito, a transação deverá fluir pela máquina de venda automática por meio de uma conexão de back-end, entrar em contato com a administradora do cartão de crédito e, em seguida, entrar em contato com o banco emissor.
21. Show me the code
23. Stacks de Telemetria
25. Open Telemetry
27. Adicionando logs
30. Adicionando métricas
33. Adicionando traces
42. https://github.com/eminetto/api-o11y
43. Referências
44. ๏ What is the Di ff erence between API Observability and API Monitoring ๏ API Observability: A framework for managing your applications in an API world ๏ Intro to API Observability ๏ The RED method: A new strategy for monitoring microservices
45. ๏ Usando Prometheus para coletar métricas de aplicações Golang ๏ Collector ๏ OpenTelemetry Demo Documentation ๏ MELT 101
46. Perguntas
47. Contato https://eltonminetto.dev https://x.com/eminetto elton@minetto.dev