turbo124 / beacon

用于Laravel的应用层数据收集包

v2.0.2 2024-06-27 01:23 UTC

README

Latest Version on Packagist Total Downloads

此收集器实现了针对收集应用程序统计数据的原生Laravel解决方案。目前,为了启用此类功能,您需要将Node和StatsD安装到您的服务器上,然后开始管道传输数据。接下来,您需要安装第三方应用程序来接收数据并显示。

此客户端是LightLogs应用程序框架的一部分,该框架允许从单个开源应用程序中接收和显示。

安装

您可以通过composer安装此包

composer require turbo124/beacon

用法

发送指标默认方法是通过创建一个静态属性类(见 /src/ExampleMetric/GenericCounter)并构建如下collect

LightLogs::create(new GenericCounter())
        ->increment()
        ->batch();

这将批量处理指标请求,并有一个底层的调度作业每5分钟处理一次所有指标(请注意,您需要运行Laravel调度器以便分发这些作业)。

由于延迟开销,不建议在生产环境中执行此操作,但如果您的指标需要立即触发,您可以使用以下同步方式。

LightLogs::create(new GenericCounter())
        ->increment()
        ->send();

处理需要立即触发而不阻塞的作业的更好方式是使用 ->queue() 方法,这将向应用程序的队列发送一个作业

LightLogs::create(new GenericCounter())
        ->increment()
        ->queue();

测试

composer test

变更日志

请参阅变更日志获取最近更改的更多信息。

贡献

请参阅贡献指南以获取详细信息。

安全性

如果您发现任何安全相关的问题,请通过电子邮件[email protected]联系,而不是使用问题跟踪器。

致谢

许可协议

MIT许可协议(MIT)。有关更多信息,请参阅许可文件