Pular para o conteúdo principal
Esta documentação vai te guiar por todos os passos necessários e informações adicionais ao adicionar uma nova fonte de log à sua aplicação.

​
Criando uma fonte de log

✨ Você não precisa criar uma fonte de log ao enviar logs diretamente de uma integração AppSignal. Uma fonte de log será criada automaticamente para você. Siga as instruções para logging a partir de integrações AppSignal.
Para enviar logs ao AppSignal, primeiro você precisa configurar suas fontes de log. Sua aplicação pode ter várias fontes de log, como um banco de dados ou um processo da aplicação. Você precisará fazer isso uma vez para cada fonte de log. Por exemplo, se você quiser enviar logs do MongoDB e do NGINX para o AppSignal, será necessário criar uma fonte para cada uma dessas integrações. Captura de tela da página de Fontes de Logging Para fazer isso, navegue até a página Logging na aplicação AppSignal e clique no botão Add log source no canto superior direito da página. Um pop-up aparecerá, solicitando que você nomeie sua fonte. É importante dar à sua fonte um nome descritivo como Redis ou MongoDB, para que você consiga consultar esses logs com sucesso no futuro. Formulário para adicionar nova fonte de log

​
Escolha sua plataforma

Você está configurando o logging para o Vercel? Existem alguns passos adicionais necessários ao criar uma fonte de log para o Vercel. Leia nossa documentação de Configuração do Vercel para instruções detalhadas de configuração.
Oferecemos suporte ao envio de logs para o AppSignal a partir de várias fontes e plataformas, e estamos trabalhando duro para adicionar suporte a mais. Você pode saber mais sobre as plataformas suportadas na seção Configuração de Plataforma desta documentação. Se sua plataforma não estiver listada, você pode enviar logs para um de nossos endpoints diretamente.

​
Escolha o formato da mensagem

🔐 Não envie Informações Pessoais Identificáveis (PII) para a AppSignal. Filtre PII (por exemplo, nomes, e-mails) dos logs e use um ID, hash ou identificador pseudonimizado no lugar.

Para entidades cobertas pela HIPAA, mais informações sobre como assinar um Business Associate Agreement (BAA) podem ser encontradas em nossa documentação de Business Add-Ons.
Algumas fontes são baseadas em uma integração de terceiros, onde você não tem controle sobre o formato da linha de log. Nesse caso, você pode escolher o formato da linha de log a partir do qual o AppSignal tentará extrair a message. Isso permite que você adicione estrutura às suas linhas de log, sem controlar o formato da linha de log ao redor. Por exemplo, se você usar a integração com o Netlify, que cuida do envio das linhas de log ao AppSignal em seu próprio formato, permitindo que extraiamos a hora e o hostname corretos, você pode escolher o formato de log json para adicionar atributos adicionais a uma linha de log. Quando oferecemos suporte para fazer o parsing da mensagem de log, suportamos estes formatos: Saiba mais sobre como formatar suas mensagens na Documentação de Formatação.

​
Criar fonte

Assim que você tiver escolhido o nome e o formato da sua nova fonte criada, ela será listada na tabela de Fontes de Log na página de Logs, junto com uma chave de API gerada. Captura de tela da tabela de Fontes de Log destacando a chave de API Agora você precisará configurar sua aplicação para enviar logs ao AppSignal usando uma das plataformas que oferecemos suporte.

​
Configuração de plataforma

Depois de criar uma nova fonte, você precisará configurar sua aplicação para enviar logs ao AppSignal. Isso deve ser feito por meio da mesma plataforma que você definiu ao criar sua fonte de log.

​
Plataformas de logging suportadas

​
Endpoints de logging suportados

​
Concluindo a configuração

Como o AppSignal só armazena logs enviados a ele pela sua aplicação, você só conseguirá ver logs criados depois de ter concluído a configuração.
Depois de configurar a plataforma escolhida, você poderá visualizar e consultar seus logs na página All logs da aplicação AppSignal. Há mais informações sobre como gerenciar, visualizar e consultar seus logs no próximo passo deste guia. Captura de tela de log expandido

​
Adicionando armazenamento de longo prazo

Você pode configurar uma fonte para armazenar logs com seu próprio armazenamento seguro compatível com S3 usando o Armazenamento de Logs de Longo Prazo do AppSignal. Este recurso requer um Business Add-On pago. O AppSignal continuará retendo seus logs por 30 dias. Saiba mais em nossa documentação de Armazenamento de Logs de Longo Prazo.

​
Solução de problemas e suporte

Se você seguiu os passos acima e não consegue ver nenhum log no AppSignal, talvez queira ler nosso Guia de Solução de Problemas ou entrar em contato conosco para obter ajuda.