Menu da documentação
Primeiros passos
Painel e análises
- Painel em resumo
- Análise de custo
- Desempenho de pipeline
- Insights de otimização
- Knowledge Base
- Conecte seu agente de IA
Runners gerenciados
- Visão geral dos runners
- Execute seu primeiro job
- A página de Runners
- Runners personalizados (AI Scan)
- Autorreparo
- Imagem e software do runner
- Limites e concorrência
Cache
Equipe e notificações
Faturamento e planos
Ajuda
Notificações
Todas as notificações que a Latchkey pode enviar, os quatro canais de entrega, os níveis de severidade e como ajustá-los por tipo de evento.
A Latchkey notifica você quando algo precisa de atenção: um pipeline quebrando repetidamente, um pico de custo, seu trial ou minutos gratuitos acabando, ou uma correção ficando pronta. Configure tudo em Settings, Notifications.
Canais#
Tudo também aparece no sino de notificações dentro do app, no cabeçalho do dashboard, independentemente das configurações de canal. O sino mostra sua contagem de não lidas (limitada a 99+), e seu painel de histórico permite colocar em dia tudo desde a última vez que você olhou: marque itens como lidos um por um, ou marque todos como lidos e comece do zero.
Níveis de severidade e padrões#
Os tipos de evento são agrupados em três níveis. Os tipos Critical e Important vêm com e-mail ativado por padrão; os tipos Informational vão para o resumo semanal por padrão. Cada tipo tem um período de espera para que um pipeline barulhento não inunde você com duplicatas.
O período de espera merece uma palavra sobre o porquê. A primeira notificação carrega todo o sinal: quando um workflow falha dez vezes em uma hora, "Pipeline is broken" já contou tudo na primeira falha, e nove repetições só treinariam você a ignorar o canal. Suprimir repetições dentro da janela de espera de cada tipo mantém cada notificação que você recebe digna de ser aberta.
O que pode notificar você#
| Notificação | Dispara quando | Nível |
|---|---|---|
| Pipeline is broken | Um workflow falha muitas vezes seguidas | Critical |
| Security risk detected | A IA sinaliza um problema de segurança em um workflow | Critical |
| Managed runner blocked | O lançamento de um runner foi bloqueado (estado de cobrança ou free-tier) | Critical |
| Trial expired | Seu trial gratuito terminou | Critical |
| Scan failed / AI scan runner build failed | Um scan de runner personalizado ou build de imagem não foi concluído | Critical |
| Unexpected CI spend | O custo de uma execução excede 4x a sua média de 30 dias | Important |
| Builds are slowing down | A duração do build excede 2.5x a sua média de 30 dias | Important |
| Diagnosis ready / Scan ready | Um diagnóstico de IA ou scan de runner está pronto para revisão | Important |
| AI scan runner is ready | A build da sua imagem de runner personalizada terminou | Important |
| Pipeline health declined | A taxa de sucesso do workspace caiu abaixo de 70% nas últimas 24 horas | Important |
| Recovery time worsening | O tempo médio de recuperação está 2x pior que nas duas semanas anteriores | Important |
| Free tier running out | Você cruzou 80% e depois 100% dos minutos de runner incluídos | Important |
| Trial ending soon | Três dias ou menos restantes no seu trial | Important |
| New optimization opportunity | Novas recomendações de IA estão disponíveis | Informational |
| Fix was applied | Um PR de otimização da Latchkey foi mesclado | Informational |
| Optimized workflows ready | Um lote de otimizações de workflow está pronto | Informational |
| Cost projection rising | O gasto mensal previsto está mais de 30% acima do mês passado | Informational |
Uma linha de base sugerida#
Os padrões já são sensatos: Critical e Important enviam e-mail, e Informational vai para o resumo. Se você quer uma postura inicial para ajustar, esta funciona para a maioria das equipes:
| Nível | Roteamento sugerido | Justificativa |
|---|---|---|
| Critical | E-mail (o padrão), mais Slack | Eventos de ação imediata: um pipeline quebrado, um lançamento de runner bloqueado, um trial expirado. Eles pertencem onde a equipe olha primeiro. |
| Important | E-mail (o padrão); adicione Slack para os avisos de free-tier e trial | Urgência em nível de dia. Os avisos de orçamento valem a pena serem colocados diante de toda a equipe antes de um bloqueio acontecer, não depois. |
| Informational | Resumo semanal (o padrão) | Recomendações e projeções ficam melhores em um único lote semanal do que como um gotejamento de e-mails avulsos. |
Duas observações ao aplicar isso. O roteamento do Slack é apenas para admins, enquanto cada membro mantém suas próprias escolhas de e-mail, push e resumo, então a linha de base são na verdade duas decisões separadas: o canal Slack compartilhado e seus canais pessoais. E o push do navegador é melhor tratado como pessoal: ative-o para você mesmo se você é a pessoa que age primeiro em problemas de CI, após conceder permissão na aba de configurações Notifications.
Como o resumo semanal se comporta#
O resumo é o lar do nível informativo. Eventos de baixa urgência (uma nova oportunidade de otimização, uma correção mesclada, um lote de workflows otimizados, uma projeção de custo crescente) são agrupados em um único e-mail semanal em vez de chegarem um por um. É também por isso que os tipos informativos mostram um botão Digest na matriz de configurações em vez de um botão de e-mail por evento: a escolha que você está fazendo é se um tipo participa do agrupamento.
Um hábito sugerido: trate o resumo como uma fila de revisão semanal. Nada nele precisa de ação no mesmo dia, mas oportunidades de otimização e projeções de custo se acumulam se ninguém olhar para elas; uma rápida leitura semanal, com Insights de otimização aberto na próxima aba, geralmente é suficiente.
Ajustes e testes#
- Cada tipo de evento tem botões de ativação por canal na matriz de configurações; os tipos informativos expõem um botão Digest em vez de e-mail por evento.
- Os Shortcuts cobrem as mudanças amplas: os botões mestres invertem um nível inteiro ou uma coluna de canal inteira de uma vez, Mute all email silencia o e-mail com um clique, Critical only mantém apenas os alertas dignos de atenção, e Reset to defaults restaura a configuração padrão.
- Os admins podem enviar uma test notification de qualquer tipo para verificar a integração de ponta a ponta.
- As configurações do Slack são apenas para admins; os membros mantêm suas escolhas pessoais de e-mail, push e resumo.
- Todo e-mail de notificação também carrega um unsubscribe link caso você prefira cancelar a inscrição pelo lado da caixa de entrada.