google/cloud-error-reporting

Stackdriver Error Reporting 客户端 for PHP

v0.22.7 2024-07-26 21:41 UTC

README

Stackdriver Error Reporting 的 PHP 语法化客户端。

Latest Stable Version Packagist

注意:此存储库是Google Cloud PHP的一部分。任何支持请求、错误报告或开发贡献应指向该项目。

Stackdriver Error Reporting 对运行中的云服务中的崩溃进行计数、分析和汇总。

安装

首先,安装 PHP 偏好的依赖管理器Composer

现在安装此组件

$ composer require google/cloud-error-reporting

此组件支持 HTTP/1.1 上的 REST 和 gRPC。为了利用 gRPC 提供的好处(如流式方法),请参阅我们的gRPC 安装指南

身份验证

有关更多关于身份验证客户端的信息,请参阅我们的身份验证指南。身份验证后,您就可以开始发送请求了。

示例

Stackdriver Error Reporting 客户端提供 API,允许您轻松配置应用程序以自动将错误和异常发送到 Stackdriver,或者手动报告和管理错误和统计信息。

从应用程序报告错误

require 'vendor/autoload.php';

use Google\Cloud\ErrorReporting\Bootstrap;
use Google\Cloud\Logging\LoggingClient;
use Google\Cloud\Core\Report\SimpleMetadataProvider;

$projectId = '[PROJECT]';
$service = '[SERVICE_NAME]';
$version = '[APP_VERSION]';

$logging = new LoggingClient();
$metadata = new SimpleMetadataProvider([], $projectId, $service, $version);
$psrLogger = $logging->psrLogger('error-log', [
    'metadataProvider' => $metadata
]);

// Register the logger as a PHP exception and error handler.
// This will begin logging application exceptions and errors to Stackdriver.
Bootstrap::init($psrLogger);

使用 Error Reporting API

require 'vendor/autoload.php';

use Google\Cloud\ErrorReporting\V1beta1\ReportErrorsServiceClient;
use Google\Cloud\ErrorReporting\V1beta1\ReportedErrorEvent;

$reportErrorsServiceClient = new ReportErrorsServiceClient();
$formattedProjectName = $reportErrorsServiceClient->projectName('[PROJECT]');
$event = new ReportedErrorEvent();

try {
    $response = $reportErrorsServiceClient->reportErrorEvent($formattedProjectName, $event);
} finally {
    $reportErrorsServiceClient->close();
}

版本

此组件被视为测试版。因此,预计它将非常稳定,我们正在努力发布候选版本。我们将优先解决问题和请求。

下一步

  1. 了解官方文档
  2. 查看深入使用示例