Pular para o conteúdo principal
Quando uma requisição está lenta e você precisa ver para onde o tempo foi, comece pela página “Performance > Traces”. Essa página lista as actions para as quais o AppSignal armazenou traces. Selecione a action que deseja inspecionar e, em seguida, selecione um de seus traces armazenados em um horário específico. A página do trace mostra essa requisição, esse job ou essa tarefa registrada em detalhes: seus serviços, spans, metadados, erros e logs relacionados, e os outros traces da mesma action. Use a página para responder a três perguntas práticas:
  • Qual serviço ou span consumiu o tempo?
  • O trace produziu um erro, e onde ele começou?
  • Quais dados de requisição ou tags ajudam a explicar essa execução específica?
O cabeçalho mostra o nome da action e seu namespace, por exemplo run/shop.send_waitlist_notification em celery/background. As abas abaixo do cabeçalho alternam entre visões da mesma action: Summary, Traces, Charts e Logbook. Erros de navegador mostram a mesma linha do tempo do trace, o mesmo mapa de serviços e os mesmos logs relacionados em seu inspetor de erros.

Mapa de serviços

O mapa de serviços mostra o trace do ponto de vista dos serviços envolvidos: quais serviços a requisição alcançou, e quanto tempo cada chamada entre eles levou. O mapa de serviços aparece apenas quando um trace abrange dois ou mais serviços, por exemplo quando uma requisição chama outro serviço via HTTP ou enfileira um job em background. Uma requisição que permanece dentro de um único serviço não tem mapa.
  • Uma caixa por serviço, agrupada por service_name. Cada caixa é identificada com o nome do serviço e a aplicação do AppSignal para a qual ele reporta. Dentro dela, uma linha por chamada que o serviço tratou, de forma que um serviço chamado duas vezes no mesmo trace mostra duas linhas. Selecione uma linha para abrir a visão desse serviço sobre o trace.
  • Passe o cursor sobre uma linha para destacar sua cadeia de chamadas: as chamadas que levaram a ela e as chamadas que ela fez.
  • As arestas são as chamadas entre serviços, identificadas com sua duração e chegando na linha da action que chamaram.
  • Passe o cursor sobre um rótulo de duração ou foque nele para ver sua análise, quando a chamada gastou tempo fora do serviço chamado: a duração total, a duração dentro do serviço chamado e a latência entre os dois serviços.
  • A cor da aresta avalia cada chamada em relação à própria linha de base do trace, como rápida, lenta ou crítica, de forma que as chamadas mais lentas se destaquem sem que você precise ler cada duração. Uma aresta tracejada indica um trace vinculado, e uma caixa tracejada indica um serviço de outro trace.
  • Erros marcam o serviço em que ocorreram, não o serviço que o chamou.
Selecione Fullscreen para inspecionar todo o mapa e sua legenda.
Mapa de serviços em tela cheia de uma requisição de checkout passando pelos serviços gateway, pricing, catalog, payments, inventory, fulfillment, notifications, courier, e um trace ledger vinculado, com cada chamada identificada por duração e colorida por velocidade

O mapa de serviços do trace em tela cheia, mostrando os serviços em um trace, as chamadas entre eles e a legenda

Erros deste trace

Se o trace gerou incidentes de exceção, o AppSignal mostra uma tabela Errors from this trace acima da linha do tempo do trace. Use-a para abrir a visão de trace de erro desse incidente no mesmo trace, onde você pode inspecionar a mensagem de erro, o backtrace e as causas do erro.

Linha do tempo do trace

A linha do tempo detalha os spans do trace ao longo do tempo, do início do trace até seu fim. A posição de cada barra mostra quando um span começou, sua largura mostra por quanto tempo o span rodou, e sua cor mostra o grupo de spans ao qual ele pertence. Quando o AppSignal detecta um N+1, a linha do tempo marca o span repetido. A linha do tempo acompanha a operação através dos serviços. Cada serviço é identificado na linha do tempo, para que você veja onde um serviço passa o trabalho para o próximo. Quando o trace tem mais spans do que a pré-visualização mostra, selecione All spans na parte superior, ou o link more in the fullscreen overlay na parte inferior, para abrir a linha do tempo completa. A linha do tempo completa também se adapta a uma tela de celular. Nela, você pode:
  • Buscar spans por nome, atributo ou evento.
  • Filtrar por tipo de evento: errors, queries ou events.
  • Filtrar por grupo de spans, como servidor web, banco de dados e ORM, HTTP ou outro.
  • Filtrar por serviço, ou restringir a linha do tempo a uma parte da duração do trace.
  • Expandir e recolher spans aninhados. Um badge mostra quantos spans filhos um span tem, e um badge de repetição como x6 mostra com que frequência o mesmo span rodou, o que pode indicar um N+1.
  • Passar o cursor sobre um span para pré-visualizar seus detalhes, e selecioná-lo para mantê-los abertos.
  • Arrastar o divisor ao lado da coluna de spans para redimensioná-la, também em uma tela touchscreen. Rolar a coluna horizontalmente para ler nomes de spans longos.
Linha do tempo do trace em tela cheia mostrando spans dos serviços django, inventory e audit ao longo do tempo, com os filtros na parte superior e a query e os atributos do span SQL selecionado à direita

A linha do tempo do trace em tela cheia, com os filtros na parte superior e os detalhes do span selecionado à direita

Detalhes do span

O painel de detalhes nomeia o span e mostra seu tipo, como consumer, seu status, sua hora de início e sua duração. Três abas fornecem o restante:
  • Attributes: os atributos do span, como celery.task_name e messaging.destination, e os atributos de recurso, como host.name e service.name. Selecione Show internal attributes para listar também os atributos que o AppSignal adiciona. O ID do trace e o ID do span ficam visíveis somente enquanto Show internal attributes está selecionado.
  • Exceptions ou Events: os erros e outros eventos registrados no span. Um span que gerou um erro também mostra um resumo no topo do painel, com uma ação para ver a exceção.
  • Related logs: as linhas de log vinculadas ao span. Selecione View in logs para continuar no explorador de logs. A aba Related logs abre com seu escopo definido como This span, então ela busca apenas as linhas de log do span selecionado. Defina o escopo como Entire trace para ampliar a busca para todas as linhas de log vinculadas ao trace, em todos os seus spans e serviços.

Detalhamento do trace

O detalhamento do trace mostra para onde foi o tempo do trace, dividido pelas bibliotecas e pelo código que fez o trabalho, como active_record, http_rb ou sidekiq. A legenda lista cada uma com seu total, a maior primeiro. Alguns traces também podem mostrar uma barra de Allocations com quantos objetos cada uma alocou.

Detecção de N+1

Um N+1 acontece quando seu código executa a mesma operação em um loop, como uma página de carrinho que executa um SELECT por produto em vez de uma query para o carrinho inteiro. Cada chamada pode ser rápida, mas juntas elas deixam o trace mais lento. O AppSignal sinaliza um N+1 quando dois ou mais spans com o mesmo pai são idênticos, incluindo os spans aninhados dentro deles. Isso inclui queries de banco de dados repetidas e chamadas repetidas a outro serviço.
  • Performance > Traces: um badge N+1 marca as actions e os traces que contêm um N+1.
  • Linha do tempo do trace: o span repetido aparece uma vez, com um badge de repetição como x6. Selecione o badge para expandir o grupo. Selecione o span e abra a aba N+1 summary para ver quantas vezes ele rodou, sua duração total, sua participação no trace, a execução mais lenta e a mais rápida, e seus níveis de aninhamento quando o loop roda dentro de outro loop.
  • Mapa de serviços: quando um serviço é chamado em um loop e sua caixa não consegue mostrar cada chamada, ele agrupa o restante em uma linha +N more com um badge N+1.
Linha do tempo do trace de uma requisição GET cart/ na qual um span SELECT repetido sob calculate_total está destacado com um badge x2 e a dica "This span represents an N+1 group", com a query do span selecionado à direita e a aba N+1 summary ao lado de Attributes

Um N+1 na linha do tempo do trace: o span SELECT repetido tem um badge x2, e a aba N+1 summary fica ao lado dos seus atributos

Metadata

A seção Metadata mostra quando a subtrace selecionada ocorreu e então agrupa os metadados dessa subtrace em abas. Cada aba aparece apenas quando o AppSignal recebeu esse tipo de dado para a subtrace selecionada. Quando há tags presentes, a aba Tags aparece primeiro.
  • Tags: as tags do AppSignal na subtrace selecionada, mais sua revision quando presente, como hostname, queue, message_id e revision.
  • Request headers: os cabeçalhos HTTP que o AppSignal recebeu para essa subtrace.
  • Environment: outros valores de requisição que a integração reportou para essa subtrace. Dependendo da integração, valores semelhantes a cabeçalhos também podem aparecer aqui.
  • Request query parameters: os parâmetros de query string que o AppSignal recebeu para essa subtrace, quando disponíveis.
  • Request payload: o corpo da requisição que o AppSignal recebeu para essa subtrace, quando disponível.
  • Request session data: os valores de sessão que o AppSignal recebeu para essa subtrace, quando disponíveis.
  • Custom data e Function parameters: contexto extra que sua instrumentação adicionou para essa subtrace.
Cada tag tem duas ações:
  • Filter restringe a lista de Traces aos traces desta action que carregam o mesmo valor. O valor permanece visível acima da lista, e Reset o limpa.
  • Search abre uma visão geral de tudo que o AppSignal registrou com aquele valor. Você pode restringir a visão geral por app, namespace, período e tipo, de forma que veja apenas os erros ou apenas os traces de performance que o compartilham. Selecione Go to trace em qualquer resultado para abri-lo.
Duas tags também têm um link para uma página relacionada:
  • hostname tem View host metrics, que abre as métricas do host em torno do momento do trace. Em apps que enviam métricas do Kubernetes, aparece View pod metrics no lugar.
  • revision tem View deploy, que abre o deploy dessa revisão.
A lista Tags de um trace, com a dica View host metrics no ícone ao lado da tag hostname e a dica View deploy no ícone ao lado da tag revision.

As tags hostname e revision têm links para as métricas do host e para o deploy

Use a filtragem de cabeçalhos, a filtragem de parâmetros e a filtragem de dados de sessão para controlar quais valores de requisição sua aplicação envia. Para transformar um valor de tag em um link para sua própria aplicação, use os modelos de link. Para enviar mais tags da sua aplicação, veja tagging. A caixa Related logs em nível de trace mostra as linhas de log que o AppSignal conseguiu vincular a este trace, com seu horário, severidade e mensagem. Selecione Open in the log view para continuar no explorador de logs. O painel informa quando não encontra linhas de log relacionadas. O AppSignal vincula uma linha de log a um trace quando a linha de log carrega o request_id ou trace_id do trace como atributo, ou contém esse identificador em sua mensagem. O painel permanece vazio quando a operação não registrou nada, quando sua aplicação ainda não envia logs ao AppSignal, ou quando nenhuma linha de log carrega o identificador. Veja configurar logging para enviar logs, e vincular traces com logs para os identificadores. Se sua aplicação registra breadcrumbs do AppSignal como eventos appsignal.breadcrumb, a página os mostra em ordem cronológica em Breadcrumbs. Cada breadcrumb inclui seu horário, categoria, action e, quando presente, uma mensagem e metadados. Use-os para ver o que levou a esse trace sem sair da página. No topo da coluna direita, Perf. trends mostra a performance da action nas últimas 24 horas ou 30 dias. Para traces de performance, o gráfico plota o P90 e a duração média. Selecione 24H ou 30D para mudar o período, e depois selecione um ponto no gráfico para levar a lista de traces até esse momento.

Triggers

Triggers alertam você quando esta action fica lenta. O painel lista os triggers que já existem para a action, como Mean > 200 ms. Se ainda não houver nenhum, a caixa mostra No triggers yet e um link Add new. Selecione Add new para abrir o formulário de trigger com o namespace e o nome da action já preenchidos. No formulário, você:
  • Escolhe o valor a ser monitorado, como a média, e o limite acima do qual o AppSignal alerta, como 200 ms.
  • Define um warm-up e um cooldown de alerta em minutos.
  • Adiciona uma descrição para as pessoas que recebem o alerta.
  • Seleciona os notifiers que o recebem, como e-mail, Slack, PagerDuty ou OpsGenie.
Os triggers existentes também mostram se têm alertas abertos, quando dispararam pela última vez, e um menu para editar, duplicar ou excluir. Para saber como os alertas abrem, fecham e se repetem, veja anomaly detection e warm-up e cooldown.

Actions

A caixa Actions oferece dois tipos de acompanhamento:
  • Time detective: revise os dados da sua aplicação como estavam no momento do trace.
  • JSON and Markdown exports: baixe ou copie o trace em qualquer um dos formatos. A exportação em Markdown inclui o resumo do trace, os erros relacionados, a árvore de spans, o detalhamento, metadados compartilhados como dados de sessão e ambiente, breadcrumbs e contexto.

Traces

O painel Traces lista os outros traces armazenados para essa action, cada um com seu timestamp e duração. Selecione qualquer um deles para abrir esse trace. Para encontrar um trace específico:
  • Insira um valor no campo de filtro de tag, ou use a ação Filter em uma tag, para manter apenas os traces que carregam esse valor.
  • Abra o controle de data para escolher uma data e horário, ou escolha Today, Yesterday, Last week ou Latest. Selecione Jump to date ou Jump to latest para atualizar a lista.
  • Selecione Load newer traces ou Load older traces para navegar pela lista.
  • Selecione Reset para limpar os filtros e ver novamente todos os traces armazenados.
Um deploy marker entre dois traces mostra onde uma nova versão assumiu, o que ajuda você a comparar traces de antes e depois de um deploy.
O AppSignal não armazena um trace para cada requisição. Em vez disso, ele armazena um conjunto representativo, então a lista mostra uma amostra do tráfego da action.
Um link para um trace que não está mais disponível abre, em vez disso, o trace mais recente da action, sob um aviso Specific trace could not be found. Um link para o trace de um erro abre a ocorrência mais recente desse erro.

Logbook

O logbook reúne as notas da sua equipe sobre uma action, como o que você descobriu e o que você mudou. Os traces expiram, mas as notas ficam com a action, então a próxima pessoa que investigá-la não precisa começar do zero. Cada action tem um logbook, compartilhado por todos os seus traces. Para adicionar uma nota:
  1. Na página “Performance > Traces”, selecione a action.
  2. Na aba Summary, escreva sua nota na caixa de Logbook. As notas suportam Markdown.
  3. Selecione Post note.
Bom saber:
  • Selecione Full logbook, ou a aba Logbook, para ver todas as notas em uma página própria.
  • Fixe uma nota para mantê-la no topo. Fixar outra nota substitui a anterior.
  • Você só pode editar e excluir as suas próprias notas.
  • Este logbook contém apenas notas. Diferente do logbook de um incidente, ele não registra mudanças de estado nem vincula issues do GitHub.
  • Agentes podem adicionar notas com a ferramenta manage_note do MCP do AppSignal ou com a mutation createPerformanceTraceActionNote da API GraphQL.
Adicionar sua primeira nota também é uma side quest na página Discover AppSignal: Add your first logbook note. Depois de anotar uma correção, adicione um trigger no painel Triggers. O AppSignal então alerta você se a action ficar lenta novamente.