Resolver problemas

Esta página contém informações sobre solução de problemas do Trace.

Não há dados na interface do Trace

Se não for possível visualizar os traces no projeto do Google Cloud quando você espera a existência de dados de trace, siga estas etapas:

  1. No Console do Google Cloud, na barra de ferramentas, clique em Menu de navegação e selecione APIs e serviços.

  2. No painel que lista todas as APIs, verifique se a API Cloud Trace está listada. Se a API Cloud Trace estiver listada na tabela, a API estará ativada. Prossiga para a próxima etapa numerada.

    Se a API Cloud Trace não estiver listada, a API não estará ativada. Para ativar a API Cloud Trace, clique em Ativar APIs e serviços e pesquise API Trace. Se você vir uma entrada para a API Cloud Trace, selecione-a. Caso contrário, selecione API Stackdriver Trace. Depois de selecionar a API, clique em Ativar.

  3. No painel que lista todas as APIs, se a linha da API Cloud Trace não listar valores numéricos para a coluna Solicitações, Erros ou para outras colunas, isso indicará que nenhuma solicitação de trace está chegando ao seu projeto do Google Cloud. Verifique seus aplicativos e proxies para garantir que eles estejam configurados para enviar os traces para o projeto correto.

  4. Para ver detalhes sobre o uso da API, clique em API Cloud Trace e em Métricas.

    Para restringir a origem dos erros, use os filtros Credenciais e Métodos e veja o efeito que suas seleções têm no gráfico Erros por método da API:

    • Se todas as gravações estiverem falhando, verifique se a conta de serviço tem acesso ao papel Agente do Cloud Trace. Esse papel inclui a permissão cloudtrace.traces.patch. Para mais informações, consulte papéis do IAM do Cloud Trace.

    • Se houver falha nas leituras, verifique se você tem acesso ao papel Usuário do Cloud Trace para este projeto do Google Cloud. Para ver uma lista completa de permissões para esse papel, consulte Papéis do IAM do Cloud Trace.

Falha no upload de períodos para o exportador do OpenCensus em Go.

Veja a seguir exemplos de erros que ocorrem quando a biblioteca do bundler usada pelo exportador não pode gerenciar o número de períodos que o aplicativo gera e faz upload:

OpenCensus Stackdriver exporter: failed to upload span: buffer full
OpenCensus Stackdriver exporter: failed to upload 183 spans: buffer full

Para resolver essa situação, tente uma ou mais das seguintes opções:

  • Na estrutura Options passada para o construtor traceExporter, aumente o valor do campo TraceSpansBufferMaxBytes. Esse campo opcional especifica o número máximo de bytes usados para períodos de armazenamento em buffer. O valor padrão é 8 MB.

  • No objeto Options passado para o construtor traceExporter, diminua os valores para os seguintes campos:

    • BundleDelayThreshold: este campo opcional especifica o tempo máximo que o exportador pode aguardar antes do upload de períodos de trace. O valor padrão desse campo é de dois segundos.

    • BundleCountThreshold: este campo opcional especifica o número de períodos que podem ser armazenados em buffer. O valor padrão deste campo é 50.

  • Exportar menos períodos. Para reduzir o número de períodos exportados, configure um sampler global ou transmita um exemplo para cada StartSpan. Para o código de amostra e mais informações sobre essas configurações, consulte Amostragem do OpenCensus (em inglês).