newrelic_set_error_group_callback (PHP エージェント API)

構文

newrelic_set_error_group_callback($callback)

独自のカスタム定義のフィンガープリンティング コールバック関数を使用してエラーをグループ化します。

要件

エージェントのバージョン 10.12 以降。

説明

この API を使用すると、アプリケーションでエラーが発生したときに呼び出されるカスタム コールバック関数を PHP エージェントに登録できます。

コールバックはエージェントから 2 つの PHP 配列を提供します。1 つはトランザクション データを含み、もう 1 つはエラー データを含みます。

コールバックは、提供されたコンテキスト情報を使用して、エラー受信トレイ UI に表示されるエラー グループ名として機能するユーザー定義のロジックに基づいて空ではない文字列を返す必要があります。

パラメーター

この API は、単一の関数タイプのコールバックを引数として受け入れます。提供されたコールバックは 2 つのパラメータを受け入れる必要があります。

配列のキーと値のペア

$transaction_data - コールバックに提供される PHP エージェントのトランザクション データ

$error_data - コールバックに提供される PHP エージェントのエラー データ

戻り値

API はコールバックが正常に登録された場合はtrueを返し、それ以外の場合はfalseを返します。

例

if (extension_loaded('newrelic')) { // Ensure PHP agent is available
  $callback = function(array $transaction_data, array $error_data)
  {
      $fingerprint = "";

      //
      // Add custom code to parse array data
      //

      // Example code
      if ($error_data["klass"] == "E_USER_ERROR") {
        $fingerprint = "USER ERROR";
      };

      return $fingerprint;    // Non-empty string error group name
  };

  newrelic_set_error_group_callback($callback);
};