为原生帧添加符号

编辑

要查看用编译为原生代码的编程语言(C、C++、Rust、Go 等)编写的应用程序跟踪中的函数名称和行号,需要使用symbtool CLI 实用程序将符号推送到集群。

下载symbtool 二进制文件
编辑

单击适合您系统的链接以下载symbtool 二进制文件

symbtool 二进制文件目前需要 Linux 机器。

使用symbtool 二进制文件
编辑

在使用symbtool 二进制文件之前,请创建一个Elasticsearch API 令牌。使用-t--api-key 参数传递此令牌。

您还需要从部署概述页面复制符号端点。使用-u--url 参数传递此 URL。

profiling symbolizer url
自定义 C、C++、Go 和 Rust 应用程序
编辑

要使符号化工作,必须使用调试符号(-g)构建 C/C++ 应用程序。Rust 应用程序必须使用debug = 1(或更高版本)构建。Go 二进制文件不需要任何特殊的编译器标志,并且默认情况下包含调试信息。调试信息不必部署到生产环境,但必须暂时存在才能将其推送到 Elastic 集群。

如果您不介意部署包含调试符号的应用程序,请运行

./symbtool push-symbols executable -e ./my-app -u <symbolizer url> -t <API token>

如果您不希望生产环境中存在调试符号,请复制可执行文件并剥离副本。然后,您可以使用-d 参数指示工具从原始未剥离二进制文件中读取符号,同时仍从最终剥离的二进制文件中计算文件 ID。推送符号后,您可以删除未剥离的二进制文件。

cp ./my-app ./my-stripped-app
strip ./my-stripped-app
./symbtool push-symbols executable -e ./my-stripped-app -d ./my-app -u <symbolizer url> -t <API token>
rm ./my-app

先推送调试信息,然后再剥离二进制文件不起作用。使用-e 参数传递的可执行文件用于计算将堆栈跟踪与其符号关联的文件 ID,之后剥离二进制文件会更改该 ID。

Linux 发行版软件包
编辑

Elastic 托管一项公共服务,其中包含各种流行 Linux 发行版的存储库中所有软件包的符号信息。无需用户执行任何操作,即可自动为从这些存储库安装的应用程序添加符号。

Elastic 支持以下 Linux 发行版:

  • Alpine Linux
  • Amazon Linux
  • Debian
  • Fedora
  • Ubuntu