管理機(jī)器組
日志服務(wù)支持將多臺(tái)服務(wù)器上的日志采集到一個(gè)Logstore中。這些服務(wù)器可以組成一個(gè)機(jī)器組，也可以組成多個(gè)獨(dú)立的機(jī)器組。通過(guò)將Logtail采集配置應(yīng)用到指定的機(jī)器組，日志服務(wù)便會(huì)將該配置下發(fā)至機(jī)器組內(nèi)的所有服務(wù)器，從而采集服務(wù)器上的日志。本文介紹如何在日志服務(wù)Project中創(chuàng)建、查看、修改和刪除機(jī)器組。
創(chuàng)建機(jī)器組
前提條件
已創(chuàng)建Project。具體操作，請(qǐng)參見(jiàn)創(chuàng)建項(xiàng)目Project。
服務(wù)器已安裝Logtail，安裝步驟請(qǐng)參見(jiàn)安裝Logtail（Linux系統(tǒng)）或安裝Logtail（Windows系統(tǒng)）。如果日志服務(wù)Project與ECS實(shí)例屬于同一地域，您可在創(chuàng)建Logtail采集配置時(shí)自動(dòng)安裝Logtail。具體操作，請(qǐng)參見(jiàn)安裝Logtail（ECS實(shí)例）。
如果您的服務(wù)器與日志服務(wù)Project分屬于不同的阿里云賬號(hào)，或是部署在其他云廠商環(huán)境、自建IDC等，則需要在服務(wù)器配置用戶標(biāo)識(shí)。具體操作，請(qǐng)參見(jiàn)配置用戶標(biāo)識(shí)。
操作步驟
日志服務(wù)Project支持使用IP地址或用戶自定義標(biāo)識(shí)創(chuàng)建機(jī)器組。使用IP地址創(chuàng)建相對(duì)更簡(jiǎn)單，但使用用戶自定義標(biāo)識(shí)具有以下優(yōu)勢(shì)，推薦使用。
在VPC等自定義網(wǎng)絡(luò)環(huán)境中，可能出現(xiàn)服務(wù)器IP地址沖突問(wèn)題，導(dǎo)致Logtail采集失敗。使用用戶自定義標(biāo)識(shí)可避免此類情況發(fā)生。
使用用戶自定義標(biāo)識(shí)可實(shí)現(xiàn)機(jī)器組的彈性伸縮。為新增的服務(wù)器配置相同的用戶自定義標(biāo)識(shí)，日志服務(wù)可自動(dòng)識(shí)別，并將其添加至機(jī)器組中。如果不再需要采集服務(wù)器日志，直接刪除在服務(wù)器上配置的用戶自定義標(biāo)識(shí)文件，日志服務(wù)可自動(dòng)將該服務(wù)器從機(jī)器組中移除。
創(chuàng)建IP地址機(jī)器組
獲取服務(wù)器IP地址。
在已安裝Logtail的服務(wù)器，打開(kāi)app_info.json文件，并查看
ip字段的值。app_info.json文件路徑說(shuō)明如下所示。
操作系統(tǒng)
Logtail
app_info.json文件路徑
Linux
Logtail（64位程序）
/usr/local/ilogtail/app_info.json
Windows（64位操作系統(tǒng)）
Logtail（64位程序）
C:\Program Files\Alibaba\Logtail\app_info.json
Logtail（32位程序）
C:\Program Files (x86)\Alibaba\Logtail\app_info.json
Windows （32位操作系統(tǒng)）
Logtail（32位程序）
C:\Program Files\Alibaba\Logtail\app_info.json
Logtail自動(dòng)獲取的服務(wù)器IP地址記錄在app_info.json文件的
ip字段中，如下所示。
登錄日志服務(wù)控制臺(tái)，在Project列表，單擊打開(kāi)目標(biāo)Project。
左側(cè)導(dǎo)航欄中，選擇。在打開(kāi)的機(jī)器組頁(yè)面中，選擇機(jī)器組右側(cè)的
> 創(chuàng)建機(jī)器組。
在彈出的創(chuàng)建機(jī)器組頁(yè)面，填寫以下信息，并單擊確定。
參數(shù)
說(shuō)明
名稱
機(jī)器組名稱，命名規(guī)則如下所示：
只能包括小寫字母、數(shù)字、短劃線（-）和下劃線（_）。
必須以小寫字母或者數(shù)字開(kāi)頭和結(jié)尾。
長(zhǎng)度必須在 2~128 字符之間。
重要創(chuàng)建后，不支持修改機(jī)器組名稱，請(qǐng)謹(jǐn)慎填寫。
機(jī)器組標(biāo)識(shí)
選擇IP地址。
機(jī)器組Topic
（可選）機(jī)器組Topic用于區(qū)分不同服務(wù)器產(chǎn)生的日志數(shù)據(jù)。更多信息，請(qǐng)參見(jiàn)日志主題。
IP地址
填入上述步驟中獲取的服務(wù)器IP地址。
重要存在多臺(tái)服務(wù)器時(shí)，請(qǐng)手動(dòng)輸入對(duì)應(yīng)的IP地址，IP地址之間需使用換行符分隔。
同一機(jī)器組中不允許同時(shí)存在Linux和Windows服務(wù)器。請(qǐng)勿將Windows和Linux服務(wù)器IP添加到同一機(jī)器組中。
創(chuàng)建用戶自定義標(biāo)識(shí)機(jī)器組
在指定目錄下創(chuàng)建用戶自定義標(biāo)識(shí)文件
user_defined_id并配置用戶自定義標(biāo)識(shí)。重要同一機(jī)器組中不允許同時(shí)存在Linux和Windows服務(wù)器，請(qǐng)勿在Linux和Windows服務(wù)器上配置相同的用戶自定義標(biāo)識(shí)。
一個(gè)服務(wù)器可配置多個(gè)用戶自定義標(biāo)識(shí)，標(biāo)識(shí)之間以換行符分割。
用戶自定義標(biāo)識(shí)文件存放路徑：
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不存在，請(qǐng)手動(dòng)創(chuàng)建。
Linux環(huán)境
在Linux服務(wù)器配置用戶自定義標(biāo)識(shí)，可使用以下命令完成。
echo "user-defined-linux-1" > /etc/ilogtail/user_defined_id檢查用戶自定義標(biāo)識(shí)是否寫入成功，可使用以下命令。
cat /etc/ilogtail/user_defined_id新增、刪除、修改user_defined_id文件后，默認(rèn)情況下，1分鐘內(nèi)生效。如果需要立即生效，請(qǐng)執(zhí)行以下命令重啟Logtail。
/etc/init.d/ilogtaild stop /etc/init.d/ilogtaild start
Windows環(huán)境
在Windows服務(wù)配置用戶自定義標(biāo)識(shí)，可在
C:\LogtailData\user_defined_id文件中輸入user-defined-windows-1，并保存。檢查用戶自定義標(biāo)識(shí)是否寫入成功，可打開(kāi)
C:\LogtailData\user_defined_id文件直接查看。新增、刪除、修改user_defined_id文件后，默認(rèn)情況下，1分鐘內(nèi)生效。如需立即生效，請(qǐng)根據(jù)以下步驟重啟Logtail。
選擇。
在服務(wù)對(duì)話框中，選擇對(duì)應(yīng)的服務(wù)。
如果是0.x.x.x版本，選擇LogtailWorker服務(wù)。
如果是1.0.0.0及以上版本，選擇LogtailDaemon服務(wù)。
右鍵單擊重新啟動(dòng)使配置生效。
容器環(huán)境
用戶自定義標(biāo)識(shí)配置在Logtail容器的環(huán)境變量
ALIYUN_LOGTAIL_USER_DEFINED_ID中，可通過(guò)docker inspect ${logtail_container_name} | grep ALIYUN_LOGTAIL_USER_DEFINED_ID命令查看。登錄日志服務(wù)控制臺(tái)，在Project列表，單擊打開(kāi)目標(biāo)Project。
左側(cè)導(dǎo)航欄中，選擇。在打開(kāi)的機(jī)器組頁(yè)面中，選擇機(jī)器組右側(cè)的
> 創(chuàng)建機(jī)器組。在彈出的創(chuàng)建機(jī)器組頁(yè)面，填寫以下信息，并單擊確定。
參數(shù)
說(shuō)明
名稱
機(jī)器組名稱，命名規(guī)則如下所示：
只能包括小寫字母、數(shù)字、短劃線（-）和下劃線（_）。
必須以小寫字母或者數(shù)字開(kāi)頭和結(jié)尾。
長(zhǎng)度必須在 2~128 字符之間。
重要創(chuàng)建后，不支持修改機(jī)器組名稱，請(qǐng)謹(jǐn)慎填寫。
機(jī)器組標(biāo)識(shí)
選擇用戶自定義標(biāo)識(shí)。
機(jī)器組Topic
（可選）機(jī)器組Topic用于區(qū)分不同服務(wù)器產(chǎn)生的日志數(shù)據(jù)。更多信息，請(qǐng)參見(jiàn)日志主題。
用戶自定義標(biāo)識(shí)
填入上述步驟中配置的用戶自定義標(biāo)識(shí)。
查看機(jī)器組
在機(jī)器組列表中，單擊目標(biāo)機(jī)器組。在機(jī)器組配置頁(yè)面，可查看機(jī)器組配置信息以及服務(wù)器狀態(tài)。
心跳狀態(tài)為OK表示服務(wù)器上的Logtail實(shí)例與日志服務(wù)Project連接正常。
如果心跳狀態(tài)顯示FAIL，處理操作請(qǐng)參見(jiàn)Logtail機(jī)器組問(wèn)題排查思路（主機(jī)場(chǎng)景）。
重要創(chuàng)建機(jī)器組大約需要2分鐘。創(chuàng)建未生效，將導(dǎo)致心跳為FAIL。請(qǐng)2分鐘后單擊刷新進(jìn)行重試。
修改機(jī)器組
在機(jī)器組列表中，單擊目標(biāo)機(jī)器組。然后在機(jī)器組配置頁(yè)面，單擊頁(yè)面右上角的修改。
在機(jī)器組信息區(qū)域可切換機(jī)器組標(biāo)識(shí)，更新機(jī)器組Topic。如果是用戶自定義標(biāo)識(shí)機(jī)器組，可更新用戶自定義標(biāo)識(shí)。如果是IP地址機(jī)器組，可增刪改IP地址。
在管理配置區(qū)域可Logtail配置應(yīng)用到該機(jī)器組，或刪除已生效Logtail配置。
重要添加Logtail配置到機(jī)器組后，該Logtail配置會(huì)被下發(fā)到機(jī)器組內(nèi)的服務(wù)器的Logtail上。
從機(jī)器組移除Logtail配置后，該Logtail配置會(huì)從機(jī)器組內(nèi)的服務(wù)器的Logtail上移除。
修改完成后，單擊保存。
刪除機(jī)器組
在機(jī)器組列表中，選擇目標(biāo)機(jī)器組對(duì)應(yīng)的
> 刪除。在彈出的對(duì)話框中，輸入機(jī)器組名稱，并單擊確認(rèn)。
相關(guān)文檔
在日志服務(wù)Project中創(chuàng)建Logtail配置。更多信息，請(qǐng)參見(jiàn)采集主機(jī)文本日志。
管理機(jī)器組的API請(qǐng)參見(jiàn)：