在采集日志或投遞數據到其他云產品時，日志服務會將日志來源、時間戳等信息以Key-Value對的形式添加到日志中。這些字段是日志服務的保留字段。本文介紹日志服務的保留字段。

重要
  • 使用API寫入日志數據或添加Logtail配置時，請不要將Key即字段名稱設置為這些保留字段，否則可能會造成字段名稱重復、查詢不精確等問題。
  • 舊版投遞任務不支持投遞__tag__前綴的字段。
  • 若當前Logstore的計費模式為按寫入數據量計費時，日志服務為日志數據增加的字段將不產生費用。具體內容，可參見按寫入數據量計費。
  • 若當前Logstore的計費模式為按使用功能計費時，日志服務為日志數據增加的字段按照按使用功能計費方式正常收費，為其開啟索引時也會產生少量索引流量及存儲費用。更多信息，請參見按使用功能計費。
保留字段數據格式索引與統計設置說明
__time__整型，Unix標準時間格式。
  • 索引設置：__time__通過API中的參數from和to選擇，無需添加該字段的索引。
  • 統計設置：當您為任何一列開啟統計后，日志服務默認為__time__開啟統計。
寫入日志數據時指定的日志時間。該字段可用于日志投遞、查詢、分析。
__source__字符串格式。
  • 索引設置：開啟索引后，日志服務默認為__source__創建索引，索引數據類型為text類型，分詞字符為空。查詢時輸入source:127.0.0.1 或者 __source__:127.0.0.1。
  • 統計設置：當您為任何一列開啟統計后，日志服務默認為__source__開啟統計。
日志來源設備。該字段可用于日志投遞、查詢、分析、自定義消費。
__topic__字符串格式。
  • 索引設置：開啟索引后，日志服務默認為__topic__創建索引，索引數據類型為text類型，分詞字符為空。查詢時輸入__topic__:XXX。
  • 統計設置：當您為任何一列開啟統計后，日志服務默認為__topic__開啟統計。
日志主題（Topic）。如果您設置了日志主題，日志服務會自動為您的日志添加日志主題字段，Key為__topic__，Value為您的主題內容。該字段可用于日志投遞、查詢、分析、自定義消費。更多信息，請參見日志主題。
__partition_time__字符串格式。日志內容中不存在該字段，無需設置索引。投遞MaxCompute的日志分區時間列，由__time__計算得到。該字段可用于日志投遞MaxCompute時設置日期格式分區列。更多信息，請參見投遞日志到MaxCompute（舊版）。
__extract_others__字符串格式，可反序列化成JSON Map。日志內容中不存在該字段，無需設置索引。日志中投遞MaxCompute的未配置字段組裝為一個JSON Map。該字段可用于日志投遞MaxCompute時打包其它未單獨配置的字段。更多信息，請參見投遞日志到MaxCompute（舊版）。
_extract_others_字符串格式，可反序列化成JSON Map。日志內容中不存在該字段，無需設置索引。與__extract_others__相同，建議使用__extract_others__。
__tag__:__client_ip__字符串格式。
  • 索引設置：開啟索引后，日志服務默認為所有字段創建索引，索引數據類型為text類型，分詞字符為空，在查詢時要完全命中，或采用模糊查詢。
  • 統計設置：默認沒有為該列開啟統計。如需開啟統計，請手動添加__tag__:__client_ip__的索引，并開啟統計功能。
日志來源設備的公網IP。該字段為系統標簽（Tag）。開啟記錄外網IP功能后，服務端接收日志時為原始日志追加該字段。可用于日志查詢、分析、自定義消費。對該字段進行SQL分析時，需要給該字段加上雙引號。更多信息，請參見標簽（Tags）和記錄外網IP。
__tag__:__receive_time__字符串，可轉換為整型的Unix標準時間格式。
  • 索引設置：開啟索引后，日志服務默認為所有標簽（Tag）創建索引，索引數據類型為text類型，分詞字符為空，在查詢時要完全命中，或采用模糊查詢。
  • 統計設置：默認沒有為該列開啟統計。如需開啟統計，請手動添加__tag__:__receive_time__的索引，并開啟統計功能。
日志到達服務端的時間，該字段為系統標簽（Tag）。開啟記錄外網IP功能后，服務端接收日志時為原始日志追加該字段。該字段可用于日志查詢、分析、自定義消費。更多信息，請參見標簽（Tags）和記錄外網IP。
__tag__:__path__字符串格式。
  • 索引設置：開啟索引后，日志服務默認為__tag__:__path__創建索引，索引數據類型為text類型，分詞字符為空。查詢時輸入__tag__:__path__:XXX。
  • 統計設置：默認沒有為該列開啟統計。如需開啟統計，請手動添加__tag__:__path__的索引，并開啟統計功能。
Logtail采集的日志文件路徑，Logtail為日志自動填加該字段。可用于日志查詢、分析、自定義消費。對該字段進行SQL分析時，需要給該字段加上雙引號。
__tag__:__hostname__字符串格式。
  • 索引設置：開啟索引后，日志服務默認為__tag__:__hostname__創建索引，索引數據類型為text類型，分詞字符為空。查詢時輸入__tag__:__hostname__:XXX。
  • 統計設置：默認沒有為該列開啟統計。如需開啟統計，請手動添加__tag__:__hostname__的索引，并開啟統計功能。
logtail采集數據的來源機器主機名。Logtail為日志自動填加該字段。可用于日志查詢、分析、自定義消費。對該字段進行SQL分析時，需要給該字段加上雙引號。
__raw_log__字符串格式。請手動添加并設置該字段的索引，索引數據類型為text，并根據需求選擇是否開啟統計。解析失敗的原始日志。關閉丟棄解析失敗日志功能后，Logtail在解析日志失敗時上傳原始日志。其中Key為__raw_log__、Value為日志內容。該字段可用于日志投遞、查詢、分析、自定義消費。更多信息，請參見丟棄解析失敗日志。
__raw__字符串格式。請手動添加并設置該字段的索引，索引數據類型為text，并根據需求選擇是否開啟統計。解析成功的原始日志。開啟上傳原始日志功能后，Logtail會將原始日志作為__raw__字段，和解析后的日志一并上傳。該字段可用于審計、合規審查等場景。該字段可用于日志投遞、查詢、分析、自定義消費。更多信息，請參見上傳原始日志。