This feature requires{" "}
{v.name} version {v.version}
{getBoundText(v.bound)}.
)}
;
};
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](/support/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`](https://github.com/symfony/monolog-bundle).
Instale o pacote de auto-instrumentação do Monolog.
```shell Shell theme={null}
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`.
```yml title="config/services.yaml" theme={null}
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.
```yml title="config/packages/monolog.yaml" theme={null}
monolog:
handlers:
# other handlers
appsignal:
type: service
id: appsignal.monolog.handler
channels: ["app", "event"] # configure which channels to send to AppSignal
```
### Monolog
O [Monolog](https://github.com/Seldaek/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 Shell theme={null}
composer require open-telemetry/opentelemetry-logger-monolog
```
Em seguida, adicione `Appsignal\Integrations\Monolog\Handler` à pilha de handlers do Monolog.
```php PHP theme={null}
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 PHP theme={null}
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 PHP theme={null}
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 PHP theme={null}
$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 PHP theme={null}
$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 PHP theme={null}
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 PHP theme={null}
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](/logging/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 PHP theme={null}
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`](/php/configuration#option-ignore_logs). Veja [nosso guia Ignore Logs](/guides/filter-data/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](mailto:support@appsignal.com) para obter ajuda. Vamos te ajudar a voltar ao normal!