当前位置: 首页 > 工具软件 > PHP Sentry > 使用案例 >

PHP集成Sentry配置

拓拔骁
2023-12-01

存在几个允许您配置Raven_Client行为的选项。它们作为构造函数的第二个参数传递,并且应该是键值对的数组:

$client = new Raven_Client($dsn, array(
    'option_name' => 'value',
))

一、其他设置

以下设置可供客户端使用:

name

一个字符串,用于覆盖服务器主机名的默认值。 默认为Raven_Compat :: gethostname()。

tags

要在此上下文中应用于事件的标记数组。 

'tags' => array(
    'php_version' => phpversion(),
)
$client->tags_context(array(
    'php_version' => phpversion(),
));

 release

您的应用程序的版本(例如git SHA)

'release' => MyApp::getReleaseVersion(),
$client->setRelease(MyApp::getReleaseVersion());

environment

运行应用程序的环境。 

'environment' => 'production',
$client->setEnvironment('production');

app_path
应用程序代码的根路径。 

'app_path' => app_root(),
$client->setAppPath(app_root());

excluded_app_paths

要从app_path检测中排除的路径。

'excluded_app_paths' => array(app_root() . '/cache'),
$client->setExcludedAppPaths(array(app_root() . '/cache'));

 prefixes

应从文件名中剥离的前缀以创建相对路径。

'prefixes' => array(
    '/www/php/lib',
),
$client->setPrefixes(array(
    '/www/php/lib',
));

sample_rate

应用于事件的抽样因子。值0.00将拒绝发送任何事件,值为1.00将发送100%的事件。

// send 50% of events
'sample_rate' => 0.5,

send_callback

每当数据准备好发送时将调用的函数。在函数中,您可以改变数据,或者返回false以指示SDK不发送事件。

'send_callback' => function($data) {
    // strip HTTP data
    @unset($data['request']);
},
$client->setSendCallback(function($data) {
    // dont send events if POST
    if ($_SERVER['REQUEST_METHOD'] === 'POST')
    {
        return false;
    }
});

curl_method

默认为“同步”。

可用方法:

  • sync(默认值):当它们变为异步时立即发送请求:
  • async:使用curl_multi处理程序进行异步提交
  • exec:通过为每个项目分配curl进程异步发送事件

curl_path

默认为'curl'。

指定要与'exec'curl方法一起使用的curl二进制文件的路径。

transport

设置自定义传输以覆盖Sentry事件向上游发送的方式。

'transport' => function($client, $data) {
    $myHttpClient->send(array(
        'url'     => $client->getServerEndpoint(),
        'method'  => 'POST',
        'headers' => array(
            'Content-Encoding' => 'gzip',
            'Content-Type'     => 'application/octet-stream',
            'User-Agent'       => $client->getUserAgent(),
            'X-Sentry-Auth'    => $client->getAuthHeader(),
        ),
        'body'    => gzcompress(jsonEncode($data)),
    ))
},
$client->setTransport(...);

trace

将此设置为false可禁用stacktraces中的反射跟踪(函数调用参数)。

logger

调整消息的默认记录器名称。默认为php。

ca_cert

CA证书捆绑包的路径。

默认为包含getsentry.com的公共包:./ data / cacert.pem

注意事项:

  • 除非curl抛出表明需要证书的错误,否则将忽略CA捆绑包。
  • 该选项目前仅在同步卷曲传输中使用。

curl_ssl_version

要使用的SSL版本(2或3)。默认情况下,PHP会尝试自行确定,但在某些情况下,必须手动设置。

message_limit

默认为1024个字符。此值用于截断消息和帧变量。但是,不保证整个消息的长度将受此值的限制。

processors

在将数据发送到Sentry之前用于处理数据的类数组。默认情况下,使用Raven_Processor_SanitizeDataProcessor。

processorOptions

在将该处理器添加到Raven_Client使用的处理器列表之前,将传递给Raven_Processor子类中的setProcessorOptions()函数的选项

在Raven_Processor_SanitizeDataProcessor中覆盖正则表达式的示例如下:

'processorOptions' => array(
    'Raven_Processor_SanitizeDataProcessor' => array(
                'fields_re' => '/(user_password|user_token|user_secret)/i',
                'values_re' => '/^(?:\d[ -]*?){15,16}$/'
            )
)

timeout

以秒为单位向Sentry服务器发送请求的超时时间,默认为2秒。

'timeout' => 2,

excluded_exceptions

不应报告的异常,此列表中的异常扩展异常也将被排除,默认为空数组。

在下面的示例中,当您排除LogicException时,您还将排除BadFunctionCallException,因为它扩展了LogicException。

'excluded_exceptions' => array('LogicException'),

ignore_server_port

默认情况下,当服务器端口是非标准端口时,它将添加到已记录的URL(80,443)。将此设置为true将完全忽略服务器端口,并且将导致服务器端口永远不会附加到记录的URL。

'ignore_server_port' => true,

二、提供请求上下文

大多数时候你并没有直接向Raven打电话,但你仍然想提供一些额外的背景。此生命周期通常包含以下内容:

  • 通过中间件(例如登录用户)设置一些上下文
  • 在请求生命周期中发送包含任何事件的所有给定上下文
  • 清理上下文

提供请求上下文有三种主要方法:

// bind the logged in user
$client->user_context(array('email' => 'foo@example.com'));

// tag the request with something interesting
$client->tags_context(array('interesting' => 'yes'));

// provide a bit of additional context
$client->extra_context(array('happiness' => 'very'));

如果您在生命周期中执行其他请求,则还需要确保清理上下文(以重置其状态):

$client->context->clear();

 

 类似资料: