為調(diào)用鏈配置自定義交互事件
事件配置用于對單個字段或單個查詢分析進行下鉆(Drilldown)分析,加深數(shù)據(jù)分析的維度。您可以為調(diào)用鏈的一個或多個屬性設(shè)置交互事件,方便查詢更詳盡的調(diào)用鏈或查看與調(diào)用鏈關(guān)聯(lián)的日志、指標(biāo)等信息。本文介紹交互事件相關(guān)的配置說明。
交互事件是數(shù)據(jù)分析中不可缺少的功能之一,通過改變數(shù)據(jù)維度的層次、變換分析的粒度從而獲取數(shù)據(jù)中更詳盡的信息。調(diào)用鏈分析支持對Span的字段、屬性設(shè)置交互事件。交互事件類型包括:
打開日志庫:跳轉(zhuǎn)到日志服務(wù)目標(biāo)Logstore頁面。
自定義HTTP鏈接:跳轉(zhuǎn)到目標(biāo)HTTP鏈接頁面。
從編輯框中打開:在彈窗中以文本格式或JSON格式展示字段值。
打開快速查詢:跳轉(zhuǎn)到日志服務(wù)目標(biāo)快速查詢頁面。
添加自定義交互事件
在調(diào)用鏈分析頁面單擊調(diào)用鏈的TraceId。
選中目標(biāo)接口,在右側(cè)的Span詳情區(qū)域單擊事件配置。
在彈出的Drilldown 配置面板中,選擇交互事件的生效范圍。
自定義事件生效范圍有兩種,包括服務(wù)事件配置和全局事件配置。服務(wù)事件配置僅在當(dāng)前應(yīng)用的所有調(diào)用鏈中生效,而全局事件配置在當(dāng)前地域的所有調(diào)用鏈中生效。
單擊添加字段,選擇需要配置自定義事件的字段,然后單擊確定。
單擊添加事件,從下拉框中選擇交互事件。
填寫交互事件的參數(shù),配置完成后單擊確認(rèn)。
具體參數(shù)的說明請參見下文交互事件參數(shù)說明。
觸發(fā)自定義事件
在Span詳情區(qū)域?qū)⑹髽?biāo)懸浮到藍色字段上,會彈出懸浮框展示已配置的自定義事件,單擊事件名即可觸發(fā)交互事件。
交互事件參數(shù)說明
打開日志庫
觸發(fā)打開日志庫交互事件后,控制臺將跳轉(zhuǎn)到日志服務(wù)目標(biāo)Logstore頁面。
前提條件
已創(chuàng)建目標(biāo)Logstore。更多信息,請參見管理Logstore。
配置參數(shù)
參數(shù)
是否必填
說明
自定義名稱
是
自定義交互事件的名稱,該名稱會展示在自定義事件懸浮框中。
請選擇region
是
選擇日志服務(wù)目標(biāo)Project所在地域。
請選擇項目
是
選擇日志服務(wù)目標(biāo)Project名稱。
請選擇日志庫
是
選擇日志服務(wù)目標(biāo)Logstore名稱。觸發(fā)交互事件后,將跳轉(zhuǎn)到目標(biāo)Logstore頁面。
打開新窗口
否
開啟該選項,則觸發(fā)交互事件后將在新窗口打開目標(biāo)Logstore。
時間范圍
否
設(shè)置目標(biāo)Logstore的查詢時間范圍。可以設(shè)置為:
預(yù)設(shè):跳轉(zhuǎn)到目標(biāo)Logstore頁面后,對應(yīng)的查詢時間為日志服務(wù)默認(rèn)的查詢時間,即15分鐘(相對)。
繼承當(dāng)前查詢時間:跳轉(zhuǎn)到目標(biāo)Logstore頁面后,對應(yīng)的查詢時間為觸發(fā)交互事件時調(diào)用鏈分析頁面對應(yīng)的時間。
繼承數(shù)據(jù)點時間:跳轉(zhuǎn)到目標(biāo)Logstore頁面后,對應(yīng)的查詢開始時間為觸發(fā)交互事件時所選調(diào)用鏈的時間范圍字段值減去時間范圍字段差值,查詢結(jié)束時間為時間范圍字段值加上時間范圍字段差值。
相對時間:跳轉(zhuǎn)到目標(biāo)Logstore頁面后,對應(yīng)的查詢時間為當(dāng)前指定的相對時間。
整點時間:跳轉(zhuǎn)到目標(biāo)Logstore頁面后,對應(yīng)的查詢時間為當(dāng)前指定的整點時間。
過濾語句
否
輸入過濾語句,可將該過濾語句同步到目標(biāo)Logstore中,并以
AND
方式添加到查詢分析語句之前。在過濾語句中添加變量,可以將對應(yīng)字段的值作為過濾條件。
示例:
traceId=${{traceID}} AND spanId=${{spanID}}
自定義HTTP鏈接
觸發(fā)自定義HTTP鏈接交互事件后,控制臺將跳轉(zhuǎn)到目標(biāo)HTTP鏈接頁面。
前提條件
已準(zhǔn)備好HTTP鏈接。
配置參數(shù)
參數(shù)
是否必填
說明
自定義名稱
是
自定義交互事件的名稱,該名稱會展示在自定義事件懸浮框中。
協(xié)議
是
選擇HTTP鏈接的協(xié)議。
鏈接地址
是
需要跳轉(zhuǎn)到的目標(biāo)地址。
HTTP鏈接中的路徑部分表示訪問的目標(biāo)文件的層級路徑,您可以在定義HTTP鏈接的路徑部分添加變量,單擊鏈接時,對應(yīng)字段值將會替換HTTP鏈接中的參數(shù),跳轉(zhuǎn)到重新定位的HTTP鏈接中。
是否轉(zhuǎn)碼
否
打開是否轉(zhuǎn)碼開關(guān)后,鏈接中的內(nèi)容將會進行encode轉(zhuǎn)碼。
打開新窗口
否
開啟該選項,觸發(fā)交互事件后將在新窗口打開目標(biāo)HTTP鏈接頁面。
從編輯框中打開
觸發(fā)從編輯框中打開交互事件后,控制臺將在彈窗中以文本格式或JSON格式展示字段值。
參數(shù) | 是否必填 | 說明 |
自定義名稱 | 是 | 自定義交互事件的名稱,該名稱會展示在自定義事件懸浮框中。 |
文本類型 | 否 | 選擇以文本格式或JSON格式展示字段值。 |
打開快速查詢
觸發(fā)打開快速查詢交互事件后,控制臺將跳轉(zhuǎn)到日志服務(wù)目標(biāo)快速查詢頁面。
前提條件
已在日志服務(wù)中創(chuàng)建目標(biāo)快速查詢。更多信息,請參見快速查詢。
如果要設(shè)置變量,則需在目標(biāo)快速查詢中設(shè)置查詢分析語句的變量。更多信息,請參見變量。
配置參數(shù)
參數(shù)
是否必填
說明
自定義名稱
是
自定義交互事件的名稱,該名稱會展示在自定義事件懸浮框中。
請選擇region
是
選擇日志服務(wù)目標(biāo)Project所在地域。
請選擇項目
是
選擇日志服務(wù)目標(biāo)Project名稱。
請選擇快速查詢
是
選擇日志服務(wù)目標(biāo)快速查詢。觸發(fā)交互事件后,將打開該快速查詢頁面。
打開新窗口
否
開啟該選項,觸發(fā)交互事件后將在新窗口打開目標(biāo)快速查詢頁面。
時間范圍
否
設(shè)置目標(biāo)快速查詢的時間范圍。可以設(shè)置為:
預(yù)設(shè):跳轉(zhuǎn)到目標(biāo)快速查詢頁面后,保持日志服務(wù)默認(rèn)的查詢時間范圍,即15分鐘(相對)。
繼承當(dāng)前時間:跳轉(zhuǎn)到目標(biāo)快速查詢頁面后,對應(yīng)的查詢時間為觸發(fā)交互事件時調(diào)用鏈分析頁面對應(yīng)的時間。
繼承數(shù)據(jù)點時間:跳轉(zhuǎn)到目標(biāo)快速查詢頁面后,對應(yīng)的查詢開始時間為觸發(fā)交互事件時所選調(diào)用鏈的時間范圍字段值減去時間范圍字段差值,查詢結(jié)束時間為時間范圍字段值加上時間范圍字段差值。
相對時間:跳轉(zhuǎn)到目標(biāo)快速查詢頁面后,對應(yīng)的查詢時間為當(dāng)前指定的相對時間。
整點時間:跳轉(zhuǎn)到目標(biāo)快速查詢頁面后,對應(yīng)的查詢范圍為當(dāng)前指定的整點時間。
過濾語句
否
輸入過濾語句,可將該過濾語句同步到目標(biāo)快速查詢頁面中,并以
AND
方式添加到查詢分析語句之前。在過濾語句中添加變量,可以將對應(yīng)字段的值作為過濾條件。
動態(tài)變量
否
日志服務(wù)支持通過變量靈活修改目標(biāo)快速查詢中的查詢分析語句,當(dāng)此處添加的變量和目標(biāo)快速查詢的查詢分析語句中的變量相同時,查詢分析語句中的變量將會被觸發(fā)交互事件的字段值替換。
說明最多可添加5個動態(tài)變量和5個靜態(tài)變量。
動態(tài)變量
動態(tài)變量名:設(shè)置變量名。
動態(tài)變量值所在列:以指定列對應(yīng)的值動態(tài)替換目標(biāo)快速查詢的查詢分析語句中的變量。
靜態(tài)變量
靜態(tài)變量名:設(shè)置變量名。
靜態(tài)值:以固定的字段值替換目標(biāo)快速查詢的查詢分析語句中的變量。
靜態(tài)變量
否
預(yù)置交互事件(高級配置)
調(diào)用鏈分析提供了預(yù)置的交互事件,包括以下內(nèi)容:
內(nèi)置事件名稱 | 生效字段 | 說明 |
使用當(dāng)前條件查詢調(diào)用鏈 | 除Span Events外的所有字段 | 將該字段作為查詢條件追加到調(diào)用鏈分析的查詢中。 |
查看應(yīng)用詳情 | 應(yīng)用名(serviceName) | 跳轉(zhuǎn)至應(yīng)用監(jiān)控的應(yīng)用概覽頁面。 |
查看提供服務(wù) | 接口名(spanName) | 跳轉(zhuǎn)至應(yīng)用監(jiān)控的提供服務(wù)頁面。 |
查看實例監(jiān)控 | IP | 跳轉(zhuǎn)至應(yīng)用監(jiān)控的實例監(jiān)控頁面。 |
查看原始Trace數(shù)據(jù) | TraceID、SpanId | 查看存儲在日志服務(wù)中的原始調(diào)用鏈數(shù)據(jù)。 |
常見問題
如果您使用虛商域名訪問調(diào)用鏈分析頁面(例如將ARMS頁面嵌入了自建Web頁面),觸發(fā)打開日志庫和打開快速查詢事件后將無法正常訪問日志服務(wù)控制臺,而是跳轉(zhuǎn)至登錄頁。您可以通過自定義HTTP鏈接實現(xiàn)同樣的效果,具體步驟如下:
在事件配置中創(chuàng)建自定義HTTP鏈接交互事件。
協(xié)議選擇https,并在鏈接地址中填寫跳轉(zhuǎn)鏈接。
準(zhǔn)備要跳轉(zhuǎn)到的日志服務(wù)鏈接,并將鏈接的域名(sls.console.aliyun.com)替換為日志服務(wù)虛商域名(sls4service.console.aliyun.com),更多信息請參見準(zhǔn)備分享鏈接。
如果您希望跳轉(zhuǎn)到日志庫時攜帶查詢參數(shù),請單擊查詢變量選擇要添加的變量。
鏈接地址示例如下,該鏈接會打開Project名稱為test-project、Logstore名稱為test-logstore的日志庫,并過濾traceId為當(dāng)前調(diào)用鏈的traceId。
https://sls.console.aliyun.com/lognext/project/test-project/logsearch/test-logstore?queryString=traceId=${{traceID}}