自定义链接编辑

Elastic 的自定义链接功能允许您轻松创建多达 500 个基于特定 APM 数据的动态链接。可以筛选自定义链接,使其仅在 APM 应用中针对相关服务、环境、事务类型或事务名称显示。

准备深入了解?直接跳转至 示例

创建链接编辑

每个自定义链接都包含一个标签、URL 和可选筛选器。创建自定义链接最简单的方法是从事务详细信息页面中的操作下拉菜单中进行创建。此方法将自动应用筛选器,将链接限定到该特定服务、环境、事务类型和事务名称。

或者,您可以通过导航至 设置 > 自定义 UI,然后选择 创建自定义链接,在 APM 应用中创建自定义链接。

标签编辑

自定义链接的名称。操作上下文菜单显示此文本,因此请尽可能简短。

自定义链接按字母顺序显示在操作菜单中。

URL编辑

链接指向的 URL。URL 支持用双花括号括起来的动态字段名称变量:{{field.name}}。单击链接时,这些变量将替换为事务元数据。

由于每个人的数据都不同,因此您需要检查跟踪记录以查看可供使用的元数据。为此,请在 APM 应用中选择一个跟踪记录,然后单击 跟踪记录样本 表中的 元数据

Example metadata

筛选器编辑

筛选每个链接,使其仅针对特定服务或事务显示。您可以筛选以下字段

  • 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:[email protected]

过滤器

service.name:python-backend

GitHub 问题编辑

使用从选定的跟踪样本中预先填充的元数据打开 GitHub 问题。

标签

在 <REPO_NAME> 中打开一个问题

链接

https://github.com/<ORG>/<REPO>/issues/new?title=<TITLE>&body=<BODY>

过滤器

service.name:client

示例

此链接会在 apm-agent-rum 存储库中打开一个新的 GitHub 问题。它会使用当前活动跟踪中的相关元数据填充问题正文。单击此链接会创建以下问题

Example github issue

标签

在 apm-rum-js 中打开一个问题

链接

https://github.com/elastic/apm-agent-rum-js/issues/new?title=调查 APM 跟踪&body=调查以下 APM 跟踪:%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 任务。

标签

在 Jira 中打开一个问题

链接

https://<JIRA_BASE_URL>/secure/CreateIssueDetails!init.jspa?<ARGUMENTS>

示例

此链接在 Jira 的工程看板上创建一个新任务。它会使用当前活动跟踪中的相关元数据填充问题正文。单击此链接会在 Jira 中创建以下任务

Example jira issue

标签

在 Jira 中打开一个任务

链接

https://test-site-33.atlassian.net/secure/CreateIssueDetails!init.jspa?pid=10000&issuetype=10001&summary=通过 APM 创建&description=调查以下 APM 跟踪:%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 应用程序管理知识库,了解受支持的查询参数的完整列表。

Kibana 仪表盘编辑

链接到 Kibana 中的自定义仪表盘。

标签

在自定义可视化中打开事务

链接

https://kibana-instance/app/kibana#/dashboard?_g=query:(language:kuery,query:'transaction.id:{{transaction.id}}'...

示例

此链接在自定义 kibana 仪表盘中打开当前 transaction.id。未设置任何过滤器。

标签

在 Python 钻取可视化中打开事务

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 频道。

标签

打开 SLACK_CHANNEL

链接

https://COMPANY_SLACK.slack.com/archives/SLACK_CHANNEL

过滤器

service.name : SERVICE_NAME

示例

此链接会打开一个公司 slack 频道,#apm-support。它仅在 transaction.nameGET user/login 时出现。

标签

打开 #apm-user-support

链接

https

过滤器

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