記錄排除

Stackdriver Logging 中的「Logs ingestion」(記錄檔擷取) 頁面會追蹤專案中的記錄檔量。該頁面也提供相關工具,可停用所有記錄檔的擷取作業,或排除 (捨棄) 您沒有興趣的記錄項目,盡可能減少超出每月配額的記錄檔費用。如需深入瞭解 Stackdriver Logging 如何處理遭排除的記錄項目,請參閱本頁面上的排除總覽一節。

如需 Stackdriver Logging 費用的詳細資訊,請參閱 Stackdriver 定價一文。請注意,如果您傳送虛擬私人雲端流程的記錄檔到 Stackdriver Logging 後又將其排除,則系統會向您收取虛擬私人雲端流程記錄檔產生費用

追蹤記錄檔量

若要追蹤您的專案記錄檔使用量,請前往 Stackdriver Logging 主控台的「Logs ingestion」(記錄檔擷取) 頁面:

前往「Logs ingestion」(記錄檔擷取) 頁面

頁面頂端會顯示專案目前接收的記錄統計資料摘要:

記錄檔擷取作業摘要

頁面上會回報四項數字:

  • 「Last month's ingested log volume」(上個月擷取的記錄檔量):您的專案在前一月份接收的記錄檔量。

  • 「This month's ingested log volume」(這個月擷取的記錄檔量):您的專案自本月第一天以來接收的記錄檔量。

  • 「Excluded log volume」(排除的記錄檔量):您的專案自本月第一天以來排除的記錄檔量。此數字不包含在「This month's ingested log volume」(這個月擷取的記錄檔量) 之中。排除記錄檔的部分將於本頁稍後介紹。

  • 「Projected ingestion log volume」(預測的擷取記錄檔量):根據目前的使用量去預測到本月底前,您的專案會收到的記錄檔量。

記錄檔量並不包含所有預設啟用的稽核記錄,亦即所有管理員活動記錄檔加上 BigQuery 資料存取記錄檔。這些記錄檔為免費,且不能排除。

您也可以依據資源類型檢視記錄檔用量的明細。請參閱本頁的檢視資源類型排除一節。

停止所有記錄檔擷取作業

若要立即停用所有記錄檔擷取作業,請至「Logs ingestion」(記錄檔擷取) 頁面執行以下操作:

  1. 前往 Stackdriver Logging 主控台的「Logs ingestion」(記錄檔擷取) 頁面,選擇您想要管理記錄檔的專案。

    前往「Logs ingestion」(記錄檔擷取) 頁面

  2. 在所有摘要統計資料上方,按一下 [Logs Enabled] (已啟用記錄檔) 按鈕。

  3. 畫面上會出現「Disable all logs ingestion?」(要停用所有記錄檔擷取功能嗎?) 對話方塊,請按一下 [Disable Logs] (停用記錄功能)。

  4. 如果您成功停用了所有記錄檔擷取作業,便會在 Stackdriver Logging 主控台中看見以下變化:

    記錄檔擷取已停用

    • 您在步驟 2 中按下的按鈕現在顯示為「Logs Disabled」(已停用記錄檔)。
    • Stackdriver Logging 主控台每個頁面頂端都會顯示一個橫幅:「Logs ingestion is turned off. No logs are being sent to Stackdriver Logging.」(記錄檔擷取功能已關閉。系統未將記錄檔傳送至 Stackdriver Logging)。
    • 在「Logs ingestion」(記錄檔擷取) 頁面的「Exclusions」(排除) 分頁中,有個名為 google-ui-logs-ingestion-off 的篩選器。此篩選器的「Percent to Exclude」(排除百分比) 值設為「100%」,且「Exclusion Status」(排除狀態) 為「Active」(有效)。

如要立即重新啟動記錄檔擷取,請按一下摘要統計資料上方的 [Logs Disabled] (已停用記錄檔) 按鈕。該按鈕隨即顯示為 [Logs Enabled] (已啟用記錄檔),且 Stackdriver Logging 主控台會停止顯示橫幅。

排除總覽

下方圖表說明了 Stackdriver Logging 如何處理遭排除的記錄項目:

記錄的生命週期

下列條件適用於 Logging 中已排除的記錄項目:

  • 已排除的記錄項目不會計入提供給專案使用的配額之中。如需更多資訊,請參閱 Logging 詳細資料一文。

  • 記錄檢視器不會顯示已排除的記錄項目。這些項目不會計入記錄指標,也無法用於 Stackdriver Error Reporting 或 Stackdriver Debugger。

  • 在記錄項目排除前,可先匯出這些項目。如需更多資訊,請參閱匯出記錄一文。

  • 您無法排除任何預設啟用的稽核記錄。不過預設啟用的稽核記錄不會收費。

  • 您無法排除 AWS 記錄檔或任何並非來自 GCP 的記錄檔。

排除有兩種形式:

  • 排除篩選器可根據篩選器運算式,靈活地選擇要排除的記錄項目。您可以使用排除篩選器隨機選擇要排除的記錄項目樣本。如需詳細資訊,請參閱使用排除篩選器一文。

  • 資源類型排除可封鎖特定資源類型的記錄檔。如需詳細資訊,請參閱使用資源類型排除一文。

決定是否要排除某個記錄項目時,Logging 會考量前述兩種排除方式。如果該記錄項目符合任何資源類型排除或是任何排除篩選器,便會將其排除。

使用排除篩選器

建立排除篩選器後,即可控制要排除 (捨棄) 的記錄項目。例如,您可以排除來自單一 VM 執行個體的記錄項目,而非所有 VM 執行個體的記錄項目。

如果同時使用排除篩選器和資源類型排除,這兩種排除可能同時發揮效果。如果記錄項目來自於已停用的資源類型,或符合本節提及的其中一項排除篩選器,即會遭到排除。請注意,這只是技術上的區別。如前所述,Logging 會將排除篩選器和資源類型排除兩者搭配使用。

在「Logs ingestion」(記錄檔擷取) 頁面的「Ingestions」(擷取) 分頁的資源類型表格中,系統會一併顯示執行資源類型排除和排除篩選器的結果。即使您未使用資源類型排除,也可以使用該表格追蹤排除篩選器的效果。

檢視排除篩選器

若要檢視您目前的排除篩選器 (包括 Logging 建立以用於執行資源類型排除的篩選器),請執行以下操作:

  1. 前往 Stackdriver Logging 主控台的「Logs ingestion」(記錄檔擷取) 頁面,選擇您要管理記錄檔的專案。

    前往「Logs ingestion」(記錄檔擷取) 頁面

  2. 在統計資料摘要下方,按一下 [Exclusions] (排除) 分頁標籤。「Exclusion Filters」(排除篩選器) 表格會顯示排除篩選器清單 (若有):

    排除篩選器表格

如果您已停止所有記錄檔擷取作業,您的清單即會出現名為 google-ui-logs-ingestion-off 的排除篩選器。您可使用篩選器右側的選單來編輯、刪除或停用此篩選器。

建立排除篩選器

若要使用 Stackdriver Logging 主控台建立排除篩選器,請按照以下方式進行:

  1. 前往 Stackdriver Logging 主控台的「Logs ingestion」(記錄檔擷取) 頁面,選取 [Exclusions] (排除) 分頁標籤。

    前往「Logs ingestion」(記錄檔擷取) 頁面

  2. 按一下 [Create Exclusion] (建立排除條件),即會在「記錄檢視器」面板旁看到「Exclusion Editor」(排除條件編輯器):

    建立排除條件

  3. 在「記錄檢視器」面板中輸入與您想排除的記錄項目相符的篩選器運算式。如需有關該面板的更多資訊,請參閱使用者介面一文。

  4. 在「Exclusion Editor」(排除條件編輯器) 中填妥文字方塊,完成您的排除篩選器:

    • 「Name」(名稱):可辨別排除的名稱,例如 low-severity
    • 「Description」(說明):篩選器較詳細的說明,例如:Exclude logs whose severity is less than WARNING
    • 「Percent to Exclude」(排除百分比):請輸入介於 0 至 100 間的整數或浮點值。例如,輸入 100100.0 便能排除所有相符的記錄項目。輸入 99.50 便會排除 99.5% 相符的項目,但會有 0.5% 的項目保留在 Logging 中。
  5. 按一下 [Create Exclusion] (建立排除條件),即可建立並開始排除作業。

提示:如要避免使用排除篩選器,請選取排除篩選器右側選單中的 [Disable Exclusion] (停用排除條件)。您也可以在相同選單上編輯或刪除排除篩選器。

停止排除作業

您可以透過多種方式停止排除部分或所有記錄檔:

  • 停止排除所有記錄檔:按一下「Logs ingestion」(記錄檔擷取) 頁面頂端的 [Logs Disabled] (已停用記錄檔) 按鈕。如果您先前曾停用所有記錄檔的擷取作業,則該按鈕會從 **[Logs Disabled] (已停用記錄檔) 變為 [Logs Enabled] (已啟用記錄檔)。如需詳細資訊,請參閱停止記錄檔擷取作業一文。

  • 停止依照資源類型進行排除:在「Logs ingestion」(記錄檔擷取) 頁面的「Ingestions」(擷取) 分頁中,找到您想要停止排除的資源類型,按一下右邊選單中的 [Enable log source] (啟用記錄來源)。

  • 編輯、停用或刪除排除篩選器:在「Logs ingestion」(記錄檔擷取) 頁面的「Exclusions」(排除) 分頁中,使用將您想接收的記錄項目當做目標的任何排除篩選器右側的選單。詳情請參閱編輯排除條件一節。

提示:請檢查所有的排除篩選器,因為相同的記錄項目可能由多個篩選器當做目標。

編輯排除條件

您可以編輯現有的排除篩選器,以排除更多或更少的記錄項目。

  1. 前往 Stackdriver Logging 主控台的「Logs ingestion」(記錄檔擷取) 頁面,並按一下 [Exclusions] (排除) 分頁標籤。

    前往「Logs ingestion」(記錄檔擷取) 頁面

  2. 選擇排除篩選器,並在篩選器清單右側的選單中選取 [Edit Exclusion] (編輯排除條件)。

  3. 變更進階記錄檔篩選器,或變更「Percent to Exclude」(排除百分比) 的值。如果您要變更篩選器,請檢查一下相符記錄項目的預覽。您無法變更現有排除篩選器的名稱。

  4. 按一下 [Update Exclusion] (更新排除條件)。

最佳做法:請勿編輯或刪除由 Logging 建立當做資源類型排除一部分的排除篩選器。請使用「Ingestions」(擷取) 分頁中的 [Disable log source] (停用記錄來源) 和 [Enable log source] (啟用記錄來源) 選項來管理這類篩選器。

使用資源類型排除

預設情況下,您的專案會接收來自所有資源類型的所有記錄。若要捨棄來自特定資源類型的記錄,請使用「資源類型排除」。

資源類型排除是 Stackdriver Logging 主控台的功能。當您建立資源類型排除時,Logging 會建立執行該排除的排除篩選器。如需更多資訊,請參閱使用排除篩選器一文。

檢視資源類型排除

若要依照資源類型來檢視記錄檔使用量和查看資源類型排除,請按照以下步驟進行:

  1. 前往 Stackdriver Logging 主控台的「Logs ingestion」(記錄檔擷取) 頁面:

    前往「Logs ingestion」(記錄檔擷取) 頁面

  2. 選取摘要統計資料下方的 [Ingestions] (擷取) 分頁標籤 (預設分頁標籤)。「Logs Ingestion」(記錄檔擷取) 表格會依資源類型顯示您的記錄檔使用量:

    資源使用量表格

本月和上月曾傳送記錄檔至您專案的每種資源類型的記錄檔使用量,均會顯示在該表上。有些資源類型可能只在上個月傳送記錄,本月則無,但也會列在表內。

「Ingestion Status」(擷取狀態) 欄會大略顯示每種資源類型是否有相關的排除項目。其狀態可以是下列任一種:

  • 「Not ingested」(未擷取):有一個或多個特別針對此資源類型的排除項目,抽樣率為 100%。這表示該排除篩選器包含 resource.type=[THIS_RESOURCE_TYPE]

  • 「All ingested」(全部擷取):本月至今,尚無針對此資源類型遭到排除的記錄項目,且沒有特別針對此資源類型的排除項目。

  • 「Partially ingested」(部分擷取):有一個或多個特別針對此資源類型的排除項目,抽樣率為 0% 至 100% 之間。如果此資源類型本月有任何遭排除的記錄項目,即便所有排除項目現在均已移除,本狀態也會維持至月底。詳情請參閱編輯排除條件一節。

此外,您可以在「Exclusions」(排除) 分頁檢查資源類型排除。Logging 會建立排除篩選器,藉以執行資源類型排除。請參閱檢視排除篩選器一文。

建立資源類型排除

如要排除 (捨棄) 來自特定資源類型的記錄,請建立「資源類型排除」。步驟如下:

  1. 前往 Stackdriver Logging 主控台的「Logs ingestion」(記錄檔擷取) 頁面:

    前往「Logs ingestion」(記錄檔擷取) 頁面

  2. 選取統計資料摘要下方的 [Ingestions] (擷取) 分頁標籤 (預設分頁標籤)。「Logs Ingestion」(記錄檔擷取) 表格會依資源類型顯示您的記錄檔使用量,如上一節的螢幕擷取畫面所示。

  3. 找到您要排除之資源類型的表格列。

  4. 在表格列右側的選單中選取 [Create exclusion filter based on this resource] (根據這項資源建立排除篩選器)

  5. 在「Exclusion Editor」(排除條件編輯器) 中填妥文字方塊,完成您的排除篩選器:

    • 「Name」(名稱):可辨別排除的名稱,例如 low-severity
    • 「Description」(說明):篩選器較詳細的說明,例如:Exclude logs whose severity is less than WARNING
    • 「Percent to Exclude」(排除百分比):請輸入介於 0 至 100 間的整數或浮點值。例如,輸入 100100.0 便能排除所有相符的記錄項目。輸入 99.50 便會排除 99.5% 相符的項目,但會有 0.5% 的項目保留在 Logging 中。
  6. 按一下 [Create Exclusion] (建立排除條件),即可建立並開始排除作業。

如要停止排除該資源類型的記錄,請按一下選單中的 [Enable log source] (啟用記錄來源)。

API 中的排除

若要在 Stackdriver Logging API 中建立排除篩選器,請使用 projects.exclusions.create 方法。另外,Stackdriver Logging API 也提供檢視、刪除和更新排除篩選器的方法。

針對組織、帳單帳戶和資料夾收到的記錄檔,API 也能提供排除方法。這類排除只能透過 Stackdriver Logging API 建立,不支援 Stackdriver Logging 主控台。

如需適合排除作業使用的記錄檔篩選器範例,請參閱進階記錄檔篩選器一文。

API 中的資源類型排除

在 API 內,資源類型排除並不算是一種獨立的排除類型。若要排除特定資源類型的所有記錄項目,使用者要在記錄檔篩選器內指定要排除的資源類型,並據此建立排除篩選器:

resource.type = [THE_RESOURCE_TYPE]

API 中的抽樣排除

如要排除少於 100% 的相符記錄項目,請在記錄檔篩選器中使用 sample 函式

排除限制

一個專案最多可有 50 個排除篩選器,包含在 Stackdriver Logging 主控台或 API 中建立的排除篩選器和資源類型排除。

匯出排除的記錄檔

排除記錄項目前,可以將這些項目匯出至 Cloud Storage、BigQuery 或 Cloud Pub/Sub,以避免永久遺失您排除的記錄項目。

匯出的記錄會產生目標位置的相關費用。另請注意,如果您傳送虛擬私人雲端流程的記錄檔到 Stackdriver Logging 後又將其排除,則除了目標位置的費用之外,系統也會向您收取虛擬私人雲端流程記錄檔產生費用

若要開始進行排除和匯出,請按照以下步驟進行:

  1. 建立與您想要排除並匯出的記錄項目相符的進階記錄檔篩選器

    提示:撰寫篩選器時,請勿讓篩選器符合任何預設啟用的稽核記錄。與稽核記錄項目相符並不會影響排除,但會匯出更多記錄項目。

  2. 使用您的記錄檔篩選器建立匯出接收器,然後開始匯出相符的記錄項目。

  3. 使用您的記錄檔篩選器建立排除篩選器,然後開始排除相符的記錄項目。

如要停止排除和匯出,請在停止匯出接收器前,先停用排除篩選器。

如需匯出記錄檔方法的更多資訊,請參閱匯出記錄相關說明。

本頁內容對您是否有任何幫助?請提供意見:

傳送您對下列選項的寶貴意見...

這個網頁
Stackdriver Logging
需要協助嗎?請前往我們的支援網頁