PHPです。コンテキストでのログの設定

Monolog に New Relic のログのコンテキストを設定する前に、Monolog ログエンリッチャーパッケージをインストールする必要があります。これは、Composer を使用して newrelic/monolog-enricher パッケージ をインストールすることで行います。

ほとんどの場合、Monologのビルトイン BufferHandler と合わせて、ログエンリッチャーパッケージが提供する Processor と Handler クラスを使用します。

• Processor は、New Relic のログがコンテクストで動作するために必要なコンテクストのメタデータを追加します。

• Handler は、ログレコードを New Relic Logs に送信します。

• BufferHandler は、できるだけオーバーヘッドを少なくしてログを配信するようにしています。

  Monolog\Logger オブジェクトを作成した時点で、以下の pushProcessor と pushHandler 呼び出しを追加して、 Processor と Handler を追加します。

  <?php
  
  use Monolog\Handler\BufferHandler;
  use Monolog\Logger;
  use NewRelic\Monolog\Enricher\{Handler, Processor};
  
  $log = new Logger('log');
  $log->pushProcessor(new Processor);
  $log->pushHandler(new BufferHandler(new Handler));

  コピー

  ヒント

  プロセッサー と ハンドラー は、既存のMonologのセットアップと組み合わせて使用することができます。既存のプロセッサーやハンドラーを削除する必要はありません。

Monolog を使用して互換性のあるログフォワーダーにログを送信し、そのツールが New Relic にログを送信するようにすでに設定されている場合は、そのツール専用の Processor および Formatter を使用することができます。このオプションは、 Handler を使ってログをNew Relicに直接送信する際の追加的なオーバーヘッドを防ぎます。

setFormatter() メソッドをサポートするハンドラーを使用する必要があります。また、ロギングツールがJSONログを取り込むことができる必要があります。

ここでは、Monologが他のログフォワーダーを扱うように設定する例を紹介します。

<?php

use Monolog\Handler\StreamHandler;
use Monolog\Logger;
use NewRelic\Monolog\Enricher\{Formatter, Processor};

$log = new Logger('log');
$log->pushProcessor(new Processor);

$handler = new StreamHandler('php://stderr');
$handler->setFormatter(new Formatter);
$log->pushHandler($handler);