newrelic_set_error_group_callback(PHP 에이전트 API)

통사론

newrelic_set_error_group_callback($callback)

사용자 정의된 핑거프린팅 콜백 함수를 사용하여 오류를 그룹화합니다.

요구 사항

에이전트 버전 10.12 이상.

설명

이 API를 사용하면 사용자는 애플리케이션에 오류가 발생할 때 호출되는 PHP 에이전트에 사용자 정의 콜백 함수를 등록할 수 있습니다.

콜백은 에이전트로부터 두 개의 PHP 배열을 제공합니다. 하나는 트랜잭션 데이터를 포함하고 다른 하나는 오류 데이터를 포함합니다.

제공된 컨텍스트 정보를 사용하여 콜백은 오류 받은 편지함 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);
};