> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appsignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# AppSignal Logging

Ter acesso rápido aos logs da sua aplicação é crucial para solucionar problemas e avaliar a saúde de vários componentes, do seu banco de dados à sua fila de mensageria.

O AppSignal Logging consolida os logs da sua aplicação, permitindo armazená-los, visualizá-los e consultá-los, oferecendo insights mais profundos sobre o desempenho e o comportamento da sua aplicação. Se você precisar armazenar logs por períodos longos de retenção, pode exportá-los para uma solução de armazenamento compatível com S3 usando o [add-on Long-Term Log Storage](#log-retention).

### O AppSignal Logging ajuda a responder perguntas como

<div style={{ display: "flex", flexDirection: "column", gap: "0.6rem", marginTop: "1rem", marginBottom: "1.25rem" }}>
  {[
      "Quais erros estão aparecendo nos meus logs e onde eles são disparados?",
      "Qual código no meu app está fazendo a performance cair?",
      "Qual é o caminho de uma requisição antes e depois de encontrar um problema?",
      "Quais são os níveis de severidade dos logs do meu app?",
      "Como minha aplicação está performando durante incidentes de performance?"
    ].map((label) => (
      <div key={label} style={{ display: "flex", alignItems: "center", gap: "0.6rem" }}>
        <span style={{
          display: "inline-flex",
          alignItems: "center",
          justifyContent: "center",
          width: "1.4rem",
          height: "1.4rem",
          borderRadius: "0.35rem",
          background: "rgba(34,197,94,0.15)",
          color: "#16a34a",
          fontWeight: 700,
          fontSize: "0.85rem",
          lineHeight: 1,
        }}>✓</span>
        <span>{label}</span>
      </div>
    ))}
</div>

## Começando

Nossa documentação cobre tudo o que você precisa saber para colocar o AppSignal Logging em funcionamento na sua aplicação.

* [Como configurar o logging](/logging/configuration)
* [Como gerenciar seus logs](/logging/log-management)
* [Como consultar seus logs](/logging/query-syntax)
* [Como exportar seus logs com Long-term Log Storage](/logging/long-term-log-storage)
* [Como criar e gerenciar triggers](/logging/triggers)
* [Como solucionar problemas](/logging/troubleshooting)

## Integrações suportadas do AppSignal

As integrações do AppSignal a seguir contam com suporte nativo ao AppSignal Logging:

* [Ruby](/logging/integrations/ruby)
* [Elixir](/logging/integrations/elixir)
* [Node.js](/logging/integrations/nodejs)
* [Go](/logging/integrations/go)
* [Java](/logging/integrations/java)
* [PHP](/logging/integrations/php)
* [Python](/logging/integrations/python)

## Boas práticas

Logar ou não logar, essa pode ser uma pergunta difícil de responder. Os melhores logs são descritivos, contextuais e concisos. Com o AppSignal, você pode aproveitar ao máximo seus logs usando recursos como [atributos personalizados](/logging/formatting), que permitem adicionar dados adicionais e filtráveis às suas linhas de log.

Você pode ler nosso [artigo no Learning Center sobre boas práticas de logging](https://www.appsignal.com/learning-center/what-logs-should-i-store) para mais informações sobre como utilizar corretamente os logs da sua aplicação.

## Retenção de logs

<Warning>
  🔐 Não envie <strong>Informações Pessoais Identificáveis (PII)</strong> para a AppSignal. Filtre PII (por exemplo, nomes, e-mails) dos logs e use um ID, hash ou identificador pseudonimizado no lugar. <br /> <br /> 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](/support/business-add-ons).
</Warning>

A retenção varia conforme o seu plano. Você encontra informações reais de retenção e preços em nossa [página de planos](https://www.appsignal.com/plans).

Se você precisar armazenar logs por períodos mais longos, pode exportá-los para uma solução de armazenamento compatível com S3 usando o [add-on Long-Term Log Storage](/support/business-add-ons#long-term-log-storage). Esse add-on permite reter seus logs além do período de 30 dias que o AppSignal normalmente armazena, dando a você mais controle sobre a retenção dos dados de log. Para instruções de configuração, acesse o [guia de configuração do Long-Term Log Storage](/logging/long-term-log-storage).

## Limitações

O AppSignal Logging complementa nossos recursos de APM capturando eventos importantes como queries lentas de banco de dados, atividade administrativa e chamadas externas de API. Porém, existem algumas limitações:

* Suportamos até **500 mil linhas de log por minuto por app**.
* As linhas de log podem ter até **10.000 caracteres**, com o excesso sendo truncado.
* Payloads JSON profundamente aninhados não são suportados.

Para monitoramento avançado e rastreamento de dados personalizados, recomendamos usar nossos recursos de [Erros](https://www.appsignal.com/tour/errors) e [Performance](https://www.appsignal.com/tour/performance), que são mais adequados a esses casos de uso.