全部產品
Search

搜尋本產品

    Simple Log Service：運行管理

    文件中心

    Simple Log Service：運行管理

    更新時間：Dec 03, 2025

    安裝LoongCollector後，您還需要瞭解如何管理LoongCollector的生命週期，回合組態等內容。

    LoongCollector常用命令

    啟動LoongCollector

    對採集效能有要求時，可修改啟動參數設定檔（ilogtail_config.json）後再啟動LoongCollector。
    sudo /etc/init.d/loongcollectord start

    停止LoongCollector

    sudo /etc/init.d/loongcollectord stop

    查看LoongCollector狀態

    sudo /etc/init.d/loongcollectord status #返回loongcollector is running表示啟動成功。

    查看LoongCollector版本

    cat /usr/local/ilogtail/app_info.json #版本資訊儲存在loongcollector_version欄位中。

    重啟LoongCollector

    sudo /etc/init.d/loongcollectord restart

    卸載LoongCollector

    1. 範例程式碼中${region_id}可使用cn-hangzhou替換，若想加快執行速度，請參考地區替換${region_id}為ECS所屬地區。

      wget https://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/loongcollector.sh -O loongcollector.sh;

    2. 執行卸載命令。

      chmod +x loongcollector.sh; sudo ./loongcollector.sh uninstall;

    升級LoongCollector

    升級包含LoongCollector版本升級與Logtail升級到LoongCollector兩種情況，兩種情況的升級命令相同。

    LoongCollector版本升級/Logtail升級到LoongCollector

    重要

    LoongCollector在升級時停止運行，升級完成後自動啟動。升級僅覆蓋必要檔案，設定檔和Checkpoint檔案將被保留，確保升級期間日誌不會丟失。

    1. 在伺服器上執行下載命令擷取最新安裝包，範例程式碼中${region_id}可使用cn-hangzhou替換，若想加快安裝包下載速度，請參考地區替換${region_id}為ECS所屬地區。

      wget https://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/loongcollector.sh -O loongcollector.sh;

    2. 執行升級命令：升級請使用upgrade命令。若使用install命令，將執行覆蓋安裝，丟失原配置。

      chmod +x loongcollector.sh; sudo ./loongcollector.sh upgrade;

    3. 若顯示以下資訊，則表示升級成功。 

      Upgrade loongcollector files successfully.
Starting loongcollector ...
Upgrade loongcollector successfully.

    LoongCollector復原到Logtail

    說明

    必須要重新下載logtail.sh指令碼，不能使用原來的logtail.sh指令碼。

    1. 在伺服器上執行下載命令擷取安裝包，範例程式碼中${region_id}可使用cn-hangzhou替換，若想加快安裝包下載速度，請參考地區替換${region_id}為ECS所屬地區。

      wget https://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail.sh -O logtail.sh;

    2. 執行復原命令。如需指定版本，如指定 1.8.7 版本，參考注釋，根據實際情況替換版本號碼。

      chmod +x logtail.sh; sudo ./logtail.sh upgrade;
#chmod +x logtail.sh; sudo ./logtail.sh upgrade -v -v 1.8.7;

    啟動參數設定檔（ilogtail_config.json）

    • 檔案描述：配置LoongCollector的啟動參數，啟動參數配置不合理會影響採集效能，配置錯誤可能導致採集異常問題發生。

    • 檔案路徑：/usr/local/ilogtail/ilogtail_config.json。

    • 使用情境：Log Service限制了LoongCollector的採集效能，以防消耗過多伺服器資源，影響其他服務運行。當LoongCollector採集效能不滿足要求時，可通過修改啟動參數進行嘗試。

    • 檔案樣本 ：

      {
    "primary_region" : "cn-beijing", // 預設地區，可忽略
    "config_servers" : //擷取採集配置時的地址
    [
        "http://logtail.cn-beijing.log.aliyuncs.com"
    ],
    "data_servers" : //與Log Service進行資料轉送的地址
    [
        {
            "region" : "cn-beijing",
            "endpoint_list": [
                "cn-beijing.log.aliyuncs.com"
            ]
        }
    ],
    "cpu_usage_limit" : 0.4,
    "mem_usage_limit" : 384,
    "max_bytes_per_sec" : 20971520,
    "bytes_per_sec" : 1048576,
    "buffer_file_num" : 25,
    "buffer_file_size" : 20971520,
    "buffer_map_num" : 5
}

    • 參數表：下表僅列出需要關注的常用啟動參數，請根據需要新增或修改。未列出的參數請保持預設配置。

      ilogtail_config.json啟動參數表

      參數

      類型

      說明

      樣本

      cpu_usage_limit

      double

      CPU使用閾值，以單核計算。取值如下：

      • 取值範圍：0.1~當前機器的CPU核心數

      • 預設值：0.4

      警告

      cpu_usage_limit為軟式節流，實際佔用的CPU可能超過限制值，超限5分鐘後將觸發熔斷保護自動重啟。

      例如設定為0.4，表示Log Service將儘可能限制採集器的CPU使用為CPU單核的40%，超出後自動重啟。

      一般情況下，通過極簡模式採集日誌時，單核處理能力約100 MB/s；通過完整正則模式採集日誌時，單核處理能力約20 MB/s 。

      "cpu_usage_limit" : 0.4

      mem_usage_limit

      int

      記憶體使用量閾值。取值如下：

      • 取值範圍：128 MB ~ 8192 MB

      • 預設值：384 MB（主機），2048 MB（ACK組件）

      警告

      mem_usage_limit為軟式節流，實際佔用的記憶體可能超過限制值，超限5分鐘後將觸發熔斷保護自動重啟。

      採集速率、監控目錄和檔案數量、發送阻塞程度與mem_usage_limit參數有關。更多請參見限制說明。

      "mem_usage_limit" : 384

      max_bytes_per_sec

      int

      每秒鐘發送未經處理資料的流量限制。取值如下：

      • 取值範圍：1024 Byte/s ~ 52428800 Byte/s

      • 預設值：20971520 Byte/s

        重要

        設定的值超過20971520 Byte/s（20MB/s），表示不限速。

      例如設定為2097152，表示發送資料的速率為2 MB/s。

      "max_bytes_per_sec" : 2097152

      process_thread_count

      int

      處理資料的線程數。 取值如下：

      • 取值範圍：1~64

      • 預設值：1

      一般情況下，可以處理極簡模式下24 MB/s的資料寫入或完整正則模式12 MB/s的資料寫入。預設情況下無需調整該參數取值。

      "process_thread_count" : 1

      send_request_concurrency

      int

      非同步並發的個數。取值如下：

      • 取值範圍：1~50

      • 預設值：20

      如果寫入TPS很高，可以設定更高的非同步並發個數。可以按照一個並發支援0.5 MB/s~1 MB/s網路吞吐來計算，實際根據網路延時而定。

      說明

      設定非同步並發個數過高容易導致網路連接埠佔用過多，需調整TCP相關參數。

      "send_request_concurrency" : 4

      buffer_file_num

      int

      限制快取檔案的最大數目。取值如下：

      • 取值範圍：1~100

      • 預設值：25

      遇到網路異常、寫入配額超限等情況時，採集器將即時解析後的日誌寫入本地檔案（安裝目錄下）緩衝起來，等待恢複後嘗試重新發送。

      "buffer_file_num" : 25

      buffer_file_size

      int

      單個快取檔案允許的最大位元組數。取值如下：

      • 取值範圍：1048576 Byte ~ 104857600 Byte

      • 預設值：20971520 Byte

      buffer_file_size*buffer_file_num是快取檔案可以實際使用的最大磁碟空間。

      "buffer_file_size" : 20971520

      buffer_file_path

      String

      快取檔案存放目錄。 預設值為空白，即快取檔案存放於安裝目錄/usr/local/ilogtail下。

      當您設定此參數後，需手動將原目錄下名為logtail\_buffer\_file_*的檔案移動到此目錄，以保證採集器可以讀取到該快取檔案並在發送後進行刪除。

      "buffer_file_path" : ""

      bind_interface

      String

      本機綁定的網卡名。預設值為空白，自動綁定可用的網卡。

      如果設定為指定的網卡（例如eth1），則表示將強制使用該網卡上傳日誌。

      "bind_interface" : ""

      check_point_filename

      String

      checkpoint檔案的儲存路徑， 預設值：/tmp/logtail_check_point。

      "check_point_filename" : /tmp/logtail_check_point

      check_point_dump_interval

      int

      更新Checkpoint檔案的周期，預設值：900，單位：秒。即預設情況下每15分鐘更新一次Checkpoint檔案。

      "check_point_dump_interval" : 900

      user_config_file_path

      String

      設定檔的儲存路徑，預設為進程binary所在目錄，檔案名稱為user_log_config.json。

      "user_config_file_path" : user_log_config.json

      discard_old_data

      Boolean

      是否丟棄歷史日誌。預設值：true，表示丟棄距離目前時間超過12小時的日誌。

      "discard_old_data" : true

      ilogtail_discard_interval

      int

      丟棄歷史日誌距離目前時間的閾值。預設值：43200（12小時），單位：秒。

      "ilogtail_discard_interval": 43200

      working_ip

      String

      預設值為空白，表示自動從本伺服器擷取IP地址。修改後將以該值作為伺服器的IP地址上報。

      "working_ip" : ""

      working_hostname

      String

      上報的本伺服器的主機名稱。預設值為空白，表示自動從本伺服器擷取主機名稱。

      "working_hostname" : ""

      max_read_buffer_size

      long

      每條日誌讀取的最大值。預設值：524288（512 KB），最大值：8388608（8 MB）。單位：Byte。

      如果您的單條日誌超過524288 Byte，可修改此參數。

      "max_read_buffer_size" : 524288

      oas_connect_timeout

      long

      發起擷取採集配置、存取金鑰等請求時，串連階段的逾時時間。預設值：5，單位：秒。

      網路條件較差，建立連線時間過長時可修改此參數。

      "oas_connect_timeout" : 5

      oas_request_timeout

      long

      發起擷取採集配置、存取金鑰等請求時，整個要求階段的逾時時間。預設值：10，單位：秒。

      網路條件較差，建立連線時間過長時可修改此參數。

      "" : 10

      data_server_port

      long

      設定data_server_port為443後，將通過HTTPS協議傳輸資料到Log Service。

      "data_server_port": 443

      enable_log_time_auto_adjust

      Boolean

      設定enable_log_time_auto_adjust為true後，日誌時間可自適應伺服器本地時間。

      出於資料安全考慮，Log Service會對請求（包括Logtail發起的請求）所攜帶的時間進行校正，拒絕與Log Service端時間相差超過15分鐘的請求。採集器發起請求時所攜帶的時間為伺服器本地時間，當伺服器本地時間被修改後（例如某些測試情境下需要調整本地時間為未來時間），請求將被拒絕，導致寫入資料失敗。您可以使用該參數實現日誌時間自適應伺服器本地時間。

      重要

      • 開啟該功能後，日誌時間將被加上Log Service端的時間與伺服器本地時間的位移量。由於位移量只在請求被Log Service端拒絕時更新，因此可能出現Log Service端所查詢到的日誌的時間和日誌實際的寫入時間不一致的情況。

      • LoongCollector的部分邏輯依賴於系統時間的遞增，建議在每次機器時間調整後重啟採集器。

      "enable_log_time_auto_adjust": true

      accept_multi_config

      Boolean

      是否允許多個採集配置採集同一個檔案。預設值：false，表示不允許。

      預設情況下，一個檔案只能被一個採集配置採集，您可以通過該參數消除限制。每個採集配置的處理過程是獨立的，當允許多個採集配置採集同一個檔案時，需要消耗多倍的CPU、記憶體開銷。

      "accept_multi_config": true

      enable_checkpoint_sync_write

      Boolean

      是否開啟sync寫功能。預設值：false，表示不開啟。

      sync寫功能主要用於搭配ExactlyOnce寫入功能。開啟ExactlyOnce寫入功能後，採集器會在本地磁碟記錄細粒度的Checkpoint資訊（檔案層級）。但出於效能考慮，預設寫入Checkpoint時不會調用sync落盤，所以如果機器重啟導致buffer資料來不及寫入磁碟時，可能導致Checkpoint丟失。此時，您可以設定enable_checkpoint_sync_write為true，開啟sync寫功能。更多資訊，請參見Logtail配置（舊版）。

      "enable_checkpoint_sync_write": false

      enable_env_ref_in_config

      Boolean

      是否啟用採集配置環境變數替換功能。預設值：false。

      開啟該功能後，您可以在控制台的採集配置中使用${xxx}作為環境變數xxx的預留位置。例如設定採集路徑為/${xxx}/logs，環境變數為xxx=user，則生效的採集路徑為/user/logs。

      如果配置中需要使用${、}，則您可以使用$${、$}進行轉義。

      "enable_env_ref_in_config": false

      logreader_max_rotate_queue_size

      Int

      輪轉隊列最大長度。預設值：20。當日誌採集發生阻塞或延時，待採集的檔案會持有檔案控制代碼在隊列中等待。

      當採集延時，如果需要控制磁碟最大用量，可考慮減小該值。

      警告

      當延時的檔案數超過該值時，將直接跳過新檔案的採集。

      "logreader_max_rotate_queue_size" : 10

      data_endpoint_policy

      string

      對Log Service訪問網域名稱的切換策略。可選值如下：

      說明

      您可以在ilogtail_config.json檔案的data_server參數中，查看是否已配置預設網域名稱。

      • designated_first（預設）

        • 如果已指定某個地區的預設網域名稱且預設網域名稱可用，則系統優先使用預設網域名稱。

        • 如果已指定某個地區的預設網域名稱但預設網域名稱不可用，則系統會自動選擇一個可用網域名稱。

        • 如果未指定某個地區的預設網域名稱，則系統會自動選擇一個可用網域名稱。

      • designated_locked

        • 如果已指定某個地區的預設網域名稱，不管其是否可用，系統都將只使用預設網域名稱。

        • 如果未指定某個地區的預設網域名稱，系統會自動選擇一個可用網域名稱。

      "data_endpoint_policy" : "designated_first"

      inotify_black_list

      Array<String>

      inotify監聽黑名單，黑名單為完全符合，此列表中的目錄不會啟用inotify監聽。

      "inotify_black_list": ["/tmp"]

      host_path_blacklist

      String

      全域主機路徑黑名單，黑名單為子串匹配。Linux系統下多個子串以半形冒號（:）分隔。

      例如"host_path_blacklist" : "/volumes/kubernetes.io~csi/nas-"表示禁止採集NAS掛載資料。

      "host_path_blacklist" : "/volumes/kubernetes.io~csi/nas-"

      LOGTAIL_LOG_LEVEL

      String

      日誌列印層級，需通過環境變數進行配置。預設值：空，表示info，可選值trace、debug、info、warning、error和fatal。

      LOGTAIL_LOG_LEVEL=info

      FORCE_RELEASE_STOP_CONTAINER_FILE

      Boolean

      • 配置方式：僅支援通過環境變數方式進行配置。

      • 功能描述：當該參數設定為 true 時，採集器會在業務容器退出時立即釋放容器檔案控制代碼。此操作可防止因檔案控制代碼未釋放而導致容器無法正常退出。

      • 注意事項：

        • 此時無法保證容器內資料擷取的完整性。

        • 建議在業務退出前增加幾秒的延遲，以確保日誌能夠完整採集。

      "FORCE_RELEASE_STOP_CONTAINER_FILE" : "true"

    • 樣本情境：以下列舉一些常見的情境下的操作樣本供參考：

    採集效能配置規劃

    為防止採集器消耗過多伺服器資源，影響其他服務運行，Log Service對採集效能做了限制。當需要提升採集效能時，可修改啟動參數。

    推薦參數值樣本

    根據實際經驗推薦如下參數配置，適用於普通JSON檔案的採集情境。完整正則模式和分隔字元模式的效能與JSON模式相近，極簡模式效能為JSON模式的5倍。由於資料、規則的複雜度、採集目錄和檔案的數量都會對CPU和記憶體消耗帶來影響，請參照下述表格並結合實際情況按需調整。

    添加或修改/usr/local/ilogtail/ilogtail_config.json中參數取值，並重啟LoongCollector使修改生效。不同採集速率下的建議值參考如下：

    說明

    按表格中的採集速率大於40 MB/s列配置啟動參數時，採集效能已接近極限。

    參數

    描述

    採集速率大於10 MB/s

    採集速率大於20 MB/s

    採集速率大於40 MB/s

    cpu_usage_limit

    CPU使用閾值，以單核計算。

    • 取值範圍：0.1~當前機器CPU核心數

    • 預設值：0.4

    0.4表示Log Service將儘可能限制採集器對CPU單核使用不超過40%，超出後LoongCollector自動重啟。

    該項為軟式節流，實際佔用的CPU可能超過限制值，超限5分鐘後將觸發熔斷保護自動重啟。

    1

    2

    4

    mem_usage_limit

    記憶體使用量閾值。

    • 取值範圍：128 MB ~ 8192 MB

    • 預設值：384 MB

    採集速率、監控目錄和檔案數量、發送阻塞程度與該參數有關。更多請參見限制說明

    該項為軟式節流，實際佔用的記憶體可能超過限制值，超限5分鐘後將觸發熔斷保護自動重啟。

    1024

    2048

    4096

    process_thread_count

    採集器處理資料的線程數。

    • 取值範圍：1~64

    • 預設值：1

    單線程可以處理極簡模式下24 MB/s的資料寫入或完整正則模式12 MB/s的資料寫入。預設情況下無需調整該參數取值。

    2

    4

    8

    send_request_concurrency

    非同步並發的個數。

    • 取值範圍：1~50

    • 預設值：20

    如果寫入TPS很高，可以設定更高的非同步並發個數。可以按照一個並發支援0.5 MB/s~1 MB/s網路吞吐來計算，實際根據網路延時而定。

    20

    40

    80

    日誌傳輸網路延遲高、傳輸不穩定

    發生日誌丟失或重複發送，LoongCollector 發送日誌時頻繁重試，網路連接中斷或波動頻繁等現象。可能的原因是：

    • 網路頻寬不足：當採集的日誌量較大時，若網路頻寬不足以支撐傳輸需求，會導致日誌堆積、延遲增加。

    • 網路環境不穩定：跨地區、跨網路可能導致網路延遲或丟包。

    解決方案

    利用阿里雲CDN邊緣節點進行日誌採集加速，相對公網採集在網路延遲、穩定性上具有很大優勢。開啟該功能將根據實際傳輸的資料量進行額外計費。

    1. 需要先開啟Project的日誌跨域傳輸加速功能。

    2. 停止LoongCollector：登入安裝LoongCollector的伺服器，執行sudo /etc/init.d/loongcollectord stop命令。

    3. 修改傳輸網域名稱：替換/usr/local/ilogtail/ilogtail_config.json中data_servers參數下的endpoint_list參數的值為log-global.aliyuncs.com。這表明將資料轉送所使用的網域名稱變更為傳輸加速網域名稱。

    4. 啟動LoongCollector：執行sudo /etc/init.d/loongcollectord start命令。

    單條日誌過大被截斷

    發生單條日誌長度過大，採集後日誌被截斷的現象，原因是每條日誌讀取的最大值預設為524288（512 KB），若超過該值Log Service將截斷日誌。多行日誌按行首Regex劃分後，每條日誌大小限制仍為512 KB，若超限會被強制拆分為多條進行採集。

    解決方案

    1. 在/usr/local/ilogtail/ilogtail_config.json中修改max_read_buffer_size參數的值，若該參數不存在則新增。該參數取值最大為8388608（8 MB）。

      請注意記憶體佔用線性增長，需預留max_read_buffer_size*檔案並發數記憶體。

    2. 重啟LoongCollector：執行sudo /etc/init.d/loongcollectord restart命令。

    傳輸時發生間隔15分鐘以上日誌丟失

    發生採集日誌時可以正常傳輸，但部分日誌丟失，且丟失日誌時間戳記與當前Log Service服務端時間相差15分鐘以上的現象，原因可能是出於資料安全考慮，Log Service會對請求（包括LoongCollector發起的請求）所攜帶的時間進行校正，拒絕與Log Service端時間相差超過15分鐘的請求。當伺服器本地時間被修改後（例如某些測試情境下需要調整本地時間為未來時間），則導致請求被拒絕，寫入資料失敗。

    解決方案

    1. 在/usr/local/ilogtail/ilogtail_config.json中修改enable_log_time_auto_adjust參數的值為true，若該參數不存在則新增。設定後日誌時間可自適應伺服器本地時間。

      開啟該功能後，日誌時間將被加上Log Service端的時間與伺服器本地時間的位移量。由於位移量只在請求被Log Service端拒絕時更新，因此可能出現Log Service端所查詢到的日誌的時間和日誌實際的寫入時間不一致的情況。

    2. 重啟LoongCollector：執行sudo /etc/init.d/loongcollectord restart命令。

    切換至其他地區Project

    由於某些原因，在伺服器上採集的日誌需要儲存到新的Project中。

    解決方案

    1. 若需要複用採集配置，請先儲存採集設定檔中內容，卸載操作會刪除該檔案。

    2. 卸載伺服器上的LoongCollector。

    3. 根據新Project與伺服器的關係，選擇對應的LoongCollector安裝方案。

    4. 如果要將歷史資料也一併轉移到新Project，此處提供兩種方式：

    日誌傳輸延時過長最佳化

    發生Log Service的日誌時間戳記和伺服器生產日誌的時間相差在三秒以上的現象，原因可能是：

    • 同時採集的檔案數超過100個或者監控的目錄下的檔案數超過5000個，佔用大量記憶體。

    • 日誌資料流量大（例如極簡模式下超過2 MB/s，正則模式下超過1 MB/s），CPU佔用率過高。

      開通CloudLens for SLS，在採集監控可以查看當前主機的CPU佔用率。

    • LoongCollector發送資料到Log Service的速率超過10MB/s。

      開通CloudLens for SLS，在採集監控可以查看當前主機的採集速率。

    解決方案

    參考上述可能原因調整檔案數量或資料流量。如果無法減少記憶體使用量或降低傳輸串流量，建議參考採集效能配置規劃調整採集效能。

    其他常用設定檔

    LoongCollector運行時一系列設定檔與資訊記錄檔案如下：

    LoongCollector採集設定檔（user_log_config.json）

    • 描述：檔案記錄LoongCollector從Log Service擷取的採集配置資訊，每次採集配置更新時會同步更新該檔案。除手動設定AccessKey資訊、資料庫密碼等敏感資訊外，不建議修改該檔案。

    • 路徑：/usr/local/ilogtail/user_log_config.json。

    • 使用情境：可通過查看該檔案確認採集配置是否已經下發到伺服器。若該檔案存在，且內容與Log Service上的採集配置一致，表示採集配置已下發。

    AppInfo記錄檔案（app_info.json）

    • 描述：app_info.json檔案記錄LoongCollector的啟動時間、擷取到的IP地址、主機名稱等資訊。該檔案僅作記錄，任何修改操作均不會生效。

    • 路徑：/usr/local/ilogtail/app_info.json。

    • 使用情境：可查看Log Service採集時識別到的伺服器ip資訊，判斷與Log Service控制台中IP型機器組內IP資訊是否一致，一般用於解決IP型機器組心跳失敗問題。

      如果已在伺服器的/etc/hosts檔案中設定了主機名稱與IP地址綁定，則自動擷取綁定的IP地址。如果沒有設定主機名稱綁定，會自動擷取原生第一塊網卡的IP地址。若設定了ilogtail_config.json中的working_ip參數，則以working_ip值作為伺服器的IP地址。

    LoongCollector作業記錄（loongcollector.LOG）

    • 描述：loongcollector.LOG檔案記錄了LoongCollector的作業記錄，記錄層級從低到高分別為INFO、WARN和ERROR。

    • 路徑：/usr/local/ilogtail/loongcollector.LOG。

    • 使用情境：如果採集異常，請先使用LoongCollector運行情況診斷與監控排查錯誤，根據日誌採集錯誤類型排查具體的錯誤類型和LoongCollector作業記錄排查問題。

    使用者ID檔案

    • 描述：包含日誌採集到的Project所屬的阿里雲主帳號ID資訊，檔案名稱即帳號ID，無需尾碼，用於標識該帳號有許可權訪問、採集這台伺服器的日誌。

    • 路徑：/etc/ilogtail/users/{阿里雲帳號ID}。

    • 使用情境：只有在採集非本帳號ECS、自建伺服器、其他雲廠商伺服器日誌時需要配置使用者ID。多個帳號對同一台伺服器進行日誌採集時，支援在同一台伺服器上建立多個使用者ID檔案。

    使用者自訂標識檔案

    • 描述：用於配置使用者自訂標識，作為使用者自訂標識機器組的內容，協助Log Service探索服務器上的LoongCollector並建立心跳。

    • 路徑：/etc/ilogtail/user_defined_id。

    • 使用情境：使用使用者自訂機器組時需要配置，瞭解更多資訊請參考機器組與LoongCollector採集配置關聯指南。

    CheckPoint檔案

    • 描述：checkpoint機制用於記錄Log Service當前採集位置以確保日誌完整性。

    • 路徑：預設為/tmp/logtail_checkpoint。

    • 使用情境：可參考限制說明修改啟動參數檔案進行管理。

    常見問題

    伺服器無法串連外部網路時如何升級

    1. 在需要升級LoongCollector的伺服器上執行uname -m查看系統架構後，在可以訪問公網的伺服器上選擇對應命令執行：${region_id}需替換為Project所屬地區的地區。

      • ARM架構：

        wget https://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/loongcollector.sh;wget http://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/aarch64/main/loongcollector-linux64.tar.gz;

      • x86-64架構：

        wget https://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/loongcollector.sh;wget http://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/x86_64/main/loongcollector-linux64.tar.gz;

    2. 將安裝指令碼和安裝包拷貝至需要升級LoongCollector的伺服器上後，執行命令：

      chmod +x loongcollector.sh;./loongcollector.sh upgrade-local;