Skip to main content
Suponha que uma loja online registre uma entrada de log toda vez que um cliente faça uma busca no catálogo. Uma única entrada descreve uma busca, mas o número de entradas ao longo do tempo pode revelar mudanças mais amplas. Se a atividade de busca cair enquanto o tráfego geral da loja permanece estável, isso pode indicar que os clientes não conseguem acessar ou usar o recurso de busca. O AppSignal pode extrair dados de métrica das linhas de log correspondentes antes de descartá-las. A métrica permanece disponível para dashboards e triggers, mas o AppSignal não armazena as linhas correspondentes. Ative Drop log line after metric extraction ao criar ou editar uma métrica baseada em logs. O AppSignal configura o descarte para você. Você também pode criar as actions subjacentes pelo AppSignal MCP, conforme descrito no fluxo de processamento de logs.

​
Como funciona

Quando uma nova linha de log corresponde a uma métrica baseada em logs salva, o AppSignal extrai os dados de métrica antes de descartar a linha. A métrica permanece disponível para dashboards e triggers, mas a linha de log correspondente não é armazenada. O toggle cria um filter associado logo após a action metrics, usando a mesma consulta e as mesmas fontes de log. Quando você edita a métrica na interface do AppSignal, o AppSignal também atualiza o filter. Desativar o toggle ou excluir a métrica remove o filter associado.
Essa configuração se aplica apenas a logs recebidos depois que ela entra em vigor. Ela não remove logs que o AppSignal já armazenou.
O Data preview no formulário da métrica e a página Logs usam dados de log armazenados. Eles ainda podem mostrar linhas correspondentes anteriores, mas não incluem linhas descartadas após a extração da métrica. Use um dashboard para confirmar que a métrica salva está recebendo novos dados.

​
Antes de começar

  • Uma fonte de log que recebe as linhas que você quer medir
  • Uma consulta que corresponda a essas linhas
  • Para a rota MCP, AppSignal MCP configurado no seu agente de IA, com acesso de escrita às ferramentas de logging

​
Ative pelo toggle

  1. Na página Logs, filtre as linhas que você quer medir e abra uma delas.
  2. Na seção Actions, selecione Create a metric.
  3. Nomeie a métrica, escolha seu tipo e verifique o Data preview. Ative Drop log line after metric extraction, confirme com Drop log lines e selecione Create metric.
Antes de ativar o descarte, use o Data preview para confirmar que a consulta corresponde apenas às linhas que você pretende descartar.
Você também pode ativar essa configuração para uma métrica existente:
  1. Abra a página Metrics no menu lateral Logging.
  2. Abra o menu de três pontos da métrica e selecione Edit.
  3. Ative Drop log line after metric extraction, confirme com Drop log lines e selecione Update metric.
O menu de três pontos também contém as actions Add to dashboard, Create trigger e Delete. A métrica agora mostra Drop after match na coluna Action da página Metrics.

​
Configure pelo AppSignal MCP

A ferramenta MCP não expõe o toggle da interface. Em vez disso, seu agente cria duas actions independentes: uma action metrics seguida de um filter com a mesma consulta e as mesmas fontes de log. Como as actions não estão vinculadas, atualize as duas se depois você alterar a consulta ou as fontes. O AppSignal processa as log line actions em ordem. Um filter impede que uma linha correspondente alcance actions posteriores, portanto a action metrics precisa ser executada antes do filter.

​
Passo 1: Registrar uma métrica a partir das linhas

Peça ao seu agente que adicione uma action metrics. Por exemplo, para contar com que frequência os clientes fazem buscas no seu catálogo:
No MyStore production, adicione uma log line action metrics que conte as linhas de log correspondentes a message:"Type your message here" como um counter chamado log.catalog_searches, limitado à fonte de log da aplicação.
Seu agente pode chamar manage_log_line_action com:
Para detalhes sobre esses campos, veja a referência de manage_log_line_action.

​
Passo 2: Verifique a métrica antes de descartar qualquer coisa

Depois que o AppSignal receber linhas correspondentes, releia a métrica:
Mostre-me o counter log.catalog_searches do MyStore production nos últimos 15 minutos.
Confirme que o counter está registrando e que a consulta corresponde apenas às linhas que você pretende descartar. O AppSignal não armazena linhas descartadas, portanto você não pode recuperá-las do AppSignal.

​
Passo 3: Descartar as linhas correspondentes

Adicione uma action filter com a mesma consulta:
No MyStore production, adicione uma log line action filter que descarte as linhas de log correspondentes a message:"Type your message here".

​
Passo 4: Mantenha a action metrics antes do filter

Novas actions são adicionadas ao final da ordem, portanto o filter já roda depois da action metrics. Confirme a ordem:
Liste as log line actions do MyStore production e mantenha a action metrics antes do filter.
Seu agente pode usar get_app_resources para ler a ordem, e então chamar manage_log_line_action com action: "reorder" se o filter estiver antes da action metrics. Se o filter rodasse primeiro, ele descartaria as linhas antes que a action metrics as contasse.

​
Verifique que está funcionando

Depois que o AppSignal aplicar as actions e receber novas linhas correspondentes, verifique o resultado:
  1. Leia a métrica e confirme que ela contém dados de novas linhas correspondentes.
  2. Pesquise seus logs com a mesma consulta. Linhas recebidas depois que o filter entrou em vigor não devem aparecer.
Se a métrica não tiver novos dados, ou se linhas correspondentes continuarem aparecendo, verifique a consulta e a ordem das actions. Depois tente novamente com novas linhas de log.

​
Comportamento e limitações

  • As actions não são retroativas. Logs armazenados antes de você criar a action permanecem como estão.
  • Edições na interface mantêm as actions associadas alinhadas. Editar a métrica na interface do AppSignal atualiza o filter associado. Excluir o filter pelo MCP mantém a métrica e desativa o descarte.
  • Actions criadas pelo MCP são independentes. Para medir e descartar as mesmas linhas, dê às duas actions a mesma consulta e as mesmas fontes de log, e atualize as duas quando a configuração delas mudar.