PHP链路追踪框架SkyWalking怎么安装配置

目录

1. 简介
2. SkyWalking简介
3. 安装SkyWalking
   • 3.1 安装Java环境
   • 3.2 下载SkyWalking
   • 3.3 配置SkyWalking
4. PHP Agent的安装与配置
   • 4.1 安装PHP Agent
   • 4.2 配置PHP Agent
5. SkyWalking与PHP集成
   • 5.1 配置PHP项目
   • 5.2 启动SkyWalking
6. 验证与监控
   • 6.1 验证链路追踪
   • 6.2 监控与可视化
7. 常见问题与解决方案
8. 总结

简介

在现代分布式系统中，链路追踪（Tracing）是监控和诊断系统性能问题的重要工具。SkyWalking 是一款开源的 APM（应用性能监控）系统，特别适用于微服务架构下的分布式系统。本文将详细介绍如何在 PHP 项目中安装和配置 SkyWalking，以实现链路追踪功能。

SkyWalking简介

SkyWalking 是由 Apache 基金会孵化的开源项目，主要用于分布式系统的 APM（应用性能监控）。它支持多种语言，包括 Java、.NET、Node.js、Go、PHP 等。SkyWalking 提供了强大的链路追踪、服务拓扑图、性能指标监控等功能，帮助开发者快速定位和解决性能问题。

安装SkyWalking

安装Java环境

SkyWalking 是基于 Java 开发的，因此首先需要安装 Java 环境。推荐使用 JDK 8 或更高版本。

# 在 Ubuntu 上安装 OpenJDK 8
sudo apt-get update
sudo apt-get install openjdk-8-jdk

# 验证 Java 安装
java -version

下载SkyWalking

访问 SkyWalking 官方下载页面，选择适合的版本进行下载。本文以 8.4.0 版本为例。

# 下载 SkyWalking
wget https://downloads.apache.org/skywalking/8.4.0/apache-skywalking-apm-8.4.0.tar.gz

# 解压
tar -zxvf apache-skywalking-apm-8.4.0.tar.gz

# 进入解压后的目录
cd apache-skywalking-apm-bin

配置SkyWalking

SkyWalking 的配置文件位于 config 目录下，主要配置文件为 application.yml。根据实际需求，可以修改以下配置：

• storage：配置数据存储方式，默认使用 H2 数据库，建议在生产环境中使用 Elasticsearch 或 MySQL。
• receiver：配置数据接收方式，默认使用 gRPC。
• cluster：配置集群模式，默认使用单机模式。

storage:
  selector: ${SW_STORAGE:h2}
  h2:
    driver: org.h2.jdbcx.JdbcDataSource
    url: jdbc:h2:mem:skywalking-oap-db
    user: sa
    password:

PHP Agent的安装与配置

安装PHP Agent

SkyWalking 提供了 PHP 的 Agent，用于在 PHP 应用中收集链路追踪数据。首先需要下载并安装 PHP Agent。

# 下载 PHP Agent
wget https://github.com/SkyAPM/SkyAPM-php-sdk/releases/download/v1.0.0/skywalking-agent-php.tar.gz

# 解压
tar -zxvf skywalking-agent-php.tar.gz

# 进入解压后的目录
cd skywalking-agent-php

配置PHP Agent

PHP Agent 的配置文件为 skywalking_agent.ini，主要配置项包括：

• skywalking.enable：是否启用 SkyWalking Agent。
• skywalking.version：SkyWalking 版本。
• skywalking.app_code：应用名称，用于在 SkyWalking 中标识应用。
• skywalking.grpc：SkyWalking OAP 服务的 gRPC 地址。

skywalking.enable = 1
skywalking.version = 8
skywalking.app_code = my_php_app
skywalking.grpc = 127.0.0.1:11800

将 skywalking_agent.ini 文件复制到 PHP 的配置目录中，并确保在 php.ini 中加载该配置文件。

# 复制配置文件
sudo cp skywalking_agent.ini /etc/php/7.4/cli/conf.d/

# 编辑 php.ini
sudo nano /etc/php/7.4/cli/php.ini

# 添加以下内容
extension=skywalking_agent.so

SkyWalking与PHP集成

配置PHP项目

在 PHP 项目中，确保已经安装了 Composer，并在 composer.json 中添加 SkyWalking 的依赖。

{
  "require": {
    "skyapm/skyapm-php-sdk": "^1.0"
  }
}

然后运行 composer install 安装依赖。

启动SkyWalking

在 SkyWalking 的安装目录下，启动 OAP（后端服务）和 UI（前端界面）。

# 启动 OAP
bin/oapService.sh start

# 启动 UI
bin/webappService.sh start

验证与监控

验证链路追踪

在 PHP 项目中，可以通过以下代码片段验证链路追踪是否正常工作。

<?php

use SkyAPM\Tracer;

$tracer = new Tracer();
$span = $tracer->startSpan('my_span');
// 业务逻辑
$span->end();

访问 PHP 应用，查看 SkyWalking UI 中是否有相应的链路数据。

监控与可视化

SkyWalking UI 提供了丰富的监控和可视化功能，包括：

• 拓扑图：展示服务之间的调用关系。
• 链路追踪：展示请求的完整调用链路。
• 性能指标：展示服务的响应时间、吞吐量等性能指标。

通过 SkyWalking UI，可以快速定位性能瓶颈，优化系统性能。

常见问题与解决方案

1. PHP Agent 未生效

   • 确保 skywalking_agent.ini 文件已正确加载。
   • 检查 PHP 版本是否兼容。

2. SkyWalking UI 无法访问

   • 确保 OAP 和 UI 服务已正确启动。
   • 检查防火墙设置，确保端口已开放。

3. 链路数据未显示

   • 检查 skywalking.grpc 配置是否正确。
   • 确保 PHP 应用已正确集成 SkyWalking SDK。

总结

通过本文的介绍，您应该已经掌握了如何在 PHP 项目中安装和配置 SkyWalking，实现链路追踪功能。SkyWalking 提供了强大的监控和诊断工具，帮助开发者快速定位和解决性能问题。在实际生产环境中，建议根据需求调整配置，确保系统的稳定性和性能。

希望本文对您有所帮助，祝您在分布式系统的开发和维护中取得更大的成功！