应用程序 UI 中的自定义链接
Elastic Stack Serverless
对于无服务器可观测性项目,需要编辑器角色或更高角色才能创建和管理自定义链接。要了解更多信息,请参阅分配用户角色和权限。
Elastic 的自定义链接功能允许您轻松地根据您的特定 APM 数据创建最多 500 个动态链接。可以过滤自定义链接,使其仅在相关服务、环境、事务类型或事务名称的应用程序 UI 中显示。
准备好深入了解了吗?直接跳转到示例。
每个自定义链接都包含一个标签、URL 和可选过滤器。创建自定义链接的最简单方法是从事务详细信息页面中的操作下拉列表中创建。此方法将自动应用过滤器,将链接范围限定于该特定服务、环境、事务类型和事务名称。
或者,您可以通过导航到设置 > 自定义 UI,然后选择创建自定义链接,在应用程序 UI 中创建自定义链接。
您的自定义链接的名称。操作上下文菜单显示此文本,因此请尽可能简短。
自定义链接按字母顺序显示在操作菜单中。
您的链接指向的 URL。URL 支持动态字段名称变量,用双花括号括起来:{{field.name}}
。单击链接时,这些变量将替换为事务元数据。
因为每个人的数据都不同,所以您需要检查您的跟踪,以查看哪些元数据可供使用。为此,请在应用程序 UI 中选择一个跟踪,然后在跟踪示例表中单击元数据。

过滤每个链接,使其仅显示在特定服务或事务中。您可以按以下字段进行过滤
service.name
service.env
transaction.type
transaction.name
用逗号分隔时允许多个值。
不确定从哪里开始自定义链接?请查看下面的示例并根据您的喜好进行自定义!
向服务的所有者发送电子邮件。
标签 | 电子邮件 <SERVICE_NAME> 工程师 |
链接 | mailto:<TEAM_OR_ENGINEER>@<COMPANY_NAME>.com |
过滤器 | service.name:<SERVICE_NAME> |
示例
此链接打开一封发送给 python-backend
团队或所有者的电子邮件。它只会出现在名称为 python-backend
的服务上。
标签 | 电子邮件 python-backend 工程师 |
链接 | mailto:python_team@elastic.co |
过滤器 | service.name:python-backend |
打开一个 GitHub issue,其中预填充了从所选跟踪样本中获取的元数据。
标签 | 在 <REPO_NAME> 中打开一个 issue |
链接 | https://github.com/<ORG>/<REPO>/issues/new?title=<TITLE>&body=<BODY> |
过滤器 | service.name:client |
示例
此链接在 apm-agent-rum 存储库中打开一个新的 GitHub issue。它使用来自当前活动跟踪的相关元数据填充 issue 正文。单击此链接会导致创建以下 issue

标签 | 在 apm-rum-js 中打开一个 issue |
链接 | https://github.com/elastic/apm-agent-rum-js/issues/new?title=Investigate+APM+trace&body=Investigate+the+following+APM+trace%3A%0D%0A%0D%0Aservice.name%3A+{{service.name}}%0D%0Atransaction.id%3A+{{transaction.id}}%0D%0Acontainer.id%3A+{{container.id}}%0D%0Aurl.full%3A+{{url.full}} |
过滤器 | service.name:client |
有关支持的查询参数的完整列表,请参阅GitHub 自动化文档。
创建一个 Jira 任务,其中预填充了从所选跟踪样本中获取的元数据。
标签 | 在 Jira 中打开一个 issue |
链接 | https://<JIRA_BASE_URL>/secure/CreateIssueDetails!init.jspa?<ARGUMENTS> |
示例
此链接在 Jira 的 Engineering 板上创建一个新任务。它使用来自当前活动跟踪的相关元数据填充 issue 正文。单击此链接会导致在 Jira 中创建以下任务

标签 | 在 Jira 中打开一个任务 |
链接 | https://test-site-33.atlassian.net/secure/CreateIssueDetails!init.jspa?pid=10000&issuetype=10001&summary=Created+via+APM&description=Investigate+the+following+APM+trace%3A%0D%0A%0D%0Aservice.name%3A+{{service.name}}%0D%0Atransaction.id%3A+{{transaction.id}}%0D%0Acontainer.id%3A+{{container.id}}%0D%0Aurl.full%3A+{{url.full}} |
有关支持的查询参数的完整列表,请参阅Jira 应用程序管理知识库。
链接到自定义仪表板。
标签 | 在自定义可视化中打开事务 |
链接 | https://kibana-instance/app/kibana#/dashboard?_g=query:(language:kuery,query:'transaction.id:{{transaction.id}}'... |
示例
此链接在自定义仪表板中打开当前的 transaction.id
。没有设置过滤器。
标签 | 在 Python 细查 viz 中打开事务 |
URL | https://kibana-instance/app/kibana#/dashboard?_g=(filters:!(),refreshInterval:(pause:!t,value:0),time:(from:now-24h,to:now))&_a=(description:'',filters:!(),fullScreenMode:!f,options:(hidePanelTitles:!f,useMargins:!t),panels:!((embeddableConfig:(),gridData:(h:15,i:cb79c1c0-1af8-472c-aaf7-d158a76946fb,w:24,x:0,y:0),id:c8c74b20-6a30-11ea-92ab-b5d3feff11df,panelIndex:cb79c1c0-1af8-472c-aaf7-d158a76946fb,type:visualization,version:'7.7')),query:(language:kuery,query:'transaction.id:{{transaction.id}}'),timeRestore:!f,title:'',viewMode:edit) |
打开指定的 Slack 频道。
标签 | 打开 SLACK_CHANNEL |
链接 | https://COMPANY_SLACK.slack.com/archives/SLACK_CHANNEL |
过滤器 | service.name : SERVICE_NAME |
示例
此链接打开一个公司 Slack 频道 #apm-user-support。只有当 transaction.name
是 GET user/login
时才会显示。
标签 | 打开 #apm-user-support |
链接 | https://COMPANY_SLACK.slack.com/archives/efk52kt23k |
过滤器 | transaction.name:GET user/login |
打开内部或外部网站。
标签 | 打开 <WEBSITE> |
链接 | https://<COMPANY_SLACK>.slack.com/archives/<SLACK_CHANNEL> |
过滤器 | service.name:<SERVICE_NAME> |
示例
此链接打开有关特定 user.email
的更多数据。它只会出现在前端事务中。
标签 | 在内部查看用户 |
链接 | https://internal-site.company.com/user/{{user.email}} |
过滤器 | service.name:client |