Amazon CloudWatch Logs Insights 現在支援具有參數的已儲存查詢

張貼日期: 2026年4月13日

Amazon CloudWatch Logs Insights 已儲存查詢現在支援參數，使您得以將值傳遞給具有預留位置的可重複使用查詢範本。這使您不需要維護幾乎相同之查詢的多個副本，這些查詢僅在特定值 (例如日誌層級、服務名稱或時間間隔) 上有所不同。

您最多可以在查詢中定義 20 個參數，每個參數都支援選用的預設值。例如，您可以建立單一範本，依嚴重性等級 (例如 ERROR 或 WARN) 查詢日誌，並在每次執行時傳遞不同的服務名稱。若要執行具有參數的查詢，請使用前綴為 $ 的查詢名稱調用查詢，並傳遞參數值，例如 $ErrorsByService(logLevel="ERROR", serviceName="OrderEntry")。您也可以將多個已儲存的查詢與參數一起使用來進行複雜的日誌分析，在大幅降低查詢維護費用的同時，改善可重複使用性。

所有商業 AWS 區域都可以使用具有參數的已儲存查詢。您可以使用 Amazon CloudWatch 主控台、AWS Command Line Interface (AWS CLI)、AWS Cloud Development Kit (AWS CDK) 和 AWS SDK 來建立和使用具有參數的已儲存查詢。若要進一步了解，請參閱 Amazon CloudWatch Logs 文件。