Pular para o conteúdo principal
🔐 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.
O endpoint HTTP é o endpoint mais flexível para enviar logs ao AppSignal. Você pode formatar a mensagem de várias maneiras, conforme descrito abaixo. Se você estiver usando uma linguagem que possui uma biblioteca de integração para o AppSignal, recomendamos usar uma das bibliotecas de integração em vez do endpoint HTTP. Se você estiver criando uma integração personalizada, recomendamos usar o endpoint HTTP-JSON para garantir que as mensagens sejam formatadas exatamente como pretendido.

​
Endpoint

Você pode fazer POST de logs para o AppSignal. Seus logs precisam estar formatados em JSON, Logfmt ou Plaintext e enviados para o seguinte endpoint:
Shell
https://appsignal-endpoint.net/logs?api_key=YOUR_LOG_SOURCE_API_KEY
Substitua YOUR_LOG_SOURCE_API_KEY pela chave fornecida ao criar uma fonte de log. Usaremos o horário em que nossos servidores recebem a requisição POST como timestamp do log. A severidade padrão será INFO. Você pode enviar os parâmetros hostname, severity e group/appname acrescentando-os à URL, por exemplo:
Shell
https://appsignal-endpoint.net/logs?group=app&hostname=frontend1&severity=debug&api_key=YOUR_LOG_SOURCE_API_KEY
Você pode enviar várias linhas de log separando cada linha de log com um caractere de quebra de linha: \n

​
Mensagens estruturadas

Para adicionar metadados a uma linha de log, você pode enviar uma mensagem estruturada.

​
Plaintext

Por padrão, a fonte é criada com o formatador Plaintext selecionado, e você pode enviar qualquer string como a parte da mensagem da linha de log, por exemplo: 
This is a log message
And this is another message
Resultará em duas linhas de log com as mensagens This is a log message e And this is another message, respectivamente.

​
Logfmt

Quando Logfmt é selecionado como formato de mensagem, você pode enviar uma linha de log com pares chave-valor separados por um espaço, por exemplo: 
This is a log message user_id=123 action=login
This is another log message user_id=123 action=logout
Resultará em duas linhas de log com as mensagens This is a log message e This is another log message, respectivamente, e com os seguintes atributos: 
{
  "user_id": 123,
  "action": "login"
}

{
  "user_id": 123,
  "action": "logout"
}

​
JSON

Quando JSON é selecionado como formato de mensagem, você pode enviar uma linha de log com um objeto JSON, por exemplo: 
{"message": "This is a log message", "user_id": 123, "action": "login"}
{"msg": "This is another log message", "user_id": 123, "action": "logout"}
Esperamos a chave msg ou message para a mensagem da linha de log, e quaisquer outras chaves serão adicionadas como atributos. Se nenhuma chave msg ou message for fornecida, usaremos o objeto JSON inteiro (sem parsing) como a mensagem. Os atributos ainda serão parseados e adicionados a essa linha. Você pode ler mais sobre as especificidades da formatação de mensagens em nossa documentação de formatação.