本文介紹如何使用Logtail採集主機文本日誌。
背景資訊
本文介紹Logtail採集配置的詳細配置步驟，對於常見類型的日誌採集，請參見最佳實務：
前提條件
已建立Logtail機器組並添加相應伺服器，建立機器組的步驟，請參見建立使用者自訂標識機器組（推薦）或建立IP地址機器組。
安裝Logtail的主機需要在出口方向開放80（HTTP）連接埠和443（HTTPS）連接埠。ECS執行個體的連接埠由安全性群組規則控制，添加安全性群組規則的步驟請參見添加安全性群組規則。
伺服器日誌的內容持續新增。Logtail只採集增量日誌，如果下發Logtail配置後記錄檔無更新，則Logtail不會採集該檔案中的日誌。更多資訊，請參見讀取日誌。
操作步驟
在接入資料地區中，根據需要選擇包含文本日誌尾碼的入口。本文以採集主機中的多行文本日誌為例。
在選擇日誌空間頁面，按照選擇目標Project和Logstore，單擊下一步。
在機器組配置頁面，配置機器組。
根據實際需求，選擇使用情境和安裝環境。
重要無論是否已有機器組，都必鬚根據實際需求正確選擇使用情境和安裝環境，這將影響後續的頁面配置。
確認目標機器組已在應用機器組地區，單擊下一步。
已有機器組
從源機器組列表選擇目標機器組。
沒有可用機器組
單擊建立機器組，在建立機器組面板設定相關參數。機器組標識分為IP地址和使用者自訂標識，更多資訊請參見建立使用者自訂標識機器組（推薦）或建立IP地址機器組。
重要建立機器組後立刻應用，可能因為串連未生效，導致心跳為FAIL，您可單擊重試。如果還未解決，請參見Logtail機器組無心跳進行排查。
建立Logtail配置，單擊下一步，建立Logtail配置。Logtail配置生效時間最長需要3分鐘，請耐心等待。
配置項
說明
日誌範例
待採集日誌的範例，請務必使用實際情境的日誌。日誌範例可協助您配置Tlog相關參數，降低配置難度。支援添加多條範例，總長度不超過1500個字元。
[2023-10-01T10:30:01,000] [INFO] java.lang.Exception: exception happened at TestPrintStackTrace.f(TestPrintStackTrace.java:3) at TestPrintStackTrace.g(TestPrintStackTrace.java:7) at TestPrintStackTrace.main(TestPrintStackTrace.java:16)多行模式
多行日誌的類型：多行日誌是指每條日誌分布在連續的多行中，需要從日誌內容中區分出每一條日誌。
自訂：通過行首Regex區分每一條日誌。
多行JSON：每個JSON對象被展開為多行，例如：
{ "name": "John Doe", "age": 30, "address": { "city": "New York", "country": "USA" } }
切分失敗處理方式：
Exception in thread "main" java.lang.NullPointerException at com.example.MyClass.methodA(MyClass.java:12) at com.example.MyClass.methodB(MyClass.java:34) at com.example.MyClass.main(MyClass.java:½0)對於以上日誌內容，如果Log Service切分失敗：
丟棄：直接丟棄這段日誌。
保留單行：將每行日誌文本單獨保留為一條日誌，保留為一共四條日誌。
處理模式
處理外掛程式組合，包括原生外掛程式和拓展外掛程式。有關處理外掛程式的更多資訊，請參見處理外掛程式概述。
重要處理外掛程式的使用限制，請以控制台頁面的提示為準。
2.0版本的Logtail：
原生處理外掛程式可任意組合。
原生處理外掛程式和擴充處理外掛程式可同時使用，但擴充處理外掛程式只能出現在所有的原生處理外掛程式之後。
低於2.0版本的Logtail：
不支援同時添加原生外掛程式和擴充外掛程式。
原生外掛程式僅可用於採集文本日誌。使用原生外掛程式時，須符合如下要求：
第一個處理外掛程式必須為正則解析外掛程式、分隔字元模式解析外掛程式、JSON解析外掛程式、Nginx模式解析外掛程式、Apache模式解析外掛程式或IIS模式解析外掛程式。
從第二個處理外掛程式到最後一個處理外掛程式，最多包括1個時間解析處理外掛程式，1個過濾處理外掛程式和多個脫敏處理外掛程式。
對於解析失敗時保留原始欄位和解析成功時保留原始欄位參數，只有以下組合有效，其餘組合無效。
只上傳解析成功的日誌：
解析成功時上傳解析後的日誌，解析失敗時上傳原始日誌：
解析成功時不僅上傳解析後的日誌，並且追加原始日誌欄位，解析失敗時上傳原始日誌。
例如，原始日誌
"content": "{"request_method":"GET", "request_time":"200"}"解析成功，追加原始欄位是在解析後日誌的基礎上再增加一個欄位，欄位名為重新命名的原始欄位（如果不填則預設為原始欄位名），欄位值為原始日誌{"request_method":"GET", "request_time":"200"}。
建立索引和預覽資料，然後單擊下一步。Log Service預設開啟全文索引。您也可以根據採集到的日誌，手動建立欄位索引，或者單擊自動產生索引，Log Service將自動產生欄位索引。更多資訊，請參見建立索引。
重要如果需要查詢日誌中的所有欄位，建議使用全文索引。如果只需查詢部分欄位、建議使用欄位索引，減少索引流量。如果需要對欄位進行分析（SELECT語句），必須建立欄位索引。
單擊查詢日誌，系統將跳轉至Logstore查詢分析頁面。
您需要等待1分鐘左右，待索引生效後，才能在原始日誌頁簽中，查看已採集到的日誌。查詢和分析日誌的詳細步驟，請參見查詢和分析日誌。
相關文檔
使用Logtail採集日誌後，如果預覽頁面為空白或查詢頁面無資料，請按照Logtail採集日誌失敗的排查思路進行排查。在使用Logtail採集日誌時，可能遇到正則解析失敗、檔案路徑不正確、流量超過Shard服務能力等錯誤。查看Logtail採集錯誤的步驟，請參見如何查看Logtail採集錯誤資訊。採集資料常見的錯誤類型請參見Log Service採集資料常見的錯誤類型。
預設情況下，一個記錄檔只能匹配一個Logtail配置。如果同一份日誌需要被採集多份，請參見如何?檔案中的日誌被採集多份。
將企業內網伺服器日誌採集到Log Service，請參見採集企業內網伺服器日誌。