Como lidar com webhooks do jeito Hookdeck

No artigo anterior, apresentamos a Hookdeck. Vamos entrar a fundo na missão da Hookdeck: garantir que você nunca perca um webhook. Essa promessa levou ao desenho de funcionalidades que constroem resiliência em torno das fraquezas dos webhooks e dos problemas enfrentados ao usá-los em produção.

Neste artigo, vamos descrever a estratégia da Hookdeck para lidar com webhooks e ver as principais funcionalidades criadas para garantir que os seus webhooks sejam sempre entregues de forma confiável.

Como a Hookdeck lida com webhooks

A Hookdeck define um canal de comunicação de webhook entre um produtor e um consumidor como uma Connection. Você configura uma Connection entre um produtor (por exemplo, a Stripe) e o seu servidor de API, o consumidor.

Uma connection pode ser configurada em questão de segundos e já vem com:

• Processos de ingestão
• Uma fila de ingestão
• Armazenamento de webhooks
• Gestão de eventos
• Logging e monitoramento
• Garantia de entrega

Uma connection é um pipeline de webhooks com resiliência pronta para uso. A Hookdeck cuida do provisionamento e da gestão de uma arquitetura orientada a eventos (Kafka, Redis, Kubernetes etc.) nos bastidores, para que você não precise fazer isso. Para um mergulho no que compõe uma infraestrutura de webhooks robusta, veja o nosso guia de arquitetura.

Na próxima seção, vamos ver as funcionalidades que você ganha com a Hookdeck e discutir como elas contribuem para uma experiência de desenvolvimento sem dor de cabeça ao trabalhar com webhooks.

Com a Hookdeck, nada de infraestrutura, só workflow

No nosso artigo “Por que consertar webhooks pode ser mais difícil do que você imaginava”, mencionamos que webhooks fazem parte de uma arquitetura orientada a eventos e devem ser tratados de forma assíncrona. Também discutimos os requisitos de uma arquitetura orientada a eventos padrão. Nesta seção, vamos revisitar a lista de atributos esperados em uma arquitetura orientada a eventos e discutir como a Hookdeck criou funcionalidades para atender a essas necessidades.

Ingestão, enfileiramento e processamento assíncrono com Connections

Quando você configura uma connection entre o seu produtor de webhooks (por exemplo, a Shopify) e o seu servidor de API, a Hookdeck automaticamente atua como uma fila entre as duas partes. Com essa fila, a Hookdeck responde aos produtores de webhooks em menos de 200ms, garantindo que você não ultrapasse o limite de tempo de resposta definido pelo produtor.

A fila vai automaticamente armazenar os seus webhooks e entregá-los ao(s) seu(s) consumidor(es) na taxa que eles conseguem suportar. Isso ajuda a suavizar o tráfego que poderia gerar picos e derrubar o seu consumidor.

Você também pode controlar a taxa com que os webhooks são enviados aos seus consumidores configurando regras de rate limiting nos seus destinos de webhook. Isso também ajuda a proteger o(s) seu(s) servidor(es) de picos de volume.

Monitoramento da Hookdeck

A Hookdeck registra automaticamente todos os seus eventos de webhook e conta com um dashboard intuitivo para monitorar a atividade deles. O dashboard ajuda você a ver ações em tempo real e padrões históricos dos seus webhooks.

Você tem visibilidade sobre todos os seus webhooks e consegue rastrear com facilidade os que falharam para investigá-los.

Quando um webhook falha, as ferramentas de monitoramento da Hookdeck fornecem todos os dados necessários para investigar o problema. Isso inclui o payload do webhook, os headers e dados de contexto como timestamps, informações do produtor e do destino, e as tentativas de retry.

Administradores podem configurar alertas para eventos específicos que exigem ação imediata ou para eventos sobre os quais querem ser avisados quando acontecerem. Você também pode buscar webhooks, marcar um webhook como favorito e reenviar um webhook que está investigando.

Issues e notificações

A Hookdeck facilita a coordenação da resolução de problemas entre times com a funcionalidade de Issues. Com issues, você acompanha problemas e comunica os passos de resolução ao seu time quando um webhook falha.

Quando um webhook falha, em vez de vasculhar milhares de entradas de log até encontrar o problema, a Hookdeck abre automaticamente uma issue e notifica os membros do seu time. Você também recebe imediatamente todo o contexto e os dados em torno do problema, em vez de tentar decifrar entradas de log. Isso ajuda a reduzir o tempo entre falha e remediação.

As issues são agrupadas e filtradas. Quando você está trabalhando em uma Issue, pode marcá-la como reconhecida para avisar aos membros do time que você está cuidando dela. Uma vez resolvida, você pode reenviar todos os webhooks que falharam por causa daquele problema e notificar o time de que ele foi corrigido.

Retries

Falhas são inevitáveis. A Hookdeck entende isso e dá a cada webhook que falha uma chance de nova tentativa. Você pode configurar os seus webhooks para serem reenviados automaticamente após uma falha ou reenviá-los manualmente pelo dashboard.

Retries automáticos tornam os seus webhooks tolerantes a falhas e ajudam a eliminar falhas transitórias como quedas de rede e congestionamento de servidor, automatizando o seu processo de recuperação de erros.

Você também define quantas vezes quer que um webhook com falha seja reenviado e os intervalos entre cada tentativa. Para problemas que exigem investigação e correção, os retries manuais permitem reenviar o webhook depois que a solução for implementada.

Também é possível reenviar um grande volume de webhooks com falha de uma só vez. Isso elimina o trabalho repetitivo de reenviar cada webhook um a um ou escrever um script customizado para reenviar todos os webhooks que falharam por causa do problema.

A Hookdeck por dentro

Se você for como eu e gostar de ver como as coisas funcionam por dentro para se convencer da sua eficácia, talvez se interesse por mais detalhes sobre como a Hookdeck garante confiabilidade.

Felizmente, temos um artigo inteiro dedicado a tirar qualquer dúvida remanescente. Confira o artigo “Hookdeck’s Approach to Reliability” para entender melhor como estamos tornando os webhooks resilientes na Hookdeck.

Benefícios de usar uma infraestrutura de webhooks

A solução padrão descrita em um artigo anterior desta série tem muitas partes móveis. A solução híbrida é composta por diferentes tipos de componentes de vários fornecedores. Há ainda o desafio de gerenciar versões diferentes de cada componente que compõe a solução.

Diferente dessa abordagem, a Hookdeck é uma solução de fornecedor único e completa, desenhada especificamente para entregar webhooks de forma confiável do produtor ao consumidor.

Assim, você tem apenas um componente, em vez de três ou mais, entre os seus produtores e consumidores de webhooks. Abaixo estão alguns benefícios de usar a Hookdeck em vez da solução híbrida:

• Você não precisa aprender várias partes, apenas uma.
• Você não precisa lidar com atualizações, upgrades ou breaking changes de vários fornecedores.
• Foi construída para monitorar, rastrear e investigar webhooks.
• O workflow é sempre o mesmo.
• É fácil integrar novos membros ao time e preservar o conhecimento sobre como vocês lidam com webhooks.
• Todas as partes são bem documentadas.
• Cada funcionalidade se integra perfeitamente com as outras.

Conclusão

Recapitulando, o objetivo da Hookdeck é dar autonomia aos desenvolvedores com acesso instantâneo a uma infraestrutura de webhooks confiável. Ela abstrai a complexidade da arquitetura orientada a eventos e foca em propor uma experiência de desenvolvimento alinhada com as necessidades de quem programa.

A Hookdeck dá visibilidade completa sobre as suas operações de webhooks, com notificações acionáveis, e oferece recursos tolerantes a falhas para minimizar problemas e se recuperar rapidamente deles, não importa quantos webhooks você precise processar a qualquer momento.

Comece gratuitamente hoje mesmo.