O rastreamento de versão Errors Inbox permite que os desenvolvedores monitor cada implantação para verificar a precisão e o sucesso. Digamos que você e sua equipe recebam um alerta informando que uma de suas entidades teve um aumento nas taxas de erros. Você identifica a origem do erro e decide liberar uma implantação canário. Você pode usar o rastreamento de versão para monitor sua correção, bem como a implantação anterior para determinar se você resolveu o problema ou se precisa voltar à prancheta.
Triagem por status de erro
Ao fazer a triagem da sua caixa de entrada, você pode escolher entre vários status. Você pode querer resolver os erros imediatamente ou até mesmo marcá-los para que sejam ignorados. Em outros casos, você pode querer resolver os problemas na próxima versão ou em uma versão específica.
Você pode definir um dos seguintes status e filtrar sua caixa de entrada por status:
Unresolved
: este é o status padrão dos grupos de erros.
Resolve in next version
: Recomendamos que você use esse status se espera resolver esse grupo de erros em sua próxima versão. Para habilitar esta opção, você precisa configurar o Monitoramento de Alterações do seu aplicativo para que Errors Inbox possa detectar uma nova versão e verificar se o grupo de erros foi realmente resolvido. Caso o grupo de erros ainda seja detectado na próxima versão ou em qualquer versão futura, o grupo de erros será resolvido automaticamente, marcado com uma regressão e você receberá uma notificação do Slack sobre a regressão.
Resolve in specific version
: Escolha esta opção para resolver grupos de erros nestas situações:
- Se você sabe que o grupo de erros será resolvido em uma versão específica
- Se você sabe que o grupo de erros foi resolvido em uma versão existente
- Se você quiser inserir uma versão específica
Para habilitar esta opção, você precisa de um instrumento de rastreamento de versão para seu aplicativo ou serviço. Se for detectada uma ocorrência de erro com uma versão semântica equivalente ou superior, o grupo de erros será resolvido automaticamente, marcado com uma regressão, e você receberá uma notificação do Slack sobre a regressão.
Resolve
: Definir um grupo de erros como resolvido irá ocultá-lo da visualização padrão da caixa de entrada, a menos que os filtros sejam atualizados para incluir grupos de erros resolvidos. Se ocorrer um evento correspondente à impressão digital do grupo de erros após marcar um grupo de erros como resolvido, o status será redefinido automaticamente para Unresolved. Isso pode ser útil para identificar regressões.
Ignore
: isso ocultará o grupo de erros da visualização da caixa de entrada, a menos que os filtros sejam atualizados para incluir erros ignorados ou até que você pare de ignorar o grupo de erros.
Dica
As opções Resolve in next version e Resolve in specific version só serão suportadas se sua equipe usar controle de versão semântico.
Entenda os campos de rastreamento de versão
Antes de usar o instrumento de rastreamento de versão, é importante entender como Errors Inbox classifica seus resultados. No aplicativo APM e OpenTelemetry, quando você rastreia erros, os seguintes campos de evento são verificados e exibidos nesta ordem:
service.versiontags.service.versiontags.releaseTagtags.commit
Para aplicativos móveis, o campo do evento é appVersion.
Para aplicativos de browser, o campo de evento é application.version.
Rastreamento de versão do instrumento
Para capturar dados do nosso rastreamento de versão, você deve configurar campos para entidade relevante:
Para entidade APM, configure variáveis de ambiente para entidade APM.
Filtrar por versão
Assim que você tiver o rastreamento da versão do instrumento, seus grupos de erros capturarão automaticamente os dados de cada versão. Você pode filtrar por cada versão.
Para filtrar grupos de erros com diversas versões, use o operador + para escolher uma condição OR .
Você pode usar o Monitoramento de Alterações para monitor sua implantação. Se você fez isso, é importante certificar-se de que sua implantação corresponda ao mesmo formato de versão do instrumento em sua entidade, para que você possa combinar as versões de seus erros com sua implantação.
Encontre versões por grupo de erros
Você também pode clicar em um grupo de erros para ver cada implantação que corresponde à primeira e à última data vista do seu grupo de erros. Você só verá versões que foram publicadas 30 minutos após a primeira data de visualização e 30 minutos antes da última data de visualização.
Você pode se aprofundar nos grupos de erros usando o gráfico que mostra cada uma das ocorrências de erros agrupadas por versão.
Se você também configurou implantações com Monitoramento de Alterações, verá o marcador de implantação neste gráfico. Esses marcadores indicam quando cada implantação foi lançada. Clique no marcador para navegar até a implantação.