Elastic 的 OpenTelemetry PHP 发行版简介

作者：Pawel Filipczak

宣布 OpenTelemetry PHP 的 Elastic 发行版的第一个 alpha 版本。在本篇博文中了解使用 OpenTelemetry 来检测 PHP 应用程序是多么简单。

我们很高兴推出 OpenTelemetry PHP 的 Elastic Distribution 的第一个 alpha 版本。在这篇文章中，你将了解如何轻松安装和设置 PHP 应用程序的监控。

背景

Elastic 正在标准化 OpenTelemetry (OTel) 以实现可观察性和安全性数据收集。作为这项工作的一部分，我们提供 OpenTelemetry 语言 SDK 的发行版。我们的 Android 和 iOS SDK 从一开始就基于 OpenTelemetry，我们最近发布了 Java、.NET、Node.js 和 Python 的 alpha 发行版。OpenTelemetry PHP 的 Elastic 发行版是最新添加的。

入门

要为你的应用程序安装 OpenTelemetry PHP 的 Elastic 分发，请从 https://github.com/elastic/elastic-otel-php/releases 下载适合你的 Linux 发行版的软件包。

目前，我们支持使用 DEB 和 RPM 软件包管理器的 x86_64 和 ARM64 处理器系统的软件包。

对于基于 DEB 的系统，请运行以下命令：

dpkg -i <package-file>.deb

对于基于 RPM 的系统，运行以下命令：

rpm -ivh <package-file>.rpm

对于基于 RPM 的系统，运行以下命令：对于基于 APK 的系统（Alpine），运行以下命令：

https://elasticstack.blog.csdn.net/article/details/102728604

软件包安装程序将自动检测已安装的 PHP 版本并更新配置，因此监控扩展将在下次重新启动进程时可用（你需要重新启动进程以加载新的 php.ini 配置）。需要一些环境变量来提供对服务进行检测所需的配置。这些主要涉及跟踪的目标和服务的标识。你还需要提供授权 headers，以便与 Elastic Observability Cloud 和发送数据的 Elastic Cloud 端点进行身份验证。

export OTEL_EXPORTER_OTLP_HEADERS="Authorization=<url encoded apikey header value>"
export OTEL_EXPORTER_OTLP_ENDPOINT=<your elastic cloud url>

这里

OTEL_EXPORTER_OTLP_ENDPOINT：将发送数据的端点的完整 URL。
OTEL_EXPORTER_OTLP_HEADERS：将添加到每个请求标头的 key=value 对的逗号分隔列表。这通常用于身份验证信息。

因此，重新启动应用程序后，你应该会在 Kibana 中看到受监控应用程序的相关信息，例如服务地图和跟踪视图。在下面的示例中，你可以看到使用 Laravel 框架创建的 Aimeos 应用程序的跟踪详细信息。

下面是使用 HttpAsyncClient 的 Slim 应用程序的示例：

下一步是什么？

在此 alpha 版本中，我们支持从 8.0 到 8.3 的所有现代 PHP 版本，为 PHP 代码提供检测，包括 Laravel、Slim 和 HttpAsyncClient 等流行框架以及 PDO 等本机扩展。在未来的版本中，我们计划引入 OpenTelemetry 支持的其他功能，以及 Elastic APM 独有的功能，例如 Inferred Spans。

敬请期待！

Elastic 致力于帮助 OpenTelemetry 取得成功，并帮助我们的客户在其系统中有效地使用 OpenTelemetry。去年，我们捐赠了 ECS，并继续致力于将其与 OpenTelemetry 语义约定集成。最近，我们正在努力将基于 eBPF 的分析器捐赠给 OpenTelemetry。我们为许多语言 SDK 和其他 OpenTelemetry 项目做出了贡献。

作为 PHP 发行版的作者，我们很高兴与 OpenTelemetry PHP 社区合作，帮助使 PHP SDK 成为更强大、功能更强大、更明显的 PHP 可观察性选择。发行版让我们能够灵活地在原始 OTel SDK 之上构建功能。目前，发行版的一些优势包括：全自动安装和全自动检测。我们肯定会在可能的情况下向 OTel PHP 项目上游贡献功能，并在发行版中包含更多功能（如果更有意义的话）。

PHP 的 Elastic OpenTelemetry 发行版目前为 alpha 版本。请试用它，并让我们知道它是否适合你。请在此处关注最新版本。你可以在项目问题跟踪器或 Elastic 的 PHP APM 讨论论坛上与我们互动。