Guia Configuração do External Service Alert Sentry na Elven Platform

O External Services Center da Elven Platform é a ponte que conecta você às melhores ferramentas do mercado para monitorar, gerenciar e resolver incidentes de forma simples e eficiente. Nele, é possível integrar o Sentry com a Elven Platform, permitindo o recebimento de alertas e eventos relacionados a incidentes diretamente na plataforma. Isso possibilita monitorar e analisar suas aplicações e serviços sob a perspectiva da Gestão de Incidentes, utilizando as melhores práticas e metodologias do mercado, tudo em um único lugar.

API Token

Para integrar a Elven Platform com o Sentry, precisamos criar um API Token. Essa chave única é indispensável para que as duas plataformas se conectem com segurança, garantindo a troca de informações confiável e autenticada. Basta acessar o Organization Settings da Elven Platform, navegar até a seção de API e gerar.

Criando um API Token

• No menu superior na parte de configuração de seu usuário, clique em Organization Settings.

• Na aba API, clique no botão + para criar um novo API Token.

Acessando External Service Alert Sentry

• Navegue até o menu principal e clique em Services Hub.

• Em External Services Monitoring, selecione o item Alert Sentry.

Criando o External Services para Alert Sentry

No formulário, comece preenchendo o campo External Service Name, que será o nome do serviço externo, e defina os Responders, ou seja, as pessoas ou equipes que receberão notificações relacionadas a este serviço. Após isso, clique em CREATE para prosseguir. Essa ação criará o registro inicial do seu serviço externo.

Em seguida, localize o API Token que você gerou anteriormente e selecione-o para configurar a integração com o Sentry.

Configurando Webhooks no Sentry

Integrar o Sentry à Elven Platform é um processo intuitivo que permite centralizar a gestão de incidentes em um único lugar, proporcionando maior agilidade e controle. Vamos explicar como realizar essa configuração de forma clara e prática.

Tudo começa acessando o painel do Sentry. Clique em Settings e, logo em seguida, em Integrations. Nessa área, você encontrará todas as opções de integração disponíveis. Para facilitar, digite “Webhook” na barra de busca e localize rapidamente a integração que vamos configurar.

Com a integração de Webhooks selecionada, clique em Add Project e selecione seu projeto. Se você ainda não tiver um configurado, será necessário fazer isso antes. Insira a URL que foi gerada quando você configurou o External Service Sentry na Elven Platform. Essa URL é fundamental para estabelecer a conexão entre as duas plataformas.Após preencher o campo Callback URLs, lembre-se de clicar em Save Changes para garantir que as alterações sejam aplicadas.

Depois disso, ative a integração clicando em Enable Plugin.

Agora, é hora de testar! O Sentry oferece a funcionalidade Test Plugin, que simula o envio de um alerta para verificar se a comunicação está funcionando corretamente. Quando tudo estiver configurado corretamente, você verá um incidente criado automaticamente na Elven Platform. Isso confirma que a integração foi bem-sucedida e que os alertas estão sendo transmitidos como esperado.

Assim que configurado, o serviço aparecerá no External Services Monitoring Center, classificado por status, facilitando o monitoramento de incidentes com prioridade para aqueles em estado de alarme.

Configurações adicionais de segurança e performance

• Whitelist de IPs: A comunicação via API pode ser configurada para permitir apenas IPs autorizados. Para ativar ou modificar essa configuração, entre em contato com o suporte da Elven Platform.

• Rate Limiting: O tempo padrão para limitação de requisições é 5 minutos, mas pode ser ajustado conforme a necessidade. Para alterações, entre em contato com o suporte da Elven Platform.

Essas configurações garantem maior segurança e controle sobre o tráfego de dados entre os sistemas integrados.

Glossário de Termos Técnicos

Sentry: Plataforma de monitoramento e rastreamento de erros, utilizada para identificar e gerenciar problemas em aplicações.

API Token: Chave de autenticação gerada na Elven Platform para permitir uma comunicação segura e confiável com ferramentas externas. Organization Settings Seção da Elven Platform onde é possível configurar opções organizacionais, como gerar API Tokens para integrações.

External Service Name: Nome dado a um serviço externo durante sua configuração, usado para identificá-lo na Elven Platform.

Responders: Pessoas ou equipes designadas para receber notificações de incidentes gerados por um serviço externo.

WebHook: Mecanismo de integração que permite o envio de dados em tempo real entre duas plataformas. No contexto desta integração, é usado para enviar alertas do Sentry para a Elven Platform.

Callback URL: URL fornecida pela Elven Platform durante a configuração do External Service, usada no Sentry para estabelecer a comunicação entre as plataformas.

Save Changes: Botão no painel do Sentry que salva as alterações realizadas na configuração da integração.

Enable Plugin: Opção no Sentry que ativa o plugin de integração após as configurações serem salvas.

Test Plugin: Funcionalidade do Sentry que permite testar a integração configurada, simulando o envio de um alerta.

External Services Monitoring Center: Seção na Elven Platform que exibe o status e detalhes dos serviços externos integrados, facilitando o acompanhamento de incidentes.