Connect 至 Loki 資料來源 - Amazon Managed Grafana

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

Connect 至 Loki 資料來源

Loki 資料來源可讓您存取格拉法納的記錄彙總系統 Loki。

新增資料來源

  1. 開啟 Grafana 工作區並確認您已登入。

  2. 配置鏈接下的側面菜單中,您應該找到一個數據源鏈接。

  3. 選擇頂部的添加數據源按鈕。

  4. 從資料來源清單中選取 Loki

注意

如果您在側邊功能表中沒有看到 [資料來源] 連結,表示您目前的使用者沒有該Admin角色。

名稱 描述
Name 資料來源名稱。這是您在面板、查詢和「瀏覽」中查看資料來源的方式。
Default 預設資料來源表示將為新面板預先選取該資料來源。
URL Loki 執行個體的網址,http://localhost:3100例如。這可能是 Amazon EC2 主機的 URL,或 Amazon EKS 叢集前面的 Application Load Balancer,或是 Loki 執行個體的任何其他 URL。
Maximum lines Loki 傳回的記錄行數上限 (預設值為 1000)。在瀏覽器中顯示記錄時,如果瀏覽器緩慢,則減少此值。

衍生欄位

您可以使用派生字段配置來執行以下操作:

  • 新增從記錄訊息剖析的欄位。

  • 新增使用欄位值的連結。

您可以使用此功能直接從記錄檔連結至追蹤後端,或連結至使用者設定檔頁面 (如果記錄行中有 userId)。這些連結會顯示在記錄檔詳細資料中。如需詳細資訊,請參閱 標籤和偵測到的欄位

每個衍生欄位由下列項目組成:

  • 名稱 — 在防護記錄詳細資訊中顯示為標籤。

  • 正則表達式-在日誌消息上運行並捕獲其中一部分作為新字段的值的正則表達式模式。只能包含單一擷取群組。

  • URL/查詢 — 如果連結位於外部,則輸入完整連結 URL。如果連結為內部連結,則此輸入會做為目標資料來源的查詢。在這兩種情況下,您都可以使${__value.raw }用巨集內插欄位中的值。

  • 內部連結 — 選取連結是內部還是外部連結。如果是內部連結,資料來源選取器可讓您選取目標資料來源。僅支援追蹤資料來源。

您可以使用偵錯區段來查看欄位擷取的內容以及 URL 的內插方式。選擇 [顯示範例記錄訊息],以顯示您可以在其中輸入記錄訊息的文字區域。

包含記錄檔詳細資料中顯示連結的新欄位。

查詢 日誌

您可以透過「探索」以及視覺化中的記錄面板來查詢和顯示來自 Loki 的記錄資料。選取 Loki 資料來源,然後輸入 LogQL 查詢以顯示記錄。如需 LogQL 的詳細資訊,請參閱 Log QL。

記錄查詢

記錄查詢由兩部分組成:記錄資料流選取器搜尋運算式。基於效能考量,您必須先選擇記錄資料流的記錄標籤。

查詢欄位旁邊的 [記錄檔總管] ([記錄檔標籤] 按鈕) 會顯示可用記錄資料流的標籤清單。另一種編寫查詢的方法是使用查詢欄位的自動完成功能。您可以通過鍵入左大括號開始{,自動完成菜單將建議標籤列表。按下 Enter 鍵以執行查詢。

傳回結果之後,記錄面板會顯示記錄資料列的清單,以及橫條圖,其中 x 軸顯示時間,y 軸顯示頻率/計數。

記錄串流選取器

對於查詢運算式的標籤部分,請將其包裝在大括號中,{}然後使用索引鍵值語法來選取標籤。多個標籤運算式以逗號分隔:

{app="mysql",name="mysql-backup"}

目前支援下列標籤比對運算子:

  • =完全相等。

  • !=不相等。

  • =~正則表達式匹配。

  • !~不要正則表達式匹配。

範例:

  • {name=~"mysql.+"}

  • {name!~"mysql.+"}

另一種新增標籤選取器的方法是在表格區段中。選擇標籤旁邊的選器,將標籤新增至查詢運算式。這甚至適用於多個查詢,並將標籤選擇器添加到每個查詢。

搜尋運算式

撰寫記錄串流選取器之後,您可以撰寫搜尋運算式來進一步篩選結果。搜索表達式可以只是文本或正則表達式表達式。

查詢範例:

  • {job="mysql"} |= "error"

  • {name="kafka"} |~ "tsdb-ops.*io:2003"

  • {instance=~"kafka-[23]",name="kafka"} != "kafka.server:type=ReplicaManager"

過濾器運算符可以鏈接,並將順序過濾下來的表達式。生成的日誌行將滿足每個過濾器。

範例

{job="mysql"} |= "error" != "timeout"

目前支援下列篩選器類型:

  • |=行包含字符串。

  • !=行不包含字符串。

  • |~行匹配正則表達式。

  • !~line 與正則表達式不匹配。

注意

如需 Loki 查詢語言 LogQL 的詳細資訊,請參閱 L oki LogQL。

記錄內容

使用如上所述的搜尋運算式時,您現在可以擷取篩選結果周圍的前後關聯。透過選擇篩選資料列上的Show Context連結,您就可以調查您感興趣的記錄訊息之前和之後的記錄訊息。

模板

您可以在指標查詢中使用變量,而不是對服務器,應用程序和傳感器名稱等硬編碼內容。變數會顯示為儀表板頂端的下拉式選取方塊。您可以使用這些下拉式方塊來變更顯示在儀表板中的資料。

如需範本變數和範本變數的詳細資訊,請參閱〈〉模板和變量

註釋

您可以使用任何非公制 Loki 查詢作為註釋的來源。日誌內容將用作註釋文本,並將日誌流標籤用作標籤,因此不需要額外的映射。