本文以Linux系統為例介紹同阿里雲帳號跨地區採集日誌的操作步驟。
方案概覽
假如某公司的網站應用程式部署在地區A,Simple Log ServiceProject部署在地區B,現計劃通過Logtail採集配置將部署在地區A的ECS執行個體中的日誌資料發送到地區B的Simple Log ServiceProject中。您可通過以下步驟配置:
配置流程圖如下所示:
前提條件
已建立Project和Logstore。更多資訊,請參見建立專案Project和建立Logstore。
步驟一:在地區A的ECS執行個體中安裝Logtail
網路傳輸說明
傳輸方式 | 適用情境 |
公網 |
|
傳輸加速 | 伺服器分布在海外各地的自建機房或者來自海外雲廠商,使用公網傳輸資料可能會出現網路延遲高、傳輸不穩定等問題,推薦選擇傳輸加速。更多資訊,參見管理傳輸加速。 |
登入地區A的ECS執行個體,請參考網路傳輸說明根據您的網路環境選擇安裝Logtail指令碼。安裝Logtail支援的Liunx系統,請參見使用限制。
公網
根據Simple Log ServiceProject所在地區,擷取對應的${region_id}
。替換${region_id}
後,執行安裝命令。
各地區對應的${region_id}
請參見開服地區,例如華東 1(杭州)對應的${region_id}
為cn-hangzhou
。
wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod +x logtail.sh; ./logtail.sh install ${region_id}-internet
傳輸加速
根據Simple Log ServiceProject所在地區,擷取對應的${region_id}
。替換${region_id}
後,執行安裝命令。
各地區對應的${region_id}
請參見開服地區,例如華東 1(杭州)對應的${region_id}
為cn-hangzhou
。
wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod +x logtail.sh; ./logtail.sh install ${region_id}-acceleration
步驟二:在地區A的ECS執行個體中配置使用者自訂標識
在指定目錄下建立使用者自訂標識檔案
user_defined_id
並配置使用者自訂標識。重要同一機器組中不允許同時存在Linux和Windows伺服器,請勿在Linux和Windows伺服器上配置相同的使用者自訂標識。
一個伺服器可配置多個使用者自訂標識,標識之間以分行符號分割。
使用者自訂標識檔案存放路徑:
Linux:/etc/ilogtail/user_defined_id。
Windows:C:\LogtailData\user_defined_id。
如果目錄
/etc/ilogtail/
、C:\LogtailData
或檔案/etc/ilogtail/user_defined_id
、C:\LogtailData\user_defined_id
不存在,請手動建立。
Linux環境
在Linux伺服器配置使用者自訂標識,可使用以下命令完成。
echo "user-defined-linux-1" > /etc/ilogtail/user_defined_id
檢查使用者自訂標識是否寫入成功,可使用以下命令。
cat /etc/ilogtail/user_defined_id
新增、刪除、修改user_defined_id檔案後,預設情況下,1分鐘內生效。如果需要立即生效,請執行以下命令重啟Logtail。
/etc/init.d/ilogtaild stop /etc/init.d/ilogtaild start
Windows環境
在Windows服務配置使用者自訂標識,可在
C:\LogtailData\user_defined_id
檔案中輸入user-defined-windows-1
,並儲存。檢查使用者自訂標識是否寫入成功,可開啟
C:\LogtailData\user_defined_id
檔案直接查看。新增、刪除、修改user_defined_id檔案後,預設情況下,1分鐘內生效。如需立即生效,請根據以下步驟重啟Logtail。
選擇
。在服務對話方塊中,選擇對應的服務。
如果是0.x.x.x版本,選擇LogtailWorker服務。
如果是1.0.0.0及以上版本,選擇LogtailDaemon服務。
按右鍵重新啟動使配置生效。
容器環境
使用者自訂標識配置在Logtail容器的環境變數
ALIYUN_LOGTAIL_USER_DEFINED_ID
中,可通過docker inspect ${logtail_container_name} | grep ALIYUN_LOGTAIL_USER_DEFINED_ID
命令查看。
步驟三:在地區B的Log ServiceProject中建立使用者自訂標識機器組
登入Log Service控制台,在Project列表,單擊開啟目標Project。
左側導覽列中,選擇
。在開啟的機器組頁面中,選擇機器組右側的 。在彈出的建立機器組頁面,填寫以下資訊,並單擊確定。
參數
說明
名稱
機器組名稱,命名規則如下所示:
只能包括小寫字母、數字、短劃線(-)和底線(_)。
必須以小寫字母或者數字開頭和結尾。
長度必須在 2~128 字元之間。
重要建立後,不支援修改機器組名稱,請謹慎填寫。
機器組標識
選擇IP地址。
機器組Topic
(可選)機器組Topic用於區分不同伺服器產生的日誌資料。更多資訊,請參見日誌主題。
IP地址
填入上述步驟中擷取的伺服器IP地址。
重要存在多台伺服器時,請手動輸入對應的IP地址,IP地址之間需使用分行符號分隔。
同一機器組中不允許同時存在Linux和Windows伺服器。請勿將Windows和Linux伺服器IP添加到同一機器組中。
在機器組列表中,單擊目標機器組。在機器組配置頁面,檢查機器組配置資訊以及伺服器狀態。
心跳狀態為OK表示伺服器上的Logtail執行個體與Simple Log ServiceProject串連正常。
如果心跳狀態顯示FAIL,處理操作請參見Logtail機器組問題排查思路(主機情境)。
重要建立機器組大約需要2分鐘。建立未生效,將導致心跳為FAIL。請2分鐘後單擊重新整理進行重試。
步驟四:在地區B的Log ServiceProject中建立Logtail採集配置
對於常見類型的日誌採集,請參見最佳實務:
相關文檔
使用Logtail採集日誌後,如果預覽頁面為空白或查詢頁面無資料,請按照Logtail採集日誌失敗的排查思路進行排查。在使用Logtail採集日誌時,可能遇到正則解析失敗、檔案路徑不正確、流量超過Shard服務能力等錯誤。查看Logtail採集錯誤的步驟,請參見如何查看Logtail採集錯誤資訊。採集資料常見的錯誤類型請參見Log Service採集資料常見的錯誤類型。
預設情況下,一個記錄檔只能匹配一個Logtail配置。如果同一份日誌需要被採集多份,請參見如何?檔案中的日誌被採集多份。
將企業內網伺服器日誌採集到Log Service,請參見採集企業內網伺服器日誌。