README

将 NewRelic PHP Agent API 集成到 Silex 框架中。

致谢

此项目最初由 mcuadros 创建。感谢他的辛勤工作。

要求

• PHP 5.3.x
• intouch/newrelic
• newrelic >= 3.1

版本

该项目最近易手。有关如何要求正确的依赖项的信息，请参阅以下更新版本。

• v0.1.0 - 原始仓库状态使用 NewRelic PHP Agent 旧版本支持的 ini 设置
• v1.0.0 - 移除了 ini 设置，并使用更直接的 Intouch/NewRelic 库钩子替换

安装

推荐通过 composer 安装 NewRelic/Silex。您可以在 Packagist 上查看 包信息。

运行 composer require 获取最新版本

composer require stikmanw/silex-newrelic

方法

• newrelic.custom_parameter ( string $key, $value ): 通过 NewRelic Agent 捕获请求的自定义参数。详细信息: NewRelic custom_parameter
• newrelic.custom_metric (string $name, mixed $value): 将指标名称和值分配给 NewRelic Agent 捕获。详细信息: NewRelic custom_metric

参数

在数组 $app['newrelic.options'] 中设置所有参数

• application_name (默认 'Silex PHP Application'): 将应用程序的名称设置为 name。
• transaction_name_method (默认 'uri'): 如果为 'uri'，则将请求 URI 用作事务名称，如果为 'route'，则使用路由的别名名称。
• transaction_tracer_detail (默认 1): 在 newrelic.transaction_tracer.detail 处进行检查 1.0.0 不支持
• capture_params (默认 false): 确定是否应该捕获 NewRelic 文档中指定的参数。 newrelic.capture_params
• ignored_params (默认 ''): 在 newrelic.ignored_params 处进行检查 1.0.0 不支持
• disable_auto_rum (默认 false): 防止输出过滤器尝试为当前事务插入 RUM JavaScript。例如，对于 AJAX 调用很有用。
• ignored_transaction (默认 false): 不要将事务发送到代理进行跟踪。 1.0.0 新增 newrelic.ignored_params
• custom_params (默认数组)：分配给请求的自定义参数列表，参见上方的 custom_params 方法。 自 1.0.0 版本添加
• custom_metrics (默认数组)：在提供者注册时设置的自定义指标，参见上方的 custom_metrics 方法。 自 1.0.0 版本添加

注册

$app->register(new NewRelic\Silex\NewRelicServiceProvider());
$app['newrelic.options'] = array(
    'application_name' => 'Example PHP Application',
    'transaction_name_method' => 'route'
);

测试

测试位于 tests 文件夹中。要运行它们，您需要 PHPUnit。示例

$ phpunit --configuration phpunit.xml.dist

许可证

MIT，请参阅 LICENSE