PHP项目告警汇总如何区分不同服务异常

本文目录导读：

1. 核心：服务标识（Service Identity）
2. 异常捕获与标记（在入口或中间件）
3. 告警数据路由与存储（区分的关键）
4. 告警发送与通知（按服务配置不同通道）
5. 聚合与去重：按服务+异常类型分组
6. 高级：分布式追踪（区分调用链中的服务）
7. 最小可行方案清单

在 PHP 项目中，要区分 不同服务 的异常告警，核心思路是：为每个服务/模块打上唯一的标识（标签/元数据），并在告警系统中基于这些标签进行路由、分组和展示。

以下是具体的实现方案,分为几个关键层面：

核心：服务标识（Service Identity）

你的PHP应用必须知道“我是谁”,这需要在应用启动时初始化一个全局上下文。

方案 A：环境变量（推荐用于K8s/Docker）

// config/app.php 或 bootstrap.php
define('SERVICE_NAME', getenv('SERVICE_NAME') ?: 'unknown-service');
define('SERVICE_ENV', getenv('APP_ENV') ?: 'production'); // dev, staging, prod
define('SERVICE_INSTANCE', gethostname()); // 或容器ID

方案 B：配置文件（适用于传统服务器集群）

// config/services.php
return [
    'user_service' => [
        'name' => 'user-service',
        'hosts' => ['192.168.1.10', '192.168.1.11'],
    ],
    'order_service' => [
        'name' => 'order-service',
        'hosts' => ['192.168.2.20'],
    ],
];
// 启动时根据IP或主机名匹配
$host = gethostname();
// 遍历配置匹配

异常捕获与标记（在入口或中间件）

在 PHP 的异常处理中心（如 Laravel 的 App\Exceptions\Handler、框架中间件或全局 set_exception_handler 中），将 服务标识 附加到告警数据包中。

// Laravel 异常处理 Handler
public function report(Throwable $e)
{
    // 构造告警上下文
    $alertData = [
        'title'       => get_class($e) . ': ' . $e->getMessage(),
        'service'     => SERVICE_NAME,          // 关键字段：服务名
        'environment' => SERVICE_ENV,
        'instance'    => SERVICE_INSTANCE,
        'exception'   => [
            'file'     => $e->getFile(),
            'line'     => $e->getLine(),
            'trace'    => $e->getTraceAsString(),
        ],
        'request'     => [
            'url'    => request()->fullUrl(),
            'method' => request()->method(),
            'ip'     => request()->ip(),
        ],
        'timestamp'   => now()->toIso8601String(),
    ];
    // 发送到告警系统（下文详述）
    AlertService::send($alertData);
}

告警数据路由与存储（区分的关键）

告警不能只存成一条字符串，必须结构化存储，你需要一个能够 按字段查询 的存储后端,而不是简单写入日志文件。

方案 A：使用专业的 APM/错误跟踪平台（推荐）

这些平台天然支持按服务名、环境、主机等标签过滤。

• Sentry：设置 release 或 tags

  \Sentry\configureScope(function (\Sentry\State\Scope $scope): void {
      $scope->setTag('service', SERVICE_NAME);
      $scope->setTag('env', SERVICE_ENV);
      $scope->setUser(['id' => auth()->id() ?? 'anonymous']);
  });

  结果：在 Sentry Dashboard 中可以直接选择 “service: user-service” 查看其所有异常。

• Laravel Telescope / Flare：通过上下文数据区分。

// 查询 user-service 的错误
GET /alerts-*/_search
{
  "query": {
    "bool": {
      "filter": [
        { "term": { "service": "user-service" } },
        { "term": { "environment": "production" } }
      ]
    }
  }
}

SELECT 
    service, 
    exception_class, 
    COUNT(*) as count, 
    MAX(created_at) as last_occurrence
FROM alerts 
WHERE created_at > NOW() - INTERVAL 24 HOUR
GROUP BY service, exception_class;

【用户服务 - UserService】
- 500 Error (10次) | 最后触发: 10:23
- PDOException (3次) | 最后触发: 09:15
【订单服务 - OrderService】
- LogicException (7次) | 最后触发: 11:00
- RuntimeException (2次) | 最后触发: 08:30

$span = OpenTelemetry::getCurrentSpan();
$alertData['trace_id'] = $span->getContext()->getTraceId();
$alertData['span_id'] = $span->getContext()->getSpanId();
$alertData['parent_service'] = $span->getAttributes()->get('service.name');