taildev/php

tail.dev 的 PHP 集成

v0.6.3 2021-11-09 17:35 UTC

README

PHP tests

关于 Laravel 集成,请参阅 taildev/laravel

文档

查看完整文档 tail.dev/documentation/php/get-started

快速入门

使用 Composer 安装 taildev/php

composer require taildev/php

确保您的项目中的某处已要求 composer 自动加载器

require __DIR__ . '/vendor/autoload.php';

APM

使用您的 身份验证令牌 和服务名称(您想用来识别此服务的任何名称)初始化 APM

use Tail\Apm;

Apm::init('secret_token', 'service-name');
Apm::startRequest(); 

register_shutdown_function(function () {
    Apm::finish();
});

或者您可以使用 startJob($name) 用于后台作业、CLI 命令等或 startCustom($name)

向事务添加跨度

$span = Apm::newDatabaseSpan('fetch-config');
// ... code fetching config
$span->finish();

“跨度类型”用于对操作进行分类。

Apm::newSpan(string $type, string $name); // to use your own custom type
Apm::newCustomSpan($name); // type = "custom"
Apm::newDatabaseSpan($name); // type = "database"
Apm::newCacheSpan($name); // type = "cache"
Apm::newFilesystemSpan($name); // type = "filesystem"

日志

使用您的 身份验证令牌 初始化日志。如果您愿意,可以提供服务名称和环境

use Tail\Log;

Log::init('secret_token', 'optional-service-name', 'optional-environment');

您现在可以在任何地方使用记录器来记录消息

use Tail\Log;

Log::get()->debug('my debug message');

Log::get()->alert('something went wrong', ['custom_tag' => 'some-value']);

更多

有关完整文档,请参阅 tail.dev/documentation/php/get-started