本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # 在 Grafana 第 10 版中探索 **** 本文件主題專為支援 Grafana **10.x 版的 Grafana** 工作區而設計。 如需支援 Grafana 9.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 9 版](using-grafana-v9.md)。 如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 8 版](using-grafana-v8.md)。 Grafana 的儀表板 UI 提供建立儀表板以進行視覺化的功能。*探索*儀表板和面板選項的分割，讓您可以專注於查詢。它可協助您反覆執行，直到您有工作查詢為止，然後您可以從查詢建置儀表板。 **注意** 如果您只想探索資料，但不想建立儀表板，Explore 會讓您更輕鬆。如果您的資料來源支援圖形和資料表資料，則 Explore 會將結果顯示為圖形和資料表。這可讓您同時查看資料中的趨勢和更多詳細資訊。 此頁面將協助您開始探索資料。下列主題為您提供有關 探索的特定功能和用途的詳細資訊。 + [探索中的查詢管理](v10-explore-manage.md) + [探索中的日誌](v10-explore-logs.md) + [探索中的追蹤](v10-explore-tracing.md) + [探索中的關聯編輯器](v10-explore-correlations.md) + [探索中的檢查器](v10-explore-inspector.md) ## 開始探索 **注意** 若要存取探索，您必須擁有編輯器或管理員角色。 **存取探索** 1. 在 Grafana 工作區中，從左側選單列中選擇探索選單項目。 開啟空的探索索引標籤。 或者，若要從面板中的現有查詢開始，請從面板功能表中選擇探索選項。這會從面板中開啟具有查詢的探索索引標籤，並可讓您在儀表板外部的查詢中調整或反覆執行。 1. 從左上角的下拉式清單中選擇您的資料來源。 您也可以選擇**開啟進階資料來源挑選器**以查看更多選項，包括新增資料來源 （僅適用於管理員）。 1. 使用所選資料來源提供的查詢編輯器撰寫查詢。 如需查詢的詳細資訊，請參閱 [查詢和轉換資料](v10-panels-query-xform.md)。 1. 使用右上角的按鈕執行查詢。 ## 分割和比較 分割檢視提供簡單的方法來side-by-side比較視覺效果，或在同一頁面上一起查看相關資料。 **頂端開啟分割檢視** 1. 在探索檢視中，選擇**分割**按鈕以複製目前的查詢，並將頁面分割成兩個side-by-side查詢。 **注意** 您可以為新查詢選取另一個資料來源，例如，可讓您比較兩個不同伺服器的相同查詢，或比較預備環境與生產環境。 在分割檢視中，可以透過選取連接到其中一個計時字元的時間同步按鈕來連結兩個面板的計時字元 （如果您變更一個，另一個也會變更）。連結分片檢視查詢的開始和結束時間會保持同步。它可確保您在兩個分割面板中查看相同的時間間隔。 1. 若要關閉新建立的查詢，請選擇**關閉分割**按鈕。 ## 內容大綱 內容大綱是側邊導覽列，可追蹤您在探索中建立的查詢和視覺效果。它可讓您在它們之間快速導覽。 內容大綱也可以在分割檢視中運作。當您在分割檢視中時，會為每個窗格產生內容大綱。 **開啟內容大綱** 1. 選取**探索**畫面左上角的**大綱**按鈕。 1. 選取內容大綱中的任何面板圖示以導覽至該面板。 ## 共用探索 URLs 使用探索時，瀏覽器地址列中的 URL 會在您對查詢進行變更時更新。您可以共用此 URL 或將此 URL 加入書籤。 **注意** 探索可能會產生相對較長URLs。如果 URL 對您的工具太長，您也可以產生和共用[縮短的連結](#v10-explore-share)。 **從外部工具產生探索 URLs ** 由於探索 URLs具有定義的結構，因此您可以從外部工具建置 URL，並在 Grafana 中開啟它。URL 結構為： ``` http:///explore?panes=&schemaVersion=&orgId= ``` 其中： + `org_id` 是組織 ID + `schema_version` 是結構描述版本 （應設定為最新版本，即 `1`。 + `panes` 是窗格的 url 編碼 JSON 物件，其中每個索引鍵都是窗格 ID，而每個值都是符合下列結構描述的物件： ``` { datasource: string; // the pane's root datasource UID, or `-- Mixed --` for mixed datasources queries: { refId: string; // an alphanumeric identifier for this query, must be unique within the pane, i.e. "A", "B", "C", etc. datasource: { uid: string; // the query's datasource UID ie: "AD7864H6422" type: string; // the query's datasource type-id, i.e: "loki" } // ... any other datasource-specific query parameters }[]; // array of queries for this pane range: { from: string; // the start time, in milliseconds since epoch to: string; // the end time, in milliseconds since epoch } } ``` **注意** `from` 和 `to` 欄位也接受 [設定儀表板時間範圍](v10-dash-using-dashboards.md#v10-dash-setting-dashboard-time-range)主題中所述的相對範圍。 ## 共用縮短的連結 共用縮短連結功能可讓您建立較小且更簡單的格式 /goto/：uid URLs，而不是搭配查詢參數使用較長URLs。若要建立查詢結果的縮短連結，請選取探索工具列中的**共用**選項。未使用的縮短連結會在七 (7) 天後自動刪除。如果連結至少使用一次，就不會遭到刪除。 **以絕對時間共用縮短的連結** 短連結有兩個選項：保留相對時間 （例如，兩個小時前到目前時間） 或絕對時間 （例如，上午 8 點到上午 10 點）。根據預設，共用縮短的連結會複製選取的時間範圍，相對或絕對。選擇共用縮短連結按鈕旁的下拉式按鈕，並選取**時間同步 URL 連結**下的其中一個選項，可讓您建立具有絕對時間的簡短連結，這表示接收連結的任何人都會看到您看到的相同資料，即使他們再次開啟連結。此選項不會影響在探索檢視中選取的時間範圍。 # 探索中的查詢管理 **** 本文件主題專為支援 Grafana **10.x 版的 Grafana** 工作區而設計。 如需支援 Grafana 9.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 9 版](using-grafana-v9.md)。 如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 8 版](using-grafana-v8.md)。 您可以管理在探索中建立的查詢，包括您已執行的查詢歷史記錄，以及已觸發的查詢。 ## 查詢歷史記錄 查詢歷史記錄是您在探索中使用的查詢清單。歷史記錄會存放在 Grafana 資料庫中，而且不會與其他使用者共用。歷史記錄中查詢的保留期為兩週。超過兩週的查詢會自動刪除。若要開啟並與您的歷史記錄互動，請選取探索中的**查詢歷史記錄**按鈕。 **注意** Starred （偏好） 查詢不受兩週保留期的限制，也不會遭到刪除。 ## 檢視查詢歷史記錄 查詢歷史記錄可讓您檢視查詢的歷史記錄。對於每個個別查詢，您可以： + 執行查詢。 + 建立和/或編輯註解。 + 將查詢複製到剪貼簿。 + 將包含查詢的縮短連結複製到剪貼簿。 + Star （我的最愛） 查詢。 ## 管理我的最愛查詢 在查詢歷史記錄索引標籤中以星號顯示的所有查詢都會顯示在 Starred 索引標籤中。這可讓您更快地存取您最愛的查詢，並重複使用這些查詢，而無需從頭開始輸入。 ## 排序查詢歷史記錄 根據預設，查詢歷史記錄會顯示最新的查詢。您可以依日期或資料來源名稱以遞增或遞減順序來排序歷史記錄。 **排序查詢歷史記錄** 1. 選取**依欄位排序查詢**。 1. 選取以下其中一個選項： + **最新優先** + **最舊的先** ## 篩選查詢歷史記錄 您可以在查詢歷史記錄和 Starred 索引標籤中篩選特定資料來源的查詢歷史記錄。 **篩選資料來源的歷史記錄** 1. 選取**特定資料來源的篩選查詢 （篩選）** 欄位。 1. 選取您要篩選歷史記錄的資料來源。您可以選取多個資料來源。 **注意** 使用混合資料來源執行的查詢只會在篩選混合時顯示，而不會在篩選其個別資料來源時顯示。 在**查詢歷史記錄**索引標籤中，也可以使用滑桿依日期篩選查詢： + 使用垂直滑桿依日期篩選查詢。 + 拖曳底部控點以調整開始日期。 + 拖曳頂端控點來調整結束日期。 ## 在查詢歷史記錄中搜尋 您可以在查詢和註解之間搜尋歷史記錄。您可以在查詢歷史記錄索引標籤和 Starred 索引標籤中搜尋查詢。 **在查詢歷史記錄中搜尋** 1. 選取**搜尋查詢**欄位。 1. 在搜尋欄位中輸入您要搜尋的詞彙。 ## 查詢歷史記錄設定 您可以在設定索引標籤中自訂查詢歷史記錄。下表說明選項。 | 設定 | 預設值 | | --- | --- | | 變更預設作用中標籤 | 查詢歷史記錄索引標籤 | **注意** 查詢歷史記錄設定是全域的，並套用到分割模式中的兩個面板。 # 探索中的日誌 **** 本文件主題專為支援 Grafana **10.x 版的 Grafana** 工作區而設計。 如需支援 Grafana 9.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 9 版](using-grafana-v9.md)。 如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 8 版](using-grafana-v8.md)。 探索可讓您調查不同資料來源中的日誌，包括： + [OpenSearch](using-opensearch-in-AMG.md) + [Amazon CloudWatch](using-amazon-cloudwatch-in-AMG.md) + [InfluxDB](using-influxdb-in-AMG.md) + [Loki](using-loki-in-AMG.md) 在基礎設施監控和事件回應期間，您可以深入了解指標和日誌，以找出原因。探索也可讓您side-by-side檢視日誌與其他遙測訊號，例如指標、追蹤或設定檔。 日誌查詢的結果會以個別日誌行顯示，並以圖表顯示所選期間內的日誌磁碟區。 ## 記錄磁碟區 使用支援完整範圍日誌磁碟區的資料來源時，Explore 會自動顯示圖表，顯示所有輸入日誌查詢的日誌分佈。OpenSearch 和 Loki 資料來源目前支援此功能。 **注意** 在 Loki 中，此完整範圍日誌磁碟區是由指標查詢轉譯，根據查詢的時間範圍，可能很昂貴。此查詢在處理較小的 Loki 安裝時特別具有挑戰性。若要緩解這種情況，您可以使用 Loki 前面的 [nginx](https://www.nginx.com/) 這類代理來設定這些查詢的自訂逾時 （例如 10 秒）。可以透過使用值`X-Query-Tags`為 的 HTTP 標頭尋找查詢來識別日誌磁碟區長條圖查詢`Source=logvolhist`；Grafana 會將這些標頭新增至所有日誌磁碟區長條圖查詢。 如果資料來源不支援載入完整範圍日誌磁碟區，則日誌模型會計算日誌資料列來計算時間序列，並根據自動計算的時間間隔將它們組織到儲存貯體中。第一個日誌列的時間戳記用於錨定結果中日誌磁碟區的開始。時間序列的結尾會錨定至時間挑選器的**收件人**範圍。如此一來，即使資料來源不提供完整範圍支援，您仍然可以有效率地分析和視覺化日誌資料。 ## 日誌 在下列各節中，您將找到如何在探索中視覺化並與個別日誌互動的詳細說明。 ## 日誌導覽 日誌行右側的日誌導覽可用來輕鬆請求其他日誌。您可以按一下導覽底部的**舊日誌**按鈕來執行此操作。當您達到行限制並想要查看更多日誌時，這特別有用。從導覽執行的每個請求都會在導覽中顯示為個別頁面。每個頁面都會顯示傳入日誌行的 `from`和 `to`時間戳記。您可以按一下每個頁面來查看先前的結果。探索會快取從日誌導覽中執行的最後五個請求，因此您在按一下頁面時不會重新執行相同的查詢，從而節省時間和資源。 ## 視覺化選項 您可以自訂日誌的顯示方式，並選取顯示的欄。 | 選項 | Description | | --- | --- | | Time (時間) | 顯示或隱藏時間欄。這是從資料來源回報的與日誌行相關聯的時間戳記。 | | 唯一標籤 | 顯示或隱藏僅包含非常見標籤的唯一標籤欄。所有常用標籤都會顯示在上方。 | | 包裝線 | true 如果您希望顯示器使用換行，請將此設為 。如果設定為 false，則會導致水平捲動。 | | Prettify JSON | 將此設為 true可列印所有 JSON 日誌。此設定不會影響 JSON 以外的任何格式日誌。 | | 重複資料刪除 | 日誌資料可以非常重複，探索可以透過隱藏重複的日誌行來提供幫助。您可以使用幾個不同的重複資料刪除演算法。完全相符項目會在整行完成，日期欄位除外。數字比對會在分割出持續時間、IP 地址等數字之後，在行上完成。Signature 是最積極的重複資料刪除，因為它會去除所有字母和數字，並在剩餘的空格和標點符號上進行比對。 | | 顯示結果順序 | 您可以將收到日誌的順序從預設的遞減順序 （最新先） 變更為遞增順序 （最舊先）。 | ## 下載日誌行 若要以 `txt`或 `json` 格式下載日誌結果，請使用**下載**按鈕。此功能可讓您儲存日誌資料以供進一步分析，或以方便且可存取的格式與他人共用。 ## 日誌結果中繼資訊 您可以在收到的日誌行上方找到基本中繼資訊，包括： + **收到的日誌數目** – 指出針對目前查詢或時間範圍收到的日誌總數。 + **錯誤** – 在日誌結果中顯示可能的錯誤。 + **一般標籤** – 顯示一般標籤。 + **處理的總位元組**數 – 代表以位元組為單位處理的日誌資料的累積大小。 **注意** 某些中繼資訊的可用性可能取決於資料來源，因此，您可能只會看到某些特定資料來源的詳細資訊。 ## 逸出新行 探索會自動偵測日誌行中某些未正確逸出的序列，例如換行 (`\n`、`\r`) 或標籤 ()`\t`。當它偵測到這類序列時，Explore 會提供**逸出換行**選項。 **自動修正 Explore 偵測到的錯誤逸出序列** 1. 選擇**逸出新行**以取代序列。 1. 手動檢閱替換項目以確認其正確性。 探索會取代這些序列。這麼做時， 選項會從**逸出新行**變更為**移除逸出**。評估變更，因為剖析可能無法根據收到的輸入準確。您可以選取**移除逸出**來還原替換項目。 ## 日誌層級 對於指定`level`標籤的日誌，我們會使用此標籤的值來決定日誌層級，並相應地更新每個日誌行的顏色。如果日誌沒有指定的層級標籤，我們會嘗試查明其內容是否符合任何支援的表達式 （如需詳細資訊，請參閱下表）。日誌層級一律由第一個相符項目決定。如果 Grafana 無法推斷日誌層級欄位，則會使用未知的日誌層級將其視覺化。 **注意** 如果您使用 Loki 資料來源，且 `level`是日誌列的一部分，則可以使用剖析器 (JSON、logfmt、regex..) 將關卡資訊擷取到用於判斷關卡值的關卡標籤。這將允許長條圖將各種日誌層級顯示為單獨的長條。 **支援的日誌層級和日誌層級縮寫和表達式的映射：** | 日誌層級 | 顏色 | 支援的表達式 | | --- | --- | --- | | 關鍵 | 紫色 | emerg， fatal， alert， crit， critical | | error | 紅色 | err、eror、錯誤 | | warning | 黃色 | 警告、警告 | | info | 綠色 | 資訊、資訊、資訊、通知 | | 偵錯 | 藍色 | dbug、偵錯 | | 追蹤 | 淺藍色 | 追蹤 | | 不明 | 灰色 | \$1 | ## 反白搜尋的單字 當您的查詢包含要搜尋的特定單字或表達式時，Explore 會在日誌列中反白這些單字或表達式，以獲得更好的可見性。此反白功能可讓您更輕鬆地識別和專注於日誌中的相關內容。 **注意** 反白搜尋字詞的功能可能會因資料來源而有所不同。對於某些資料來源，可能無法使用搜尋字詞的反白。 ## 日誌詳細資訊檢視 在探索中，每個日誌行都有一個稱為*日誌詳細資訊*的可擴展區段，可以透過選擇日誌行開啟。日誌詳細資訊檢視以連接到日誌行*的欄位*和*連結*形式提供其他資訊和探索選項，從而實現更強大的互動和分析。 **欄位** 在日誌詳細資訊檢視中，您可以透過兩種方式篩選顯示的欄位：正面篩選條件 （專注於特定欄位） 和負面篩選條件 （排除特定欄位）。這些篩選條件會更新產生日誌行的對應查詢，並相應地新增等式和不等式表達式。如果資料來源支援，如同 Loki 和 OpenSearch 的情況，日誌詳細資訊將檢查目前查詢中是否已存在 欄位，顯示 和作用中狀態 （僅適用於正面篩選條件），允許您將其切換為關閉查詢，或將篩選條件表達式從正面變更為負面。 您可以按一下眼睛圖示，在日誌清單中選取要視覺化的欄位子集，而不是完整的日誌行。每個欄位都有一個統計資料圖示，可顯示與所有顯示日誌相關的統計資料。 **連結** Grafana 提供資料連結或相互關聯的功能，可讓您將日誌訊息的任何部分轉換為內部或外部連結。這些連結可用來導覽至相關資料或外部資源，提供無縫且方便的方式來探索進一步資訊。 ## 日誌內容 日誌內容會顯示與特定搜尋查詢相符的日誌項目相關的額外內容行。這有助於了解日誌項目的內容，並且類似於 `grep`命令中的 `-C` 參數。 您可能會遇到長行文字，使得難以讀取和分析每個日誌項目的內容。這是**包裝線**切換可以方便使用的位置。透過啟用此切換，Grafana 會自動包裝長行文字，使其符合檢視器的可見寬度。這可讓您更輕鬆地閱讀和了解日誌項目。 在**分割檢視中開啟**按鈕可讓您在探索檢視的分割畫面中執行日誌項目的內容查詢。選擇此按鈕會開啟新的探索窗格，其中包含與日誌項目一起顯示的內容查詢，讓您更輕鬆地分析和了解周圍的內容。 您也可以在新的瀏覽器索引標籤中開啟日誌內容查詢，方法是在選擇按鈕以開啟內容模式時，按下 `Ctrl`（或 `Cmd`) 鍵。在新標籤中開啟時，先前選取的篩選條件也會套用。 ## 複製日誌行 您可以透過選擇複製日誌列按鈕，輕鬆將所選**日誌列的內容複製到**剪貼簿。 ## 將連結複製到日誌行 在 Grafana 中連結日誌行可讓您快速導覽至特定日誌項目以進行精確分析。透過選擇日誌行的**複製短連結**按鈕，您可以產生和複製簡短 URL，以便在絕對時間範圍內直接存取確切的日誌項目。當您開啟連結時，Grafana 會自動捲動至對應的日誌行，並以藍色背景反白顯示它，讓您輕鬆識別並專注於相關資訊。 **注意** 這僅在 Loki 和提供 `id` 欄位的其他資料來源中受支援。 ## 即時結尾 若要從支援的資料來源檢視即時日誌，您可以利用 探索中的即時結尾功能。 **使用即時結尾即時檢視日誌** 1. 選擇探索工具列中的**即時**按鈕，以切換至即時結尾檢視。 1. 在即時結尾檢視中，新日誌會從畫面底部顯示，而且它們會有淡淡的對比背景，讓您可以輕鬆追蹤新內容。 1. 如果您想要暫停即時結尾並探索先前的日誌，而不會有任何中斷，您可以選擇**暫停**按鈕，或直接捲動日誌檢視。 1. 若要清除檢視並從顯示中移除所有日誌，請選擇**清除日誌**按鈕。此動作會重設日誌檢視，並提供您乾淨的 Slate 以繼續您的日誌分析。 1. 若要繼續即時結尾並繼續檢視即時日誌，請選擇**繼續**按鈕。 1. 如果您想要結束即時結尾並返回標準探索檢視，請選擇**停止**按鈕。 使用即時結尾功能，您可以密切關注最新的日誌，讓您更輕鬆地監控即時事件並快速偵測問題。 **日誌範例** 如果選取的資料來源實作日誌範例，並同時支援日誌和指標查詢，則對於指標查詢，您可以自動查看導致視覺化指標的日誌行範例。Loki 資料來源目前支援此功能。 **從指標切換至日誌** 如果您來自實作 `DataSourceWithQueryExportSupport`（例如 Prometheus) 至支援 `DataSourceWithQueryImportSupport`（例如 Loki) 之記錄資料來源的指標資料來源，則會保留存在於日誌中查詢的標籤，並使用這些標籤來查詢日誌串流。 例如，下列 Prometheus 查詢在切換到 Loki 資料來源`grafana_alerting_active_alerts{job='grafana'}`後會變更為 `{job='grafana'}`。這將傳回所選時間範圍中的日誌區塊，這些日誌可進行 grepped/text 搜尋。 # 探索中的追蹤 **** 本文件主題專為支援 Grafana **10.x 版的 Grafana** 工作區而設計。 如需支援 Grafana 9.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 9 版](using-grafana-v9.md)。 如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 8 版](using-grafana-v8.md)。 您可以使用探索來視覺化來自追蹤資料來源的追蹤。 支援下列資料來源。 + [Tempo](tempo-data-source.md) （支援的擷取格式：OpenTelemetry、Jaeger 和 Zipkin) + [Jaeger](jaeger-data-source.md) + [AWS X-Ray](x-ray-data-source.md) + [Zipkin](zipkin-data-source.md) 如需有關如何為上述資料來源設定查詢的資訊，請參閱特定資料來源的文件。 ## 查詢編輯器 您可以使用資料來源的查詢編輯器來查詢和搜尋追蹤資料。 每個資料來源都可以有自己的查詢編輯器。Tempo 資料來源的查詢編輯器與 Jaeger 資料來源的查詢編輯器略有不同。 如需查詢每個資料來源的資訊，請參閱其文件。 + [Tempo](tempo-data-source.md) + [Jaeger](jaeger-data-source.md) + [AWS X-Ray](x-ray-data-source.md) + [Zipkin](zipkin-data-source.md) ## 追蹤檢視說明 本節說明追蹤檢視儀表板的元素。 **標頭** 追蹤檢視的 標頭具有下列元素： + 標題 – 顯示根範圍和追蹤 ID 的名稱。 + 搜尋 – 反白包含搜尋文字的範圍。 + 中繼資料 – 有關追蹤的各種中繼資料。 **最小映射** 顯示精簡檢視或追蹤時間軸。將指標拖曳到小地圖上，以放大較小的時間範圍。縮放也會更新主要時間軸，因此很容易看到較短的跨度。將滑鼠游標移到小地圖上時，縮放時會顯示**重設選擇**按鈕，以重設縮放。 **跨度篩選條件** 使用跨度篩選條件，您可以在追蹤時間軸檢視器中篩選您的跨度。您新增的篩選條件越多，篩選的範圍就越具體。 您可以新增下列一或多個篩選條件： + 資源服務名稱 + 範圍名稱 + 持續時間 + 標籤 （包括標籤、程序標籤和日誌欄位） 若要僅顯示您已相符的範圍，請選擇**僅顯示相符**項目切換。 **時間軸** 顯示追蹤內的跨度清單。每個跨度列都包含下列元件： + 展開子項按鈕 – 展開或摺疊所選範圍的所有子項。 + 服務名稱 – 記錄跨度的服務名稱。 + 操作名稱 – 此跨度代表的操作名稱。 + 範圍持續時間列 – 追蹤內操作持續時間的視覺化表示。 **跨度詳細資訊** 選擇跨度列會顯示跨度詳細資訊，包括下列項目。 + 操作名稱 + 跨度中繼資料 + 標籤 – 與此跨度相關聯的任何標籤。 + 程序中繼資料 – 記錄此範圍之程序的中繼資料。 + 日誌 – 此範圍所記錄的日誌清單和相關聯的索引鍵值。如果是 Zipkin 日誌區段，會顯示 Zipkin 註釋。 **追蹤至日誌** 您可以從追蹤檢視中的範圍直接導覽至與該範圍相關的日誌。這適用於 Tempo、Jaeger 和 Zipkin 資料來源。如需如何設定每個資料來源的說明，請參閱其相關文件。 選擇文件圖示，以使用設定的資料來源在探索中開啟分割檢視，並查詢範圍的相關日誌。 **追蹤指標** **注意** 此功能目前為 Beta 版 您可以在追蹤檢視中直接導覽到與該範圍相關的指標。此功能適用於 Tempo、Jaeger 和 Zipkin 資料來源。如需組態的詳細資訊，請參閱其相關文件。 **追蹤至設定檔** 使用追蹤至設定檔，您可以新增功能以在追蹤和設定檔之間連結，藉此使用 Grafana 關聯不同訊號的能力。 ## 節點圖形 您可以選擇性地展開所顯示追蹤的節點圖形。根據資料來源，這可以在圖表中將追蹤的範圍顯示為節點，或新增一些額外的內容，包括基於目前追蹤的服務圖表。 ## 服務圖表檢視 Service Graph 檢視可視覺化跨度指標 （針對速率、錯誤率和持續時間 (RED) 追蹤資料） 和服務圖表。設定需求後，即可立即使用此預先設定的檢視。 如需詳細資訊，請參閱 [Tempo](tempo-data-source.md) 資料來源頁面。您也可以在 *Grafana Labs Tempo 文件中*查看[服務圖表檢視頁面](https://grafana.com/docs/tempo/latest/metrics-generator/service-graph-view/)。 ## Data API (資料 API) 此視覺化需要從資料來源傳回特定形狀的資料，才能正確顯示資料。 資料來源需要傳回資料框架並設定 `frame.meta.preferredVisualisationType = 'trace'`。 **資料框架結構** 必要欄位； | 欄位名稱 | Type | 說明 | | --- | --- | --- | | traceID | string | 整個追蹤的識別符。資料框架中應該只有一個追蹤。 | | spanID | string | 目前跨度的識別符。每個追蹤SpanIDs 應該是唯一的。 | | parentSpanID | string | 父系範圍的 SpanID，以在追蹤檢視中建立子系父系關係。可以undefined用於沒有父系的根跨度。 | | serviceName | string | 此範圍所屬服務的名稱。 | | serviceTags | TraceKeyValuePair【】 | 與服務相關的標籤清單。 | | startTime | number | 跨度的開始時間，以毫秒 epoch 時間為單位。 | | 持續時間 | number | 跨度的持續時間，以毫秒為單位。 | 選用欄位： | 欄位名稱 | Type | 說明 | | --- | --- | --- | | 日誌 | TraceLog【】 | 與目前範圍相關聯的日誌清單。 | | 標籤 | TraceKeyValuePair【】 | 與目前範圍相關聯的標籤清單。 | | warnings | string【】 | 與目前範圍相關聯的警告清單。 | | stackTraces | string【】 | 與目前範圍相關聯的堆疊追蹤清單。 | | errorIconColor | string | 使用 標記跨度時的錯誤圖示顏色error: true。 | 如需類型的詳細資訊，請參閱 GitHub 上的 [TraceSpanRow](https://github.com/grafana/grafana/blob/main/packages/grafana-data/src/types/trace.ts#L28)、[TraceKeyValuePair](https://github.com/grafana/grafana/blob/main/packages/grafana-data/src/types/trace.ts#L4) 和 [TraceLog](https://github.com/grafana/grafana/blob/main/packages/grafana-data/src/types/trace.ts#L12)。 # 探索中的關聯編輯器 **** 本文件主題專為支援 Grafana **10.x 版的 Grafana** 工作區而設計。 如需支援 Grafana 9.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 9 版](using-grafana-v9.md)。 如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 8 版](using-grafana-v8.md)。 關聯可讓使用者在任何兩個資料來源之間建立連結。如需詳細資訊，包括相互關聯概觀，請參閱 [Grafana 第 10 版中的相關性](v10-correlations.md)。 ## 建立相互關聯 您可以從探索頁面建立關聯性。 **建立相互關聯** 1. 在您的 Amazon Managed Grafana 工作區中，導覽至探索頁面。 1. 選取您想要成為新相互關聯來源的資料來源。 1. 在支援的視覺化中執行產生資料的查詢。 **注意** 支援的視覺化效果是[日誌](v10-panels-logs.md)和[資料表](v10-panels-table.md)。 1. 在頂端工具列中選擇 **\$1 新增**，然後選取**新增關聯 **（您也可以從[命令面板](v10-search.md#v10-search-palette)中選取**關聯編輯器**。 探索現在處於藍色邊界和頂端列指示的關聯編輯器模式。您可以在頂端列中選擇**結束**來結束關聯編輯器。 1. 您現在可以使用連接到資料的連結來建立視覺化的下列新關聯，以建立新的查詢： + *日誌* – 每個日誌資料列日誌詳細資訊內的欄位值旁會顯示連結。 + *資料表* – 每個資料表儲存格都是連結。 1. 選擇連結以新增相互關聯。連結與做為相互關聯結果欄位的欄位相關聯。如需詳細資訊，請參閱[關聯性組態](v10-correlations-config.md)。 1. 在開啟的分割檢視中，使用右窗格來設定相互關聯的目標查詢來源。如需詳細資訊，請參閱[目標查詢](v10-correlations-config.md#v10-correlations-config-target-query)。 1. 使用[變數語法](v10-dash-variable-syntax.md)搭配窗格頂端提供的清單中的變數來建置目標查詢。清單包含所選資料列的範例值。 1. 提供標籤和描述 （選用）。標籤將用作視覺化內連結的名稱，並且可以包含變數。 1. 提供轉換 （選用；如需詳細資訊，請參閱以下內容）。 1. 選擇頂端工具列中的**儲存**，以儲存相互關聯並結束相互關聯編輯器模式。用來建立相互關聯的連結會替換為每一列中的資料連結。選取連結時，您定義的查詢將在另一個窗格中執行，變數會以所選資料列中的值動態取代。 ## 轉換 轉換可讓您使用其他資料擷取存在於欄位中的值。例如，使用轉換，您可以擷取日誌行的一部分以用於相互關聯。如需相互關聯中轉換的詳細資訊，請參閱 [相關性轉換](v10-correlations-config.md#v10-correlations-config-transformations)。 在編輯器模式中選擇其中一個產生的連結後，您可以在轉換下拉式功能表中選取**新增轉換**來新增**轉換**。 **在相互關聯中使用轉換** 1. 選取要套用轉換的欄位。選取您要用於轉換的欄位部分。例如，日誌行。選取後，此欄位的值將用於協助您建置轉換。 1. 選取轉換的類型。如需選項和相關設定[相關性轉換](v10-correlations-config.md#v10-correlations-config-transformations)，請參閱 。 1. 根據您的選擇，您可能會看到一個或多個變數填入，或者您可能需要在顯示的選項中提供更多規格。 1. 選取**新增轉換至關聯**性，將指定的變數新增至可用變數清單。 **注意** 對於此對話方塊中的規則表達式，`Variable Name`此處會呼叫其他文件中`mapValue`提及的 。Grafana 會反白任何符合欄位值中表達式的文字。使用規則表達式擷取群組來選取應擷取配對的哪個部分。提供有效的規則表達式時，變數 和該變數的值會顯示在 `Variable Name` 欄位下方。 ## 關聯範例 下列範例示範如何使用 探索中的關聯編輯器建立關聯。如果您想要遵循這些範例，請務必設定[測試資料來源](testdata-data-source.md)。 ### 建立文字以繪製相互關聯 此範例說明如何在探索中使用關聯編輯器建立關聯。 關聯可讓您使用一個查詢的結果，在任何資料來源中執行新的查詢。在此範例中，您將執行呈現表格式資料的查詢。資料將用於執行產生圖形結果的不同查詢。 若要遵循此範例，請確定您已設定[測試資料來源](testdata-data-source.md)。 **建立文字以繪製相互關聯** 1. 在 Grafana 中，導覽至**探索**。 1. 從頁面左上方的下拉式選單中選取**測試資料來源**。 1. 在右側的下拉式選單中選擇 **\$1 新增**，然後選取**新增關聯**性。 1. 探索現在處於關聯編輯器模式，以藍色邊界表示。 1. 從案例下拉式選單中選取下列案例：**CSV 檔案**。 1. 選取檔案 **population\$1by\$1state.csv**。每個儲存格都是您可以按一下的連結，以開始建立新的相互關聯。 1. 按一下`State`欄中的任何儲存格，以建立新的相互關聯，將資料連結連接至該項目。例如，選取 `California`。 1. 在分割檢視中，選取您在左側窗格中選取的相同資料來源。查詢編輯器上方的協助程式包含您可以使用目標查詢的所有可用變數。變數包含所選資料列中的所有資料欄位 （資料表資料欄）。 1. 在**案例**功能表中，選取 **CSV 指標值**。查詢編輯器中的 `String Input` 欄位提供具有每年人口值的變數：`${1980},${2000},${2020}`。這將使用變數值產生圖形。 1. 在查詢編輯器**別名**欄位中，輸入 `${State}`。 執行查詢，查看它使用變數中的範例值產生圖形。 1. 選擇**儲存**以儲存關聯並結束關聯編輯器。 儲存相互關聯後，Explore 將在左側窗格中重新執行查詢。透過按一下狀態名稱，右側的查詢會以插入 CSV 的資料列中的值重新執行，進而變更圖形。每次按一下狀態名稱時，都會以更新的值重新執行查詢。 您可以將相同的步驟套用至任何資料來源。關聯可讓您在視覺效果中建立連結，以根據選取的資料執行動態查詢。在此範例中，我們使用查詢傳回的資料，來建置使用相同資料來源產生不同視覺化效果的新查詢。不過，您可以在任何資料來源之間建立關聯，以建立自訂探勘流程。 ### 建立日誌與資料表的相互關聯 在此範例中，您將建立相互關聯，示範如何使用轉換從日誌行和另一個欄位擷取值。 若要遵循此範例，請確定您已設定[測試資料來源](testdata-data-source.md)。 **建立日誌與資料表的相互關聯** 1. 在 Grafana 中，導覽至**探索**。 1. 從頁面左上方的下拉式選單中選取**測試資料來源**。 1. 在右側的下拉式選單中選擇 **\$1 新增**，然後選取**新增關聯**性。 1. 探索現在處於關聯編輯器模式，以藍色邊界表示。 1. 在**案例**功能表中，選取**日誌**。 1. 展開日誌行以查看相互關聯連結。選取 `Correlate with hostname`。 1. 探索會在分割檢視中開啟。選取您在左側窗格中選取的相同資料來源。查詢編輯器上方的協助程式包含您可以使用目標查詢的所有可用變數。 1. 展開轉換區段，然後按一下**新增轉換**。 1. 在**欄位**下拉式功能表中，選取**訊息**。日誌行會顯示為範例資料。 1. 在**類型**下，選取 **Logfmt**。這會填入變數清單。 1. 選擇**將轉換新增至相互關聯**。 1. 再次選擇**新增轉換**，然後在**欄位**下，選取**主機名稱**。 1. 在**類型**下，選取**規則表達**式。 1. 在**表達式**下，輸入下列項目：`-([0-9]\*)`。這會選取破折號右側的任何數字。 1. 在**變數名稱**下，輸入下列項目：`hostNumber`。這會填入變數清單。 1. 選擇**新增轉換至關聯**性，將其新增至其他變數。 1. 在資料來源編輯器中，開啟**案例**下拉式功能表，然後選取 **CSV 內容**。 1. 在下面的文字方塊中，提供以下內容並儲存相互關聯性： ``` time,msg,hostNumber,status ${time},${msg},${hostNumber},${status} ``` 這會關閉分割檢視並重新執行左側查詢。展開任何日誌行以查看相互關聯按鈕。選擇相互關聯按鈕會開啟分割檢視，其中包含 `time`（欄位）、 `msg` （從日誌列擷取 *logfmt*)、 `host number` （從 擷取 *regex*`hostname`) 和 `status`（從日誌列擷取 *logfmt*)。 # 探索中的檢查器 **** 本文件主題專為支援 Grafana **10.x 版的 Grafana** 工作區而設計。 如需支援 Grafana 9.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 9 版](using-grafana-v9.md)。 如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 8 版](using-grafana-v8.md)。 檢測器可協助您了解查詢並進行疑難排解。您可以檢查原始資料、將該資料匯出至逗號分隔值 (CSV) 檔案、以 TXT 格式匯出日誌結果，以及檢視查詢請求。 ## Inspector UI 檢測器具有下列標籤： + **統計資料索引標籤** – 顯示查詢需要多長時間，以及傳回多少。 + **查詢索引標籤** – 顯示 Grafana 查詢資料來源時傳送至伺服器的請求。 + **JSON 索引標籤** – 可讓您檢視和複製資料 JSON 和資料框架結構 JSON。 + **資料索引標籤** – 顯示查詢傳回的原始資料。 + **錯誤索引標籤** – 顯示錯誤。只有在查詢傳回錯誤時才會顯示。 ## Inspector 任務 您可以在探索檢查器中執行各種任務。 **開啟檢查器** 執行您要檢查的查詢之後，請選取**檢查器**按鈕。 檢測器窗格會在畫面底部開啟。 **檢查原始查詢結果** 您可以檢視原始查詢結果，也就是查詢在資料表中傳回的資料。 在**檢查程式**索引標籤中，按一下**資料**索引標籤。 對於多個查詢或查詢多個節點，還有其他選項。 + **顯示資料框架：**選取您要檢視的結果集資料。 + **依時間聯結的序列：**一次檢視所有查詢的原始資料，每欄一個結果集。您可以按一下欄標題來排序資料。 **將原始查詢結果下載為 CSV** Grafana 會在您的預設瀏覽器下載位置中產生 CSV 檔案。您可以在您選擇的檢視器中開啟它。 1. 在**檢查器**索引標籤中，依照上述指示取得原始查詢結果。 1. 縮小查詢設定，直到您可以看到要匯出的原始資料為止。 1. 選擇**下載 CSV**。 若要下載專為 Excel 格式化的 CSV 檔案，請展開**資料選項**，然後在選取下載 **CSV** 選項之前開啟**下載 Excel **切換。 **將日誌結果下載為 TXT** 您可以在 **Inspector** 索引標籤中選取**下載**日誌，以產生您目前檢視之日誌的 TXT 檔案。 **下載追蹤結果** 根據資料來源類型，Grafana 會以其中一種支援的格式產生追蹤結果的 JSON 檔案：Jaeger、Zipkin 或 OTLP 格式。 1. 開啟 Inspector。 1. 檢查日誌查詢結果。精簡結果，直到您看到要匯出的原始日誌為止。 1. 選擇**下載日誌**。 **檢查查詢效能** **統計資料**索引標籤會顯示統計資料，告訴您查詢需要多長時間、傳送多少查詢，以及傳回的資料列數。此資訊可協助您對查詢進行疑難排解，尤其是在任何數字意外過高或過低的情況下。 統計資料會以唯讀格式顯示。 **檢視 JSON 模型** 您可以探索和匯出資料以及資料框架 JSON 模型。 **檢視 JSON 模型** 1. 在檢查程式面板中，按一下 **JSON** 標籤。 1. 從**選取來源**下拉式清單中，選擇下列其中一個選項： + **資料** – 顯示 JSON 物件，代表傳回給探索的資料。 + **DataFrame 結構** – 顯示原始結果集。 1. 您可以展開或摺疊 JSON 的部分，以檢視個別區段。您也可以選取**複製到剪貼簿**選項，以複製 JSON 內文並將其貼到另一個應用程式。 **檢視對資料來源的原始請求和回應** 當您使用 Explore 和 Inspector 索引標籤時，您可以檢視使用查詢產生的原始請求和回應資料。在檢查器中，選取**查詢**索引標籤，然後選擇**重新整理**以查看原始資料。 Grafana 會將查詢傳送至伺服器並顯示結果。您可以向下切入查詢的特定部分、展開或摺疊所有部分，或將資料複製到剪貼簿，以便在其他應用程式中使用。