Encontre e explore rastos

Para identificar valores atípicos e ver detalhes de intervalos individuais, use a secção tabular:

• Pode ordenar as linhas dos separadores Intervalos e Agrupados pelo cabeçalho de duração.

• Para compreender quantos intervalos diferentes serviços estão a gerar, use o separador Agrupado. Cada linha corresponde a um serviço e a um nome de intervalo e, para cada entrada, são apresentadas estatísticas de latência.

Para explorar os detalhes de um intervalo ou um agrupamento, selecione a entrada de uma linha na secção tabular. É aberto um menu flutuante que apresenta o intervalo no contexto do respetivo rastreio. Nesta vista, pode explorar o intervalo, os respetivos atributos e ver eventos e dados de registo. Também pode pesquisar palavras-chave nos intervalos e atributos no rastreio.

Os dados de rastreio dos quais a página Explorador de rastreios depende do seguinte:

• Os projetos nos quais foram pesquisados dados de rastreio. Por predefinição, o sistema só pesquisa o projeto selecionado pelo seletor de projetos para dados de rastreio. No entanto, pode configurar a página para pesquisar a lista de projetos num âmbito de rastreio.
• As suas autorizações da gestão de identidade e de acesso (IAM) nos projetos pesquisados. Se não tiver autorização para ver os dados de rastreio de um projeto, a consola apresenta uma mensagem de aviso e os dados desse projeto não são apresentados. Google Cloud
• A definição do intervalo de tempo.
• Os filtros que aplica.

O resto desta página fornece mais informações sobre como encontrar e explorar os dados de rastreio.

Antes de começar

Para receber as autorizações de que precisa para ver dados de rastreio através da Google Cloud consola e para selecionar um âmbito de rastreio, peça ao seu administrador para lhe conceder a função do IAM utilizador do Cloud Trace (roles/cloudtrace.user) no seu projeto. Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.

Esta função predefinida contém as autorizações necessárias para ver dados de rastreio através da Google Cloud consola e para selecionar um âmbito de rastreio. Para ver as autorizações exatas que são necessárias, expanda a secção Autorizações necessárias:

Também pode conseguir estas autorizações com funções personalizadas ou outras funções predefinidas.

Para mais informações sobre as funções, consulte o artigo Controle o acesso com a gestão de identidades e acessos.

Veja dados de rastreio agregados

Para ver as informações agregadas sobre os dados de rastreio, faça o seguinte:

1. Na Google Cloud consola, aceda à página Explorador de rastreios:

   Aceda ao Explorador de rastreios

   Também pode encontrar esta página através da barra de pesquisa.

   Pode demorar vários minutos após a gravação dos primeiros dados de rastreio num Google Cloud projeto antes de esses dados estarem disponíveis para visualização. Se não vir dados de rastreio apresentados após aguardar alguns minutos, significa que o seu projeto pode não ter dados para apresentar ou pode existir um problema de configuração. Para obter informações sobre como resolver estes problemas, consulte o artigo Resolução de problemas: não existem dados na interface de rastreio.

2. Configure a página do Explorador de rastreios:

   1. Na barra de ferramentas da Google Cloud consola, selecione o seu Google Cloud projeto. Para configurações do App Hub, selecione o projeto anfitrião ou o projeto de gestão do App Hub.

   2. Opcional: configure em que projetos são pesquisados dados de rastreio através do elemento Âmbito:

      • Para mostrar os dados de rastreio armazenados no seu projeto, defina o primeiro menu do elemento Âmbito como Projeto ou _Predefinição. Estas duas definições são equivalentes.

      • Para mostrar os dados de rastreio armazenados em vários projetos, expanda o primeiro menu do elemento Âmbito, selecione Âmbito de rastreio e, de seguida, selecione o âmbito de rastreio que lista esses projetos. Depois de fazer a seleção, o menu Âmbito apresenta um ícone de âmbito de rastreio, , e o nome do âmbito de rastreio selecionado.

      Os dados devolvidos dependem das suas funções do IAM nos projetos pesquisados. Por exemplo, se os projetos pesquisados incluírem um Google Cloud projeto ao qual não tem acesso, não são devolvidos dados de rastreio para esse projeto.

      Para mais informações, consulte o artigo Crie e faça a gestão de âmbitos de rastreio.

   3. Opcional: atualize o intervalo de tempo através do seletor de intervalo de tempo ou usando o ponteiro para realçar um intervalo no eixo X.

      Por exemplo, pode definir este seletor como Últimas 2 semanas quando quiser ver se existem tendências nos dados de latência. Os dados de intervalos são armazenados durante 30 dias.

3. Explore o mapa térmico:

   • Use a cor para identificar tendências e valores atípicos. Uma célula com muitos intervalos tem uma cor mais escura do que uma com poucos intervalos.

   • Veja os detalhes da célula através da sugestão da célula. A sugestão apresenta o número de intervalos, a data e a hora, e o intervalo de tempo da célula.

4. Explore os percentis de latência e as taxas de erro:

   • Para ver as tendências de latência, defina o menu Vista de gráfico para Duração do intervalo (percentil). O gráfico de duração apresenta os percentis 50, 90, 95 e 99.

   • Para ver o estado de resposta em função do tempo, defina o menu Vista de gráfico como Taxa de intervalo. O gráfico apresenta a taxa de intervalos enviados para o seu projeto.

5. Use as tabelas Intervalos e Agrupados para identificar valores atípicos ou ver informações estatísticas. A tabela Intervalos apresenta intervalos individuais. A tabela Agrupado agrupa os intervalos pelo respetivo nome e pelo nome do serviço ou da carga de trabalho.

   • Para ver valores atípicos ou encontrar um nome de intervalo, ordene a tabela. Pode ordenar por qualquer cabeçalho de coluna.

     Por exemplo, ordenar a tabela Intervalos por duração permite-lhe encontrar intervalos com latência elevada.

   • Para ver estatísticas como a latência média, use a tabela Agrupado.

   • Para encontrar serviços e cargas de trabalho registados no App Hub, pesquise na coluna Serviço/carga de trabalho entradas que incluam o ícone do serviço, , ou o ícone da carga de trabalho, . O link fornecido com um serviço ou uma carga de trabalho registada no App Hub abre o painel de controlo de monitorização de aplicações correspondente.

   Se quiser mais informações sobre um agrupamento específico, selecione o nome do intervalo de uma linha. É aberto um menu de sobreposição que apresenta o intervalo no contexto do respetivo rastreio. Em seguida, pode explorar o intervalo e o rastreio.

6. Para restringir os intervalos apresentados, adicione filtros. Para saber mais sobre como filtrar os dados de rastreio, consulte a secção seguinte.

Filtre os dados de rastreio

Para apresentar apenas informações do seu interesse, aplique filtros. Os filtros restringem os dados apresentados. Por exemplo, pode filtrar por nome do serviço e por estado. Em alternativa, se tiver implementado aplicações no App Hub, pode querer ver os dados de rastreio apenas para a aplicação ou para um serviço ou uma carga de trabalho específicos que façam parte da aplicação.

Quando adiciona ou remove um filtro, os dados apresentados na página Explorador de rastreios são atualizados e mostram apenas os intervalos que correspondem a todos os filtros aplicados.

Filtre um rastreio por ID

Quando está a resolver problemas de um incidente ou uma falha, pode saber o ID do rastreio. Para explorar esse rastreio, aceda à barra de ferramentas, clique em visualização de página Pesquisar rastreio e introduza o ID do rastreio.

Quando introduz um ID válido, o menu de sobreposição Detalhes é aberto e apresenta informações sobre o rastreio e os respetivos intervalos. Pode usar as opções nesse painel para explorar o rastreio. Por exemplo, pode pesquisar palavras-chave nos intervalos.

Aplique filtros de intervalo

O painel Filtros de intervalo apresenta os filtros mais comuns. Pode selecionar várias entradas de qualquer subcategoria. À medida que adiciona ou remove filtros, a barra Filtro também é atualizada.

Os valores de todos os menus são derivados dos seus dados de rastreio. Quando um menu inclui uma opção sem texto, essa opção refere-se a intervalos que não incluem o atributo correspondente.

Os seguintes filtros de intervalo estão normalmente disponíveis:

• Serviço OpenTelemetry: filtra pelo atributo service.name.
• Nome do intervalo: nome do intervalo.
• Estado do intervalo: o estado do pedido. Para informações sobre os valores, consulte a documentação SpanStatus do OpenTelemetry.
• Duração: a duração do intervalo.
• Tipo de intervalo: descreve as relações entre intervalos. Para obter informações acerca dos valores, consulte a documentação SpanKind do OpenTelemetry.
• Aplicação App Hub: filtra pelo gcp.apphub.application.id atributo do recurso.
• Serviço App Hub: filtra pelo gcp.apphub.service.id atributo do recurso.
• Carga de trabalho do App Hub: filtra pelo gcp.apphub.workload.id atributo do recurso.

Se quiser filtrar por um atributo que não esteja listado no painel Filtros de intervalo, use a barra Filtro.

Use a barra de filtros

A barra Filtrar permite-lhe aplicar um filtro com uma chave de filtro predefinida e um valor que selecionar, ou pode introduzir a chave e o valor.

Para adicionar um filtro, selecione Adicionar filtro e, de seguida, faça uma das seguintes ações:

• Selecione uma chave definida, como Nome do intervalo, e, de seguida, selecione um valor no menu secundário.

• Selecione Adicionar filtro de atributo e, de seguida, adicione a chave e o valor personalizados. Se introduzir a sua própria chave de filtro, use a mesma sintaxe que uma chave para um atributo num intervalo.

  Por exemplo, para filtrar pelo identificador do anfitrião, defina a chave como host.id. Da mesma forma, para filtrar por código de estado, defina a chave como /http/status_code. Neste cenário, pode definir o valor como 200, o que resulta no filtro /http/status_code: 200. Para permitir que o filtro corresponda a qualquer valor, selecione Qualquer valor.

Filtrar por aplicação

Para encontrar ou ver intervalos que os serviços registados no App Hub e as cargas de trabalho geram, os seus intervalos têm de conter os seguintes atributos de recursos:

• gcp.apphub.application.{container,id,location}
• gcp.apphub.{workload,service}.{criticality_type,environment_type,id}

Os atributos de recursos anteriores são gerados pela instrumentação que adiciona às suas aplicações. Pode filtrar os dados de rastreio por qualquer atributo de recurso. No entanto, os seguintes filtros de intervalo filtram por IDs da aplicação, do serviço e da carga de trabalho: