Skip to main content
Os comandos logs trazem os logs da sua aplicação para o terminal: acompanhe-os à medida que chegam, pesquise em uma janela de tempo e gerencie as métricas derivadas de logs e gatilhos baseados em logs construídos a partir deles.

Opções comuns

Cada comando logs identifica uma aplicação e usa sua organização padrão, a menos que você indique o contrário:

Acompanhar logs

Faça streaming das linhas de log à medida que chegam (a CLI consulta a cada segundo):
Shell

Pesquisar logs

Pesquise linhas de log passadas e imprima as correspondências. Por exemplo, encontre linhas recentes de nível de erro:
Shell
Por padrão, search retorna até 100 das correspondências mais recentes. Além das opções e filtros comuns, ele adiciona: Para obter todas as linhas em uma janela como JSON, para um script ou agente:
Shell

Filtros

tail e search compartilham estes filtros: Liste as visualizações disponíveis para uma aplicação com appsignal-cli logs views, depois passe uma para --view por nome ou ID. --query e --source-ids substituem os valores salvos da visualização, e --severities restringe ainda mais a consulta da visualização. Por exemplo, aplique uma visualização mas restrinja-a a linhas críticas:
Shell

Sintaxe de consulta

A flag --query usa a sintaxe de consulta de log do AppSignal. Padrões comuns:
  • severity=error: correspondência exata de campo
  • message:timeout: a mensagem contém “timeout”
  • group=notifiers: correspondência exata de grupo
  • hostname:web-1: o hostname contém “web-1”
  • Termos separados por espaço combinam com AND; use OR para alternativas
Colchetes têm significado especial no analisador, então use aspas para correspondê-los literalmente: message:"[Email]".

Metadados estruturados

tail e search incluem os metadados estruturados de cada linha de log, como um ID da requisição ou ID do usuário:
  • A saída legível por humanos adiciona os campos ao final da linha como [key=value ...].
  • A saída JSON os coloca em um objeto json em cada linha, e cada valor mantém seu tipo JSON. Metadados que um logger envia como texto simples aparecem sob uma chave raw.
Use a saída JSON quando um script ou agente precisar ler os metadados. Você também pode filtrar por campos de metadados em --query, incluindo campos aninhados escritos com pontos. Veja atributos aninhados na referência de sintaxe de consulta.
Shell

Visualizações e fontes salvas

Liste as visualizações de log salvas de uma aplicação (predefinições de filtro) e suas fontes de log:
Shell
Passe o nome ou ID de uma visualização para --view, e o ID de uma fonte para --source-ids.

Métricas derivadas de logs

logs metrics transforma linhas de log correspondentes em métricas, com list, create, update e delete:
Shell
create e update compartilham estas flags (create requer --name, --query e pelo menos um --metric): update pode receber as seguintes flags adicionais. As flags --clear-* esvaziam campos em vez de atualizá-los. delete aceita apenas --id.
Uma métrica derivada de log só começa a coletar dados depois de ser limitada a uma fonte de log, então passe --source-id (encontre IDs com appsignal-cli logs sources). A CLI não pode definir o filtro de severidade de uma métrica; se sua métrica precisar de um, defina o campo Severity na UI do app AppSignal após criá-la.

Gatilhos baseados em logs

logs triggers alerta sobre linhas de log correspondentes, com list, create, update e delete:
Shell
create e update compartilham estas flags (create requer --name e --query): update pode receber as seguintes flags adicionais. As flags --clear-* esvaziam campos em vez de atualizá-los. delete aceita apenas --id.
Estes são gatilhos baseados em logs, construídos a partir de linhas de log. Para gatilhos de Anomaly detection em métricas, veja Gatilhos.

Próximos passos

Encontrou algo nos logs? Abra os incidentes relacionados, ou configure gatilhos de Anomaly detection.