保留欄位 - Simple Log Service

在採集日誌或投遞資料到其他雲產品時，Log Service會將日誌來源、時間戳記等資訊以Key-Value對的形式添加到日誌中。這些欄位是Log Service的保留欄位。本文介紹Log Service的保留欄位。

重要

使用API寫入日誌資料或添加Logtail配置時，請不要將Key即欄位名稱設定為這些保留欄位，否則可能會造成欄位名稱重複、查詢不精確等問題。
舊版投遞任務不支援投遞__tag__首碼的欄位。
若當前Logstore的計費模式為按寫入資料量計費時，Log Service為日誌資料增加的欄位將不產生費用。具體內容，可參見按寫入資料量計費。
若當前Logstore的計費模式為按使用功能計費時，Log Service為日誌資料增加的欄位按照按使用功能計費方式正常收費，為其開啟索引時也會產生少量索引流量及儲存費用。更多資訊，請參見按使用功能計費。

保留欄位	資料格式	索引與統計設定	說明
`__time__`	整型，Unix標準時間格式。	索引設定：`__time__`通過API中的參數from和to選擇，無需添加該欄位的索引。統計設定：當您為任何一列開啟統計後，Log Service預設為`__time__`開啟統計。	寫入日誌資料時指定的日誌時間。該欄位可用於日誌投遞、查詢、分析。
`__source__`	字串格式。	索引設定：開啟索引後，Log Service預設為`__source__`建立索引，索引資料類型為text類型，分詞字元為空白。查詢時輸入`source:127.0.0.1` 或者 `__source__:127.0.0.1`。統計設定：當您為任何一列開啟統計後，Log Service預設為`__source__`開啟統計。	日誌來源裝置。該欄位可用於日誌投遞、查詢、分析、自訂消費。
`__topic__`	字串格式。	索引設定：開啟索引後，Log Service預設為`__topic__`建立索引，索引資料類型為text類型，分詞字元為空白。查詢時輸入`__topic__:XXX`。統計設定：當您為任何一列開啟統計後，Log Service預設為`__topic__`開啟統計。	日誌主題（Topic）。如果您設定了日誌主題，Log Service會自動為您的日誌添加日誌主題欄位，Key為`__topic__`，Value為您的主題內容。該欄位可用於日誌投遞、查詢、分析、自訂消費。更多資訊，請參見日誌主題。
`_extract_others_`	字串格式，可還原序列化成JSON Map。	日誌內容中不存在該欄位，無需設定索引。	與`__extract_others__`相同，建議使用`__extract_others__`。
`__tag__:__client_ip__`	字串格式。	索引設定：開啟索引後，Log Service預設為所有欄位建立索引，索引資料類型為text類型，分詞字元為空白，在查詢時要完全命中，或採用模糊查詢。統計設定：預設沒有為該列開啟統計。如需開啟統計，請手動添加`__tag__:__client_ip__`的索引，並開啟統計功能。	日誌來源裝置的公網IP。該欄位為系統標籤（Tag）。開啟記錄外網IP功能後，服務端接收日誌時為原始日誌追加該欄位。可用於日誌查詢、分析、自訂消費。對該欄位進行SQL分析時，需要給該欄位加上雙引號。更多資訊，請參見標籤（Tags）和記錄外網IP。
`__tag__:__receive_time__`	字串，可轉換為整型的Unix標準時間格式。	索引設定：開啟索引後，Log Service預設為所有標籤（Tag）建立索引，索引資料類型為text類型，分詞字元為空白，在查詢時要完全命中，或採用模糊查詢。統計設定：預設沒有為該列開啟統計。如需開啟統計，請手動添加`__tag__:__receive_time__`的索引，並開啟統計功能。	日誌到達服務端的時間，該欄位為系統標籤（Tag）。開啟記錄外網IP功能後，服務端接收日誌時為原始日誌追加該欄位。該欄位可用於日誌查詢、分析、自訂消費。更多資訊，請參見標籤（Tags）和記錄外網IP。
`__tag__:__path__`	字串格式。	索引設定：開啟索引後，Log Service預設為`__tag__:__path__`建立索引，索引資料類型為text類型，分詞字元為空白。查詢時輸入`__tag__:__path__:XXX`。統計設定：預設沒有為該列開啟統計。如需開啟統計，請手動添加`__tag__:__path__`的索引，並開啟統計功能。	Logtail採集的記錄檔路徑，Logtail為日誌自動填加該欄位。可用於日誌查詢、分析、自訂消費。對該欄位進行SQL分析時，需要給該欄位加上雙引號。
`__tag__:__hostname__`	字串格式。	索引設定：開啟索引後，Log Service預設為`__tag__:__hostname__`建立索引，索引資料類型為text類型，分詞字元為空白。查詢時輸入`__tag__:__hostname__:XXX`。統計設定：預設沒有為該列開啟統計。如需開啟統計，請手動添加`__tag__:__hostname__`的索引，並開啟統計功能。	logtail採集資料的來源機器主機名稱。Logtail為日誌自動填加該欄位。可用於日誌查詢、分析、自訂消費。對該欄位進行SQL分析時，需要給該欄位加上雙引號。
`__raw_log__`	字串格式。	請手動添加並設定該欄位的索引，索引資料類型為text，並根據需求選擇是否開啟統計。	解析失敗的原始日誌。關閉丟棄解析失敗日誌功能後，Logtail在解析日誌失敗時上傳原始日誌。其中Key為`__raw_log__`、Value為日誌內容。該欄位可用於日誌投遞、查詢、分析、自訂消費。更多資訊，請參見丟棄解析失敗日誌。
`__raw__`	字串格式。	請手動添加並設定該欄位的索引，索引資料類型為text，並根據需求選擇是否開啟統計。	解析成功的原始日誌。開啟上傳原始日誌功能後，Logtail會將原始日誌作為`__raw__`欄位，和解析後的日誌一併上傳。該欄位可用於審計、合規審查等情境。該欄位可用於日誌投遞、查詢、分析、自訂消費。更多資訊，請參見上傳原始日誌。