機器組概述

機器組是包含多台伺服器的虛擬分組，Log Service通過機器組的方式管理所有需要通過Logtail採集日誌的伺服器，支援將多台伺服器上的日誌採集到一個Logstore中。

前提條件

已建立Project，具體請參見建立專案Project。
伺服器已安裝Logtail，具體請參見安裝、運行、升級、卸載Logtail。

Simple Log ServiceProject支援將一個Logtail採集配置應用到多個機器組，或將一個機器組綁定到多個Logtail採集配置。如需採集多個伺服器上的資料，您可根據伺服器部署地區或類別將它們分成多個獨立的機器組，並將Logtail採集配置應用到指定的機器組。Simple Log Service便會將該配置下發至機器組內的所有的伺服器，從而採集伺服器上的資料。

建立機器組

步驟一：配置使用者標識（可選）

說明

存在如下任一情況時，需要在伺服器上配置使用者標識，若ECS與Log Service同帳號可跳過該步驟。使用者標識的作用在於標識這台伺服器有許可權被該帳號訪問，並授權Log ServiceProject通過Logtail採集該伺服器日誌。

伺服器類型不是ECS。
伺服器類型是ECS，但是與Log Service不屬於同一個帳號。

使用阿里雲帳號（主帳號）登入Log Service控制台。滑鼠懸浮在右上方帳戶圖片，然後在彈出的標籤頁中查看並複製帳號ID。如果您使用RAM使用者登入，請複製主帳號ID。
登入需要採集資料的伺服器，通過以下方式配置使用者標識，即配置阿里雲帳號ID檔案。
Linux系統
- 在/etc/ilogtail/users目錄下，建立Log Service所屬的阿里雲帳號ID檔案。
```
touch /etc/ilogtail/users/{阿里雲帳號ID}
```
  重要
  如果/etc/ilogtail/users目錄不存在，請手動建立目錄。
  新增、刪除使用者標識後，1分鐘之內即可生效。
- 當您使用多個阿里雲帳號下的Log ServiceProject對同一台伺服器進行日誌採集時，您可以在同一台伺服器上建立多個阿里雲帳號ID檔案。例如：
```
touch /etc/ilogtail/users/{阿里雲帳號ID 1}
touch /etc/ilogtail/users/{阿里雲帳號ID 2}
```
Windows系統
- 在C:\LogtailData\users目錄下，建立Log Service所屬的阿里雲帳號ID檔案。
  - 使用Windows PowerShell。
    ni C:\LogtailData\users\{阿里雲帳號ID}
  - 使用命令提示字元（cmd）。
    type nul > C:\LogtailData\users\{阿里雲帳號ID}
- 當您使用多個阿里雲帳號下的Log ServiceProject對同一台伺服器進行日誌採集時，您可以在同一台伺服器上建立多個阿里雲帳號ID檔案。
容器環境
如果Logtail部署在阿里雲Kubernetes叢集中，且為Logtail-ds 1.7.3及以上版本，則您可以通過Container Service管理主控台設定使用者自訂標識，即在組件管理頁面，修改logtail-ds組件中的LogtailDSExternalUserDefinelDs參數。具體操作，請參見管理組件。
說明
- 使用者標識配置只需設定檔名，無需設定檔尾碼。
- 一台伺服器上可配置多個使用者標識，Logtail容器中僅支援配置一個使用者標識。
- 若您不再使用某個使用者標識，直接刪除伺服器上阿里雲帳號ID檔案即可。

步驟二：建立機器組

說明

Simple Log ServiceProject支援使用IP地址或使用者自訂標識建立機器組。使用IP地址建立相對更簡單，但使用使用者自訂標識具有以下優勢，推薦使用。

在VPC等自訂網路環境中，可能出現伺服器IP地址衝突問題，導致Logtail採集失敗。使用使用者自訂標識可避免此類情況發生。
使用使用者自訂標識可實現機器組的Auto Scaling。為新增的伺服器配置相同的使用者自訂標識，Simple Log Service可自動識別，並將其添加至機器組中。如果不再需要採集伺服器日誌，直接刪除在伺服器上配置的使用者自訂標識檔案，Simple Log Service可自動將該伺服器從機器組中移除。

建立使用者自訂標識機器組

通常情況下，業務系統由多個模組組成，每個模組都可以進行獨立的水平擴充，即支援添加多台伺服器。為了實現高效的日誌資料收集和分類，建議為每個模組建立單獨的機器組。使用者需要在各個模組的伺服器上配置自訂標識，以確保每個伺服器能歸屬於正確的機器組。

例如常見網站分為前端HTTP請求處理模組、緩衝模組、邏輯處理模組和儲存模組，其自訂標識可以分別定義為http_module、cache_module、logic_module和store_module。

重要

同一機器組中不允許同時存在Linux和Windows伺服器，請勿在Linux和Windows伺服器上配置相同的使用者自訂標識。
一個伺服器可配置多個使用者自訂標識，標識之間以分行符號分割。

配置使用者自訂標識。
Linux環境
1. 登入已安裝Logtail的Linux伺服器，使用以下命令配置使用者自訂標識。
  說明
  如果目錄/etc/ilogtail/不存在，請先手動建立該目錄。
```
echo "user-defined-1" > /etc/ilogtail/user_defined_id
```
2. （可選）使用以下命令檢查使用者自訂標識是否寫入成功。如果返回user-defined-1，則表示寫入成功。
```
cat /etc/ilogtail/user_defined_id
```
3. 新增、刪除、修改user_defined_id檔案後，預設情況下，1分鐘內生效。如果需要立即生效，請執行以下命令重啟Logtail。
```
/etc/init.d/ilogtaild stop
/etc/init.d/ilogtaild start
```
Windows環境
1. 登入已安裝Logtail的Windows伺服器，在C:\LogtailData目錄下建立user_defined_id檔案並寫入user-defined-1，完成後儲存。
  說明
  如果目錄C:\LogtailData不存在，請先手動建立該目錄。
2. 新增、刪除、修改user_defined_id檔案後，預設情況下，1分鐘內生效。如需立即生效，請根據以下步驟重啟Logtail。
  1. 選擇開始 > 控制台 > 管理工具 > 服務。
  2. 在服務對話方塊中，選擇對應的服務。
  3. 如果是0.x.x.x版本，選擇LogtailWorker服務。
  4. 如果是1.0.0.0及以上版本，選擇LogtailDaemon服務。
  5. 按右鍵重新啟動使配置生效。
容器環境
使用者自訂標識配置在Logtail容器的環境變數ALIYUN_LOGTAIL_USER_DEFINED_ID中，可通過docker inspect ${logtail_container_name} | grep ALIYUN_LOGTAIL_USER_DEFINED_ID命令查看。
登入Log Service控制台，在Project列表，單擊開啟目標Project。在左側導覽列中，選擇資源 > 機器組。在開啟的機器組頁面中，選擇機器組右側的 > 建立機器組。

在彈出的建立機器組頁面，填寫以下資訊，並單擊確定。

參數	說明
名稱	機器組名稱，命名規則如下所示：只能包括小寫字母、數字、短劃線（-）和底線（_）。必須以小寫字母或者數字開頭和結尾。長度必須在 2~128 字元之間。重要建立後，不支援修改機器組名稱，請謹慎填寫。
機器組標識	選擇使用者自訂標識。
機器組Topic	（可選）機器組Topic用於區分不同伺服器產生的日誌資料。更多資訊，請參見日誌主題。
使用者自訂標識	填入配置步驟中已配置的使用者自訂標識，例如`user-defined-1`。

建立IP地址機器組

登入Log Service控制台，在Project列表，單擊開啟目標Project。
左側導覽列中，選擇資源 > 機器組。在開啟的機器組頁面中，選擇機器組右側的 > 建立機器組。

在彈出的建立機器組頁面，填寫以下資訊，並單擊確定。

參數	說明
名稱	機器組名稱，命名規則如下所示：只能包括小寫字母、數字、短劃線（-）和底線（_）。必須以小寫字母或者數字開頭和結尾。長度必須在 2~128 字元之間。重要建立後，不支援修改機器組名稱，請謹慎填寫。
機器組標識	選擇IP地址。
機器組Topic	（可選）機器組Topic用於區分不同伺服器產生的日誌資料。更多資訊，請參見日誌主題。
IP地址	填入Logtail自動擷取的伺服器IP：在已安裝Logtail的伺服器，開啟`app_info.json`檔案，並查看`ip`欄位的值。 `app_info.json`檔案路徑說明如下所示。 Logtail自動擷取的伺服器IP地址記錄在`app_info.json`檔案的`ip`欄位中，如下所示。重要存在多台伺服器時，請手動輸入對應的IP地址，IP地址之間需使用分行符號分隔。同一機器組中不允許同時存在Linux和Windows伺服器。請勿將Windows和Linux伺服器IP添加到同一機器組中。

查看機器組配置

在機器組列表中，單擊目標機器組進入機器組配置頁面。您可在此查看機器組資訊、機器組狀態和管理配置。

如果心跳狀態顯示OK，則表示伺服器上的Logtail執行個體與Simple Log ServiceProject串連正常。
如果心跳狀態顯示FAIL，可能是配置未生效導致（配置生效時間大約需要2分鐘）。如果2分鐘後依然顯示FAIL，則可能是其他配置問題，您可參見Logtail機器組問題排查思路（主機情境）處理。

應用Logtail採集配置到機器組

在機器組列表中，單擊目標機器組進入機器組配置頁面。然後單擊該頁面右上方的修改。
在管理配置地區，選擇左側的Logtail採集配置，然後單擊>，將其移動到右側已生效Logtail配置地區。
重要
- 添加Logtail配置到機器組後，該Logtail配置會被下發到機器組內的伺服器的Logtail上。
- 從機器組移除Logtail配置後，該Logtail配置會從機器組內的伺服器的Logtail上移除。
修改完成後，單擊儲存。

修改機器組資訊

在機器組列表中，單擊目標機器組進入機器組配置頁面。然後單擊該頁面右上方的修改。
Log Service支援修改以下機器組資訊：
- 更改機器組標識：用於切換機器群組類型。
- 更新機器組Topic：機器組Topic作用請參見日誌主題。
- 更新使用者自訂標識或IP地址：在此處可以增加或者刪除機器組中的機器，機器之間通過分行符號分割。需要注意與機器組標識中所選類型一致。
  重要
  新增加的機器上需已安裝Logtail，若未安裝，添加到機器組中不會自動進行Logtail的安裝，可能導致心跳FAIL。
修改完成後，單擊儲存。

刪除機器組

在機器組列表中，選擇目標機器組對應的 > 刪除。
在彈出的對話方塊中，輸入機器組名稱，並單擊確認。

Simple Log Service：機器組

前提條件