› › › ›

应用程序 UI 中的自定义链接

编辑

应用程序 UI 中的自定义链接

编辑

Elastic 的自定义链接功能允许您轻松地根据您特定的 APM 数据创建最多 500 个动态链接。可以对自定义链接进行过滤，使其仅在应用程序 UI 中与相关的服务、环境、事务类型或事务名称一起显示。

准备好深入了解了吗？直接跳转到示例。

创建链接

编辑

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

或者，您也可以通过导航到应用程序 UI 中的设置 > 自定义 UI 并选择创建自定义链接 来创建自定义链接。

标签编辑

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

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

URL编辑

链接指向的 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:[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 问题。它使用来自当前活动跟踪的相关元数据填充问题主体。单击此链接将创建以下问题

标签	`在 apm-rum-js 中打开一个问题`
链接	`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 任务，其中包含来自所选跟踪样本的预填充元数据。

标签	`在 Jira 中打开一个问题`
链接	`https://<JIRA_BASE_URL>/secure/CreateIssueDetails!init.jspa?<ARGUMENTS>`

示例

此链接在 Jira 中的工程看板上创建一个新任务。它使用来自当前活动跟踪的相关元数据填充问题主体。单击此链接将在 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 应用程序管理知识库。

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.name 为 GET user/login 时才会显示。

标签	`打开 #apm-user-support`
链接	`https://microsoft.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`

« 创建 APM 规则和警报安全使用 APM »