› › › ›

应用程序 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=调查+APM+跟踪&body=调查+以下+APM+跟踪%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=通过+APM+创建&description=调查+以下+APM+跟踪%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 »