本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # 連線至 Amazon OpenSearch Service 資料來源 **注意** 在支援第 9 版或更新版本的工作區中，此資料來源可能會要求您安裝適當的外掛程式。如需詳細資訊，請參閱[使用外掛程式擴展您的工作區](grafana-plugins.md)。 使用 Amazon Managed Grafana，您可以使用 Grafana 工作區主控台中的 AWS 資料來源組態選項，將 Amazon OpenSearch Service 新增為資料來源。此資料來源支援執行 OpenSearch 叢集和舊版 Elasticsearch 叢集的 OpenSearch Service 網域。 AWS 資料來源組態選項可探索現有的 OpenSearch Service 帳戶，簡化將 OpenSearch Service 新增為資料來源的程序，並管理存取 OpenSearch 所需的身分驗證憑證組態。您可以使用此方法設定身分驗證，並將 OpenSearch Service 新增為資料來源，或者您可以使用與自我管理 Grafana 伺服器上相同的方法手動設定資料來源和必要的身分驗證憑證。 OpenSearch Service 資料來源支援管道處理語言 (PPL)。如需 PPL 的詳細資訊，請參閱[使用 Piped Processing Language 查詢 Amazon OpenSearch Service 資料](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/ppl-support.html)。 您可以使用 OpenSearch Service 資料來源來執行許多類型的簡單或複雜的 OpenSearch 查詢，以視覺化儲存在 OpenSearch 中的日誌或指標。您也可以使用儲存在 OpenSearch 中的日誌事件來註釋圖表。 **Topics** + [ # 使用 AWS 資料來源組態將 OpenSearch Service 新增為資料來源 ](ES-adding-AWS-config.md) + [ # 手動新增 Amazon OpenSearch Service 作為資料來源 ](ES-adding-the-data-source.md) + [ ## OpenSearch Service 設定 ](#ES-settings) + [ # 使用 Amazon OpenSearch Service 資料來源 ](ES-use-datasource.md) + [ # Amazon OpenSearch Service Serverless ](datasources-opensearch-serverless.md) + [ # 追蹤支援 ](datasources-opensearch-traces.md) # 使用 AWS 資料來源組態將 OpenSearch Service 新增為資料來源 若要使用 AWS 資料來源組態，請先使用 Amazon Managed Grafana 主控台來啟用服務受管 IAM 角色，以授予工作區讀取您帳戶或整個組織單位中 OpenSearch Service 資源所需的 IAM 政策。然後，您可以使用 Amazon Managed Grafana 工作區主控台將 OpenSearch Service 新增為資料來源。 **使用 AWS 資料來源組態將 OpenSearch Service 新增為資料來源** 1. 開啟位於 https：//[https://console.aws.amazon.com/grafana/](https://console.aws.amazon.com/grafana/home/) 的 Amazon Managed Grafana 主控台。 1. 選擇頁面左上角的功能表圖示，然後選擇**所有工作區**。 1. 選擇工作區的名稱。 1. 如果您在建立工作空間時未選擇對此工作空間使用服務受管許可，則從使用客戶受管許可變更為使用服務受管許可，以確保在 Grafana 工作空間主控台中使用 AWS 資料來源組態選項啟用適當的 IAM 角色和政策。若要這樣做，請選擇依 **IAM 角色**編輯圖示，然後選擇**服務受管**、**儲存變更**。如需詳細資訊，請參閱[AWS 資料來源的 Amazon Managed Grafana 許可和政策](AMG-manage-permissions.md)。 1. 選擇**資料來源**索引標籤。然後選取 **Amazon OpenSearch Service** 的核取方塊，然後選擇**動作**、**啟用服務受管政策**。 1. 再次選擇**資料來源**索引標籤，然後在 **Amazon OpenSearch Service** 列中選擇在 **Grafana 中設定**。 1. 如有必要，請使用 IAM Identity Center 登入 Grafana 工作區主控台。 1. 在 Grafana 工作區主控台的左側導覽列中，選擇 AWS 圖示，然後選擇**AWS 服務** **Amazon OpenSearch Service**。 1. 選取您希望 Amazon Managed Grafana 搜尋以探索 OpenSearch Service 資源的區域，然後選取您要新增的帳戶和 OpenSearch Service 網域、設定索引設定，然後選擇**新增資料來源**。 # 手動新增 Amazon OpenSearch Service 作為資料來源 **手動新增 Amazon OpenSearch Service 資料來源** 1. 在 Grafana 主控台側邊選單中，選擇 **AWS** 圖示，然後選擇**資料來源**。 1. 選擇 **Amazon OpenSearch Service** 資料來源。如有必要，您可以開始**OpenSearch**在搜尋方塊中輸入 ，以協助您找到它。 1. 選擇您要從中搜尋資料**的區域**。 1. 選擇**新增資料來源**。 **注意** 如果您在側邊選單中看不到**資料來源**連結，表示您目前的使用者沒有 `Admin`角色。 ## OpenSearch Service 設定 | 名稱 | 描述 | | --- | --- | | Name | 資料來源名稱。這是您在面板和查詢中查看資料來源的方式。 | | Default | 預設資料來源表示新面板會預先選取該資料來源。 | | Url | OpenSearch Service 網域的端點。端點採用下列格式：https：//https://search-my-domain.us-east-1.es.amazonaws.com。 | | Access | 伺服器 （預設） = URL 必須可從 Grafana 後端/伺服器存取。瀏覽器 = URL 必須可從瀏覽器存取。 | 存取模式控制將如何處理對資料來源的請求。如果未說明其他項目，伺服器應該是偏好的方式。 ### 伺服器存取模式 （預設） 所有請求都是從瀏覽器向 Grafana 後端或伺服器提出，其會將請求轉送至資料來源，以規避可能的跨來源資源共享 (CORS) 要求。如果您選擇此存取模式，則必須從 Grafana 後端或伺服器存取 URL。 ### 瀏覽器 （直接） 存取 Amazon Managed Grafana 不支援瀏覽器直接存取。 ### 索引設定 您可以在這裡為 指定預設值，`time field`並指定 OpenSearch 索引的名稱。您可以使用索引名稱或萬用字元的時間模式。 ### OpenSearch/Elasticsearch 版本 在版本下拉式選單中指定您的 OpenSearch 或舊版 Elasticsearch 版本。版本很重要，因為每個版本的查詢撰寫方式有所不同。目前，Grafana 支援 OpenSearch 1.0.x。支援的 Elasticsearch 版本為 `2.0+`、`5.0+`、`6.0+`、 `5.6+`和 `7.0+`。此值`5.6+`表示 5.6 版或更新版本，但低於 6.0。此值`6.0+`表示 6.0 版或更新版本，但低於 7.0。最後， `7.0+`表示 7.0 版或更新版本，但低於 8.0。 ### 最短時間間隔 依時間間隔分類的自動群組下限。建議設定為寫入頻率；例如，`1m`如果您的資料每分鐘寫入一次。也可以在資料來源選項下的儀表板面板中覆寫/設定此選項。此值的格式**必須是**數字，後面接著有效的時間識別符；例如 `1m`(1 分鐘） 或 `30s`(30 秒）。支援下列時間識別符。 | 識別符 | Description | | --- | --- | | y | 年 | | M | 月 | | w | 週 | | d | 天 | | h | 小時 | | m | 分鐘 | | s | 秒 | | ms | 毫秒 | ### 日誌 在 中視覺化日誌時`Level field name`，可以從資料來源設定頁面選擇性地設定兩個參數 `Message field name`和 ，以決定哪些欄位將用於日誌訊息和日誌層級[探索](explore.md)。 例如，如果您使用 Filebeat 的預設設定將日誌運送到 OpenSearch Service，則下列組態應該可以運作。 + **訊息欄位名稱：**訊息 + **層級欄位名稱：**Fields.level ### 資料連結 資料連結會從可在探索日誌檢視中存取的指定欄位建立連結。 每個資料連結組態都包含下列項目： + **欄位** – 資料連結所使用的欄位名稱。 + **URL/查詢 ** – 如果連結是外部連結，請輸入完整的連結 URL。如果連結是內部連結，則此輸入會做為目標資料來源的查詢。在這兩種情況下，您可以將 欄位的值插入`${__value.raw }`巨集。 + **內部連結** – 如果連結是內部或外部，請選取此選項。如果連結是內部連結，則資料來源選取器可讓您選取目標資料來源。僅支援追蹤資料來源。 # 使用 Amazon OpenSearch Service 資料來源 ## 指標查詢編輯器 OpenSearch 查詢編輯器可讓您依多個詞彙或篩選條件選取多個指標和群組。使用右側的加號和減號圖示，依子句新增/移除指標或群組。有些指標和依子句分組都有選項。選擇選項文字以展開\$1 列，以檢視和編輯指標或依選項分組。 ## 使用管道處理語言 (PPL) Amazon OpenSearch Service 資料來源支援 Piped Processing Language (PPL)，可為 OpenSearch 啟用更簡單但強大的查詢和視覺化功能。PPL 可讓客戶探索和尋找資料，而不必撰寫冗長的 OpenSearch Domain Specific Language (DSL) 陳述式或使用 JSON 物件寫入查詢。使用 PPL，您可以將查詢撰寫為一組以類似 UNIX 管道的管道分隔的命令。 以下列範例 DSL 查詢為範例： ``` GET opensearch_sample_data_logs/_search{"from":0,"size":0,"timeout":"1m","query":{"bool":{"should":[{"term":{"response.keyword":{"value":"404","boost":1}}},{"term":{"response.keyword":{"value":"503","boost":1}}}],"adjust_pure_negative":true,"boost":1}},"sort":[{"_doc":{"order":"asc"}}],"aggregations":{"composite_buckets":{"composite":{"size":1000,"sources":[{"host":{"terms":{"field":"host.keyword","missing_bucket":true,"order":"asc"}}},{"response":{"terms":{"field":"response.keyword","missing_bucket":true,"order":"asc"}}}]},"aggregations":{"request_count":{"value_count":{"field":"request.keyword"}},"sales_bucket_sort":{"bucket_sort":{"sort":[{"request_count":{"order":"desc"}}],"size":10}}}}}}> ``` 上述 DSL 查詢可以取代為下列 PPL 命令，該命令簡潔且可人類讀取。 ``` source = opensearch_sample_data_logs | where response='404' or response='503' | stats count(request) as request_count by host, response | sort –request_count ``` 如需 PPL 的詳細資訊，請參閱[使用 Piped Processing Language 查詢 Amazon OpenSearch Service 資料](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/ppl-support.html)。 ## 系列命名和別名模式 您可以使用`Alias`輸入欄位來控制時間序列的名稱。 | 模式 | Description | | --- | --- | | \$1\$1term fieldname\$1\$1 | 以 Group By 一詞的值取代。 | | \$1\$1metric\$1\$1 | 以指標名稱 （例如 平均值、最小值、最大值）。 | | \$1\$1field\$1\$1 | 以指標欄位名稱取代。 | ## 管道指標 有些指標彙總稱為管道彙總，例如*移動平均*和*衍生*。OpenSearch 管道指標需要根據另一個指標。使用指標旁的眼睛圖示，隱藏指標不出現在圖形中。這對於您在查詢中只有用於管道指標的指標很有用。 ## 範本化 您可以在指標查詢中使用變數，而不是硬式編碼，例如伺服器、應用程式和感應器名稱。變數會顯示為儀表板頂端的下拉式清單選取方塊。您可以使用這些下拉式方塊來變更儀表板中顯示的資料。 如需範本和範本變數的詳細資訊，請參閱 [範本和變數](templates-and-variables.md)。 ### 查詢變數 OpenSearch Service 資料來源支援兩種類型的查詢，您可以在*查詢*變數的*查詢*欄位中使用。查詢是使用自訂 JSON 字串撰寫。 | Query | Description | | --- | --- | | \$1"find": "fields", "type": "keyword"\$1 | 傳回索引類型為 的欄位名稱清單keyword。 | | \$1"find": "terms", "field": "@hostname", "size": 1000\$1 | 使用詞彙彙總傳回欄位的值清單。查詢將使用目前的儀表板時間範圍做為查詢的時間範圍。 | | \$1"find": "terms", "field": "@hostname", "query": ''\$1 | 使用詞彙彙總和指定的 Lucene 查詢篩選條件，傳回欄位的值清單。查詢將使用目前的儀表板時間範圍做為查詢的時間範圍。 | 詞彙查詢的預設大小限制為 500。若要設定自訂限制，請在查詢中設定大小屬性。您可以在查詢內使用其他變數。下列程式碼範例顯示名為 之變數的查詢定義`$host`。 ``` {"find": "terms", "field": "@hostname", "query": "@source:$source"} ``` 在上一個範例中，我們使用在查詢定義`$source`內名為 的另一個變數。每當您使用下拉式清單變更`$source`變數的目前值時，就會啟動`$host`變數的更新。更新之後， `$host`變數只會包含由 篩選的主機名稱，在此情況下為`@source`文件屬性。 預設情況下，這些查詢會依詞彙順序傳回結果 （然後，任何變數都可以按字母或數字排序）。若要產生依文件計數排序的詞彙清單 （前 N 個值清單），請新增 的 `orderBy` 屬性`doc_count`。這會自動選取遞減排序。使用 `asc`搭配 doc\$1count (N 底部清單） 可以透過設定 來完成`order: "asc"`，但不建議這麼做，因為它會增加文件計數的錯誤。若要將術語保留在文件計數順序中，請將變數的**排序**下拉式清單設定為**已停用**。或者，您可能仍然想要使用**字母來**重新排序它們。 ``` {"find": "terms", "field": "@hostname", "orderBy": "doc_count"} ``` ### 在查詢中使用變數 有兩種語法： + `$` 範例：@hostname：\$1hostname + `[[varname]]` 範例：@hostname：【【hostname】】 為什麼有兩種方式？ 第一個語法更容易讀取和寫入，但不允許您在單字中間使用變數。啟用*多值*或*包含所有值*選項時，Grafana 會將標籤從純文字轉換為 Lucene 相容條件。 在先前的範例中，我們有使用名為 的變數，根據 `@hostname` 屬性篩選文件的 lucene 查詢`$hostname`。它也在「依欄位輸入分組*」*方塊中使用變數。這可讓您使用變數來快速變更資料的分組方式。 ## 註釋 註釋可讓您在圖形上方疊加豐富的事件資訊。您可以使用儀表板功能表或註釋檢視來新增註釋查詢。Grafana 可以查詢註釋事件的任何 OpenSearch 索引。如需詳細資訊，請參閱[註釋](dashboard-annotations.md)。 | 名稱 | 描述 | | --- | --- | | Query | 您可以保持搜尋查詢空白，或指定 Lucene 查詢。 | | Time | 時間欄位的名稱；必須是日期欄位。 | | Time End | 時間結束欄位的選用名稱必須是日期欄位。如果設定，註釋將標記為時間和結束時間之間的區域。 | | Text | 事件描述欄位。 | | Tags | 用於事件標籤的選用欄位名稱 （可以是陣列或 CSV 字串）。 | ## 查詢 日誌 從 OpenSearch 查詢和顯示日誌資料可在探索中取得。若要顯示日誌，請選取 OpenSearch Service 資料來源，然後選擇性地輸入 Lucene 查詢。如需詳細資訊，請參閱[探索](explore.md)。 ### 日誌查詢 傳回結果後，日誌面板會顯示日誌資料列清單和長條圖，其中 x 軸顯示時間，y 軸顯示頻率或計數。 ### 篩選日誌訊息 或者，在查詢欄位中輸入 Lucene 查詢來篩選日誌訊息。例如，使用預設的 Filebeat 設定，您應該能夠使用 `fields.level:error` 僅顯示錯誤日誌訊息。 # Amazon OpenSearch Service Serverless **注意** OpenSearch Service Serverless 支援僅適用於執行 Grafana 9.4 版和更新版本的 Grafana 工作區。 您可以使用 OpenSearch Service 資料來源，透過 Amazon Managed Grafana 存取 Amazon OpenSearch Service Serverless 資料。資料的存取是由資料存取政策所控制。下列範例顯示允許使用者查詢特定集合和索引的政策。請務必*`principal_arn`*將 *`collection_name`*、 *`index_name`*和 取代為您的使用案例的正確值。 ``` [ { "Rules": [ { "Resource": ["collection/{collection_name}"], "Permission": ["aoss:DescribeCollectionItems"], "ResourceType": "collection" }, { "Resource": ["index/{collection_name}/{index_name}"], "Permission": ["aoss:DescribeIndex", "aoss:ReadDocument"], "ResourceType": "index" } ], "Principal": ["principal_arn"], "Description": "read-access" } ] ``` # 追蹤支援 OpenSearch 外掛程式支援以資料表形式檢視追蹤清單，並在**追蹤檢視**中檢視單一追蹤，其中顯示追蹤範圍的時間軸。 **注意** 查詢 OpenSearch 追蹤只能使用 Lucene 查詢。 追蹤支援僅適用於支援 9.4 版或更新版本的 Grafana 工作區。 若要建立顯示所有追蹤的查詢，請使用 Lucene 查詢類型`Traces`搭配空白查詢。如有必要，請選取**資料表**視覺化類型。 在資料表中選取追蹤 ID 會在追蹤檢視中開啟該追蹤。 若要建立顯示單一追蹤的查詢，請使用查詢 `traceid: {traceId}`，並視需要選取**追蹤**視覺化類型。