Um problema no Issue Tracker do Google é um relatório de bug, solicitação de recurso, solicitação de mudança ou item de fluxo de trabalho de processo que um usuário quer acompanhar ou espera que outro usuário ou equipe acompanhe. Os problemas são organizados em componentes, cada um contendo um grupo de problemas relacionados. Cada problema no Issue Tracker tem uma página de detalhes própria, em que os usuários rastreiam a atividade, fazem comentários e atualizam os dados.
Campos de problema
Cada problema tem um conjunto de campos associados que o descrevem e o estado atual. Isso inclui o tipo de problema, a importância em termos de gravidade e prioridade e o registro de atividades sobre o problema. Alguns campos são comuns a todos os problemas. O Issue Tracker também oferece suporte a campos personalizados que só estão disponíveis quando um problema é associado a um componente específico. Para todos os novos problemas, há vários campos obrigatórios. Eles incluem Componente, Título, Prioridade e Tipo. Alguns componentes também têm campos personalizados obrigatórios.
Na página de detalhes do problema, a maioria dos campos está no lado direito da página no painel Campos do problema. Quase todos os campos podem ser editados no Issue Tracker clicando no valor, na lista suspensa ou no ícone de lápis associado a eles. Quando você passa o cursor sobre um campo, o Issue Tracker fornece uma breve descrição do campo no texto de passagem do cursor.
Para uma descrição dos campos de problemas padrão, consulte Glossário de campos.
Tipo de problema
O campo Type permite categorizar problemas em um componente em um dos vários grupos comuns. Este campo é obrigatório. A tabela a seguir mostra os possíveis tipos de problema:
| Tipo de problema | Descrição |
|---|---|
| Bug | O comportamento é contrário ao que deveria ocorrer ou foi documentado para ocorrer, ou o produto não funciona como esperado. |
| Solicitação de recurso | O produto funciona como esperado, mas pode ser melhorado com as mudanças especificadas. |
| Problema do cliente | O problema está afetando terceiros e não pode ser reproduzido pela pessoa que o relatou. Esse problema pode ser uma questão de solução de problemas ou treinamento, mas pode ser um bug ou uma solicitação de recurso. |
| Limpeza interna | O problema não tem efeito externo no comportamento de um produto, mas resolvê-lo permitiria uma interação mais simplificada ou intuitiva ao desenvolver o produto. Você também pode usar esse tipo para rastrear problemas de manutenção. |
| Processo | O processo é uma categoria miscelânea que tem usos variados, dependendo do projeto. Por exemplo, é possível usar esse tipo para problemas gerados por uma API ou para acompanhar tarefas administrativas. |
| Vulnerabilidade | Vulnerabilidades de privacidade e segurança sujeitas a SLOs definidas pelas diretrizes de privacidade e segurança do Google. |
| Problema de privacidade | Outras questões de privacidade sujeitas a SLOs definidos pelas diretrizes de privacidade e segurança do Google. |
| Programa | Uma coleção de metas relacionadas tematicamente (projetos, recursos, marcos, épicos). |
| Projeto | Um esforço orientado por metas com início e fim definidos, focado na criação de um produto, serviço ou resultado único. |
| Recurso | Uma coleção de trabalho que oferece um valor específico ao usuário. |
| Marco | Uma coleção de trabalhos que representa uma conquista importante no caminho para a conclusão de um projeto. Os marcos também podem ser usados para representar lançamentos ou versões. |
| Epic | Uma grande coleção de trabalhos com um objetivo comum. |
| Matéria | Uma pequena coleção de trabalho que oferece um valor específico ao usuário. |
| Tarefa | Uma pequena unidade de trabalho. |
Prioridade do problema
O campo Prioridade permite especificar a importância de um problema. Este campo é obrigatório. As equipes geralmente têm critérios diferentes para determinar a importância de um problema. A tabela a seguir mostra uma maneira comum de priorizar problemas:
| Prioridade do problema | Descrição |
|---|---|
| P0 | Um problema que precisa ser resolvido imediatamente e com quantos recursos forem necessários. Esse problema causa uma interrupção total ou faz com que uma função crítica do produto fique indisponível para todos, sem nenhuma solução alternativa conhecida. |
| P1 | Um problema que precisa ser resolvido rapidamente. Esse problema afeta significativamente uma grande porcentagem de usuários. Se houver uma solução alternativa, ela será parcial ou muito difícil. O impacto do problema é em uma função organizacional principal ou impedimento fundamental de outra equipe. |
| P2 | Um problema que precisa ser resolvido em um período razoável. Esse problema pode ser um dos seguintes: 1) um problema que seria P0 ou P1, mas tem uma solução alternativa razoável; 2) um problema que é importante para uma grande porcentagem de usuários e está conectado a funções organizacionais principais; 3) um problema que impede o trabalho de outras equipes e não tem uma solução alternativa razoável. O P2 é especialmente relevante para problemas de primeiro uso ou de instalação. É o nível de prioridade padrão. |
| P3 | Um problema que precisa ser resolvido quando possível. Esse problema é relevante para funções organizacionais principais ou para o trabalho de outras equipes, mas não impede o progresso ou tem uma solução alternativa razoável. |
| P4 | Um problema que precisa ser resolvido em algum momento. Esse problema não é relevante para as funções organizacionais principais ou o trabalho de outras equipes, ou se relaciona apenas à atração ou prazer do sistema. |
Status do problema
O campo Status permite especificar o status de um problema no processo de resolução. As equipes geralmente têm definições diferentes sobre quais atividades precisam ocorrer para que um problema mude de status ou seja resolvido. Nem todos os valores de campo Status disponíveis precisam ser usados para acompanhar a resolução de um problema. A tabela a seguir mostra maneiras comuns de usar o campo Status:
| Status do problema | Descrição |
|---|---|
| Nova | O problema não tem uma pessoa ou grupo atribuído. |
| Atribuída | O problema está atribuído a uma pessoa. Essa pessoa aparece no campo Assignee. |
| Em andamento (aceita) | O responsável reconheceu o problema e começou a trabalhar nele. |
| Correção | O problema foi resolvido. |
| Corrigido (verificado) | O problema foi resolvido, e a correção foi confirmada pelo usuário no campo Verifier. |
| Não corrigido (inviável) | As mudanças necessárias para resolver o problema não são viáveis. |
| Não corrigido (não reproduzível) | Não há informações suficientes para corrigir o problema ou ele não pode ser recriado. |
| Não corrigido (obsoleto) | O problema não é mais relevante devido a mudanças no produto. |
| Não corrigido (comportamento pretendido) | O problema descreve o comportamento esperado do produto nas circunstâncias informadas. |
| Duplicar | O problema foi relatado em outro lugar. Para definir o status de um problema como Duplicado, consulte Duplicar um problema. |
O Rastreador de problemas considera os problemas como Abertos ou Fechado, dependendo do status. Os problemas abertos são aqueles que estão aguardando resolução. Isso inclui qualquer problema com status Novo, Atribuído ou Em andamento. Os problemas fechados são aqueles que não exigem mais ações, exceto, talvez, verificação. Isso inclui qualquer problema com status Fixed, Won't fix ou Duplicate.
Ícones de status
Os ícones de status são uma representação visual do status de um problema. É possível definir a coluna Status de uma página de resultados da pesquisa para mostrar ícones de status em vez de texto de status.
Status de mudança rápida
Um link de mudança rápida de status aparece na página de detalhes do problema no painel Issue fields. O link avança o problema para a próxima etapa típica do processo de resolução. Clicar no link vai avançar o status do problema da seguinte forma:
Se o problema for novo e não tiver sido atribuído, o comando de mudança rápida vai mostrar Atribuir a mim. A mudança rápida do status vai definir o atribuído como você e mudar o status para Atribuído. Essa opção também aparece se o problema estiver Atribuído ou Em andamento e você não for o atribuído. Nesse caso, o atribuído será definido como você e o status não será alterado.
Se você for o responsável por um problema e o status dele for Atribuído, o comando de mudança rápida vai ser Iniciar trabalho. A mudança rápida muda o status do problema para Em andamento.
Se você for o atribuído de um problema e o status dele for Em andamento, o comando de mudança rápida vai ser Marcar como corrigido. A mudança rápida muda o status do problema para Corrigido.
Se um problema tiver o status Corrigido e você for o verificador, o comando de mudança rápida vai mostrar Verificar. A mudança rápida muda o status do problema para Corrigido (verificado).
Se um problema tiver um status fechado (Resolvido, Duplicado ou Não será corrigido), o prompt de mudança rápida vai mostrar Reabrir (exceto no caso mencionado acima). A mudança rápida muda o status para Novo se o problema não tiver um responsável ou Atribuído se tiver.
Cards de informações do problema
Um card de passagem de problema contém informações como título, ID, descrição e status atual de um problema. Além disso, ele contém dois botões: um +1 para indicar que você foi afetado pelo problema e um botão CC me que adiciona você à lista de CC do problema. Se você já estiver na lista de CC, o botão vai mostrar Un-CC me. Exemplo:
Os cards de problema aparecem quando você passa o cursor sobre:
- ID do problema nas colunas Bloqueado por, Bloqueio ou Duplicado de de uma página de resultados da pesquisa de problemas.
- Link para um problema encontrado no painel Possíveis duplicatas, localizado na parte de baixo da página Criar problema.
- Campo Status em uma página de problema marcada como duplicada.
- Link para o problema canônico encontrado na barra na parte de cima de uma página marcada como duplicada.
Editar problemas
Se você tiver a permissão Edit Issues (Editar problemas) em um componente, poderá editar campos de problemas e anexar comentários a eles. No entanto, alguns campos não podem ser editados, como a data de criação do problema.
Editar níveis
As mudanças em um problema têm níveis de importância variados que determinam se as mudanças aparecem no painel de histórico do problema e se os usuários recebem notificações por e-mail quando a mudança ocorre.
Fechar edições
As edições de fechamento mudam o status de um problema de Aberto para Fechado. As edições de fechamento aparecem no painel de histórico do problema. As edições de encerramento são enviadas como notificações por e-mail para usuários com uma das seguintes configurações de notificação: Todas as atualizações, Atualizações principais ou Somente encerramento.
Para conferir uma lista completa de status que fecham um problema aberto, consulte status do problema.
Edições importantes
As edições importantes sempre aparecem no painel de histórico do problema. Depois de uma edição importante, uma notificação por e-mail é enviada para os usuários que têm a configuração de notificação Todas as atualizações ou Atualizações importantes. As edições consideradas principais incluem:
- Criação inicial do problema.
- Comentários adicionados ao problema.
- O problema é movido para um novo componente.
- Mudanças na prioridade, gravidade, retenção ou atribuição.
- Uma mudança de status para Encerrado, Verificado ou Reaberto.
- Mudanças em campos personalizados marcados como Principais.
Pequenas edições
As edições menores só aparecem no painel de histórico de um problema se o nível de filtro estiver definido como Histórico completo. Da mesma forma, as edições menores são enviadas apenas como notificações por e-mail para usuários cuja função no problema tem uma configuração de notificação de Todas as atualizações.
As edições consideradas menores incluem:
- Alterações no título.
- Mudanças nas listas de e-mails em questão.
- Adicionando anexos.
- Mudanças nas relações de problema (bloqueio, bloqueado por, duplicado).
- Mudanças no status não declaradas explicitamente como edições importantes.
- Mudanças nos seguintes campos: Reporter, Type, Verifier, Found In, Targeted To, Verified In, In Prod.
- Mudanças em campos personalizados marcados como Pequenas.
Edições silenciosas
As edições silenciosas não geram e-mails de notificação para nenhum usuário, a menos que a edição seja para adicionar ou remover esses usuários do problema. As edições consideradas silenciosas incluem:
- Adicionar ou remover entradas dos campos CC ou Collaborator, a menos que o usuário ou grupo esteja sendo adicionado ou removido.
- Editando um comentário.
- Alterar um campo personalizado marcado como Silencioso.
Limites de acesso a emissões
O Rastreador de problemas oferece suporte a restrições de controle de acesso que permitem que os problemas tenham um conjunto menor de acessórios do que outros problemas no mesmo componente.
Os administradores de problemas podem atualizar o status de restrição de um problema para um dos quatro níveis de acesso:
Acesso padrão: as regras normais se aplicam: um problema com o nível de acesso padrão tem os mesmos acessórios que todos os outros problemas no componente.
Comentários limitados: apenas as identidades que estão explicitamente listadas no problema como atribuídas, colaboradoras, verificadoras ou CC podem comentar sobre o problema, independentemente de terem permissões de comentário para outros problemas no componente. As identidades com a permissão de problemas de administrador no componente também mantêm o acesso aos comentários. O acesso de leitura continua padrão.
Visibilidade limitada: apenas as identidades listadas explicitamente (atribuídas, colaboradores, verificadores ou CC) mantêm o acesso de leitura ao problema.
Visibilidade limitada + Google: apenas identidades listadas explicitamente (responsável pela atribuição, colaborador, verificador ou CC), Googlers em tempo integral e contas de automação internas mantêm o acesso de visualização ao problema.