Logging do PHP

Esta documentação descreve como configurar o logging com o pacote AppSignal for PHP.

Configurar logging

🔐 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.

Você não precisa criar uma fonte de log para enviar logs da integração AppSignal for PHP. Uma fonte de log “application” será criada automaticamente. O pacote AppSignal for PHP utiliza os recursos de logging do OpenTelemetry para enviar logs ao AppSignal.

Laravel

Se você está usando o framework Laravel, o pacote AppSignal for PHP envia seus logs automaticamente ao AppSignal. Você não precisa configurar o Monolog diretamente.

Symfony

Se você está usando o framework Symfony, a maneira mais fácil de enviar logs ao AppSignal é usando o MonologBundle. Instale o pacote de auto-instrumentação do Monolog.

Shell

composer require open-telemetry/opentelemetry-logger-monolog

Adicione uma definição de serviço para 'appsignal.monolog.handler' que use a classe Appsignal\Integrations\Monolog\Handler.

config/services.yaml

services:
  # ... other services

  appsignal.monolog.handler:
    class: Appsignal\Integrations\Monolog\Handler
    factory: ['Appsignal\Integrations\Monolog\Handler', "withLevel"]
    arguments: ["info"] # configure log level that will reach AppSignal

Adicione appsignal.monolog.handler à pilha de handlers do Monolog.

config/packages/monolog.yaml

monolog:
  handlers:
    # other handlers

    appsignal:
      type: service
      id: appsignal.monolog.handler
      channels: ["app", "event"] # configure which channels to send to AppSignal

Monolog

O Monolog é a biblioteca de logging mais popular para PHP. Você pode usar o Monolog diretamente para enviar logs ao AppSignal. Instale o pacote de auto-instrumentação do Monolog.

Shell

composer require open-telemetry/opentelemetry-logger-monolog

Em seguida, adicione Appsignal\Integrations\Monolog\Handler à pilha de handlers do Monolog.

PHP

use Appsignal\Integrations\Monolog\Handler;
use Monolog\Logger;

$logger = new Logger('app');
$logger->pushHandler(Handler::withLevel('info'));

$logger->info('My log message');

Uso autônomo

Você também pode enviar logs com o logger autônomo usando o método helper log da classe base Appsignal. Esse método não exige configuração.

PHP

use Appsignal\Appsignal;
use Appsignal\Severity;

// Log a message
Appsignal::log(
	message: 'Log message line',
	severity: Severity::INFO,
	loggerName: 'my-app',
	attributes: [
		'customer_id' => $customer->id,
	],
);

Configure o Monolog com o handler do OpenTelemetry para enviar logs ao AppSignal:

PHP

use Appsignal\Integrations\Monolog\Handler;
use Monolog\Logger;

// Create Monolog logger with the AppSignal handler
$logger = new Logger('app', [Handler::withLevel('info')]);

Enviando logs

Monolog

Usando o Monolog, você pode definir o nível de severidade dos seus logs:

PHP

$logger->warning("Something's gone terribly wrong here");
$logger->info('User action completed successfully');
$logger->error('Database connection failed');

// using Laravel's Log facade
Log::warning("Something's gone terribly wrong here");
Log::info('User action completed successfully');
Log::error('Database connection failed');

Você pode definir atributos personalizados para enviar informações de log que podem ser usadas ao filtrar e consultar logs:

PHP

$logger->info('Generating invoice for customer', ['customer_id' => $customer->id]);

// using Laravel's Log facade
Log::info('Generating invoice for customer', ['customer_id' => $customer->id]);

Logger autônomo

Usando o logger autônomo, você pode definir o nível de severidade dos seus logs:

PHP

use Appsignal\Appsignal;
use Appsignal\Severity;

// Different severity levels
Appsignal::log(
	message: "Something's gone terribly wrong here",
	severity: Severity::WARN,
);

Appsignal::log(
	message: 'User action completed successfully',
	severity: Severity::INFO,
);

Appsignal::log(
	message: 'Database connection failed',
	severity: Severity::ERROR,
);

Você pode definir atributos personalizados para enviar informações de log que podem ser usadas ao filtrar e consultar logs:

PHP

use Appsignal\Appsignal;
use Appsignal\Severity;

function processInvoice($customer) {
	Appsignal::log(
		message: 'Generating invoice for customer',
		severity: Severity::INFO,
		attributes: ['customer_id' => $customer->id],
	);
}

Filtrando logs

Você pode consultar e filtrar pelo conteúdo da mensagem e pelos valores dos atributos dentro da ferramenta Log Management. Uma vez configurados, os atributos desejados serão enviados ao AppSignal como tags de log e poderão ser consultados na interface de logging do AppSignal.

Logging estruturado

O AppSignal oferece suporte a logging estruturado por padrão. Você pode enviar dados estruturados como atributos de log:

PHP

use Appsignal\Appsignal;
use Appsignal\Severity;

Appsignal::log(
	message: 'User action completed',
	severity: Severity::INFO,
    attributes: [
		'user_id' => $userId,
		'action' => 'purchase',
		'product_id' => $productId,
		'amount' => $amount,
		'currency' => 'USD'
	],
);

// or using Monolog
$logger->info('Generating invoice for customer', ['customer_id' => $customer->id]);

// or using Laravel's Log facade
Log::info('Generating invoice for customer', ['customer_id' => $customer->id]);

Você também pode configurar o AppSignal for PHP para ignorar linhas de log específicas usando a opção ignore_logs. Veja nosso guia Ignore Logs para saber mais.

Precisa de ajuda?

Depois de configurar sua aplicação PHP para enviar logs, os logs devem aparecer no AppSignal. Se você tiver dúvidas sobre este passo ou o AppSignal não estiver recebendo logs, você sempre pode entrar em contato para obter ajuda. Vamos te ajudar a voltar ao normal!

Configuração do aplicativo

Desempenho / rastreamento

Alertas

Detecção de anomalias

Erros

Monitoramento de uptime

Monitoramento de processos

Logs

Métricas & dashboards

Monitoramento de host

Configurar logging

Laravel

Symfony

Monolog

Uso autônomo

Enviando logs

Monolog

Logger autônomo

Filtrando logs

Logging estruturado

Precisa de ajuda?

​Configurar logging

​Laravel

​Symfony

​Monolog

​Uso autônomo

​Enviando logs

​Monolog

​Logger autônomo

​Filtrando logs

​Logging estruturado

​Precisa de ajuda?

Configurar logging

Laravel

Symfony

Monolog

Uso autônomo

Enviando logs

Monolog

Logger autônomo

Filtrando logs

Logging estruturado

Precisa de ajuda?