本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
使用自然語言來產生和更新 CloudWatch Logs Insights 查詢
CloudWatch Logs 支援自然語言查詢功能,可協助您產生和更新 CloudWatch Logs Insights 和 CloudWatch Metrics Insights 的查詢。
使用此功能,您可以詢問或描述您要尋找的純英文 CloudWatch 日誌資料。自然語言功能會根據您輸入的提示產生查詢, line-by-line並提供查詢運作方式的說明。也可以更新查詢以進一步調查您的資料。
根據您的環境,您可以輸入提示,例如「傳輸位元組的前 100 個來源 IP 地址是什麼?」 和「尋找 10 個最慢的 Lambda 函數請求。」
注意
自然語言查詢功能通常可在 10 個區域中使用。對於某些區域,此功能會對美國境內的區域進行跨區域呼叫,以處理查詢提示。下表列出支援的 區域,並顯示每個區域處理其提示的位置。
支援的區域 | 處理提示的區域 |
---|---|
美國東部 (維吉尼亞北部) |
美國東部 (維吉尼亞北部) |
美國東部 (俄亥俄) |
美國東部 (維吉尼亞北部) |
美國西部 (奧勒岡) |
美國西部 (奧勒岡) |
亞太區域 (香港) |
美國西部 (奧勒岡) |
亞太區域 (新加坡) |
美國西部 (奧勒岡) |
亞太區域 (悉尼) |
美國西部 (奧勒岡) |
亞太區域 (東京) |
亞太區域 (東京) |
歐洲 (法蘭克福) |
歐洲 (法蘭克福) |
歐洲 (愛爾蘭) |
美國東部 (維吉尼亞北部) |
歐洲 (斯德哥爾摩) |
美國東部 (維吉尼亞北部) |
若要使用此功能產生 CloudWatch Logs Insights 查詢,請開啟 CloudWatch Logs Insights 查詢編輯器,選取您要查詢的日誌群組,然後選擇產生查詢。
重要
若要使用自然語言查詢功能,您必須使用 CloudWatchLogsFullAccess、AdministratorAccess、 CloudWatchLogsReadOnlyAccess或 ReadOnlyAccessIAM政策登入,或擁有 cloudwatch:GenerateQuery
許可。
查詢範例
本節中的範例說明如何使用自然語言功能產生及更新查詢。
注意
如需 CloudWatch Logs Insights 查詢編輯器和語法的詳細資訊,請參閱 CloudWatch Logs Insights 查詢語法 。
範例:產生自然語言查詢
若要使用自然語言產生查詢,請輸入提示並選擇產生新查詢。此範例顯示執行基本搜尋的查詢。
提示
以下是提示範例,指示 搜尋 10 個最慢 Lambda 函數叫用的功能。
Find the 10 slowest requests
Query
以下是自然語言功能根據提示產生的查詢範例。請注意提示在查詢前出現在註解中的方式。查詢之後,您可以閱讀描述查詢運作方式的說明。
# Find the 10 slowest requests fields @timestamp, @message, @duration | sort @duration desc | limit 10 # This query retrieves the timestamp, message and duration fields from the logs and sorts them in descending order by duration to find the 10 slowest requests.
注意
若要關閉提示的外觀以及查詢運作方式的說明,請使用編輯器中的齒輪圖示。
範例:更新自然語言查詢
可以透過編輯初始提示,然後選擇更新查詢來更新查詢。
更新提示
下列範例顯示先前提示的更新版本。此提示現在會指示搜尋 20 個最慢 Lambda 函數調用,並包含其他日誌事件的另一欄,而不是搜尋 10 個最慢 Lambda 函數調用的提示。
Show top 20 slowest requests instead and display requestId as a column
更新查詢
以下是更新查詢的範例。請注意更新後的提示在更新後的查詢前出現在註解中的方式。查詢之後,您可以閱讀描述原始查詢更新方式的說明。
# Show top 20 slowest requests instead and display requestId as a column fields @timestamp, @message, @requestId, @duration | sort @duration desc | limit 20 # This query modifies the original query by replacing the @message field with the @requestId field and changing the limit from 10 to 20 to return the top 20 log events by duration instead of the top 10.
選擇不使用您的資料以改善服務
您提供用於訓練 AI 模型並產生相關查詢的自然語言提示資料僅用於提供和維護您的服務。此資料可用於改善 CloudWatch Logs Insights 的品質。我們將您的信任和隱私以及內容安全性放在首位。如需詳細資訊,請參閱 AWS 服務條款
透過建立 AI 服務退出政策,可選擇不將您的內容用於開發或改進自然語言查詢的品質。若要選擇退出所有 CloudWatch Logs AI 功能的資料收集,包括查詢產生功能,您必須為 CloudWatch Logs 建立選擇退出政策。如需詳細資訊,請參閱《AWS Organizations 使用者指南》中的 AI 服務退出政策。