Skip to main content
Quer aproveitar ao máximo seus logs? Leia nosso artigo do Learning Center sobre melhores práticas de logging para mais informações sobre como utilizar adequadamente os logs da sua aplicação.
Os melhores tipos de logs são descritivos, contextuais e concisos. Os atributos permitem que você armazene, consulte e filtre rapidamente informações contextuais importantes dos logs da sua aplicação. Os atributos são suportados nos formatos de log Logfmt, JSON e NDJSON.

​
Formatação

O AppSignal fará o parsing dos logs recebidos da sua fonte com base em pares chave-valor, armazenando cada chave e valor como atributos na linha de log, permitindo que você filtre linhas de log por esses atributos. Formatando atributos com:

​
Logfmt

Em Logfmt, atributos podem ser adicionados às linhas de log:
Text
Por exemplo, a linha de log acima será parseada em uma linha de log com a mensagem "I am a message" e os seguintes atributos:
Leia mais sobre formatação de logs Logfmt.

​
JSON e NDJSON

Em JSON, atributos podem ser adicionados em um hash sob a chave attributes:
Text
Por exemplo, a linha de log acima será parseada em uma linha de log com a mensagem "This is a test message" e os seguintes atributos:
Leia mais sobre formatação de logs JSON/NDJSON.

​
Consultando atributos no AppSignal

No AppSignal, você pode pesquisar logs que correspondam a condições específicas de atributos. Por exemplo, a consulta a seguir retornaria todos os logs com um atributo article_id que contém o valor 7:
Text
Leia nossa documentação de gerenciamento de logs para uma explicação completa da nossa sintaxe de busca de logging. Quando um log é expandido, os atributos serão listados abaixo da mensagem de log: Linha de log expandida com tabela de atributos

​
Regras de formatação

Os valores de atributos podem ser de qualquer um dos seguintes tipos:
  • string
  • integer (por exemplo, 10)
  • double (por exemplo, 10.01)
  • boolean (true/false)
As chaves de atributos devem seguir as seguintes regras:
  • As chaves devem ser alfanuméricas.
  • As chaves não podem conter espaços, mas podem conter pontos finais (.), sublinhados (_) e hifens (-).
  • As chaves não podem conter mais de 50 caracteres
  • Os valores não devem ter mais de 255 caracteres
  • Não mais que 25 atributos por mensagem de log.
Caso as chaves e valores dos atributos não sigam as regras acima, o seguinte comportamento pode ser esperado:
  • Se uma chave não tiver um valor, ela será anexada ao campo da mensagem.
  • Se um par chave-valor tiver uma chave com o nome msg ou message, o valor dessa chave será parseado como a mensagem de log.
  • Se nenhuma chave message/msg estiver disponível, a linha de log inteira será considerada a mensagem.