注意事項(xiàng)

• 阿里云Filebeat僅支持Docker運(yùn)行環(huán)境，不支持其他運(yùn)行環(huán)境，例如Containerd、安全沙箱等。如果使用的是非Docker環(huán)境，會導(dǎo)致在創(chuàng)建Filebeat后，采集器一直處于生效中狀態(tài)。

• 阿里云Filebeat僅支持安裝在專有版ACK和托管版ACK上，不支持安裝在其他版本上。

  重要

  僅1.18和1.20版本的Kubernetes支持遠(yuǎn)程構(gòu)建。

操作步驟

1. 登錄阿里云Elasticsearch控制臺。
2. 進(jìn)入Beats數(shù)據(jù)采集中心。
   1. 在頂部菜單欄處，選擇地域。
   2. 在左側(cè)導(dǎo)航欄，單擊Beats數(shù)據(jù)采集中心。
   3. 可選：首次進(jìn)入Beats數(shù)據(jù)采集中心頁面，需要在服務(wù)授權(quán)對話框中查看提示信息，無誤后單擊確認(rèn)，授權(quán)系統(tǒng)創(chuàng)建服務(wù)關(guān)聯(lián)角色。
      說明 Beats采集不同數(shù)據(jù)源中的數(shù)據(jù)時，依賴于服務(wù)關(guān)聯(lián)角色以及角色規(guī)則。使用過程中請勿刪除服務(wù)關(guān)聯(lián)角色，否則會影響B(tài)eats使用。詳細(xì)信息，請參見Elasticsearch服務(wù)關(guān)聯(lián)角色。

3. 在創(chuàng)建采集器區(qū)域，將鼠標(biāo)移至Filebeat上，單擊ACK日志。

4. 在選擇目標(biāo)ES集群配置向?qū)е校渲貌杉餍畔ⅰ?/span>

   

   參數(shù)	說明
   采集器名稱	自定義輸入采集器的名稱。長度為1~30個字符，以大小寫字母開頭，可以包含字母、數(shù)字、下劃線（_）或連字符（-）。
   安裝版本	目前Filebeat只支持6.8.13版本。
   采集器Output	Filebeat采集內(nèi)容的輸出地址。直接關(guān)聯(lián)已經(jīng)創(chuàng)建的阿里云Elasticsearch實(shí)例。訪問協(xié)議需要與所選Elasticsearch實(shí)例保持一致。 重要 不支持選擇8.x版本的Elasticsearch實(shí)例。
   用戶名密碼	訪問阿里云Elasticsearch實(shí)例的用戶名和密碼。用戶名默認(rèn)為elastic，密碼在創(chuàng)建實(shí)例時設(shè)定，如果忘記可重置。重置密碼的注意事項(xiàng)和操作步驟，請參見重置實(shí)例訪問密碼。
   啟用Monitoring	用來監(jiān)控Filebeat的相關(guān)指標(biāo)。采集器Output選擇Elasticsearch，Monitor默認(rèn)使用和采集器Output相同的阿里云Elasticsearch實(shí)例。
   啟用Kibana Dashboard	用來配置默認(rèn)的Kibana Dashboard。由于阿里云Kibana配置在專有網(wǎng)絡(luò)內(nèi)，因此需要在Kibana配置頁面開通Kibana私網(wǎng)訪問功能。具體操作，請參見配置Kibana公網(wǎng)或私網(wǎng)訪問白名單。

5. 單擊下一步，在設(shè)置采集目標(biāo)配置向?qū)е校渲貌杉繕?biāo)信息。

   1. 在ACK目標(biāo)集群中，選擇需要進(jìn)行數(shù)據(jù)采集的目標(biāo)集群。

      重要

      請選擇與Elasticsearch實(shí)例在同一專有網(wǎng)絡(luò)、Running狀態(tài)和非邊緣托管版（什么是容器服務(wù) Edge 版）的ACK集群。

   2. 根據(jù)提示，單擊安裝，安裝采集依賴的ES-operator。

      沒有安裝按鈕，表示已經(jīng)安裝。安裝后，安裝按鈕消失，代表安裝成功。

   3. 單擊+創(chuàng)建采集目標(biāo)，配置采集目標(biāo)信息（支持多個）。

      

      參數(shù)	說明
      采集目標(biāo)名稱	創(chuàng)建多個采集目標(biāo)時，名稱不可重復(fù)。
      命名空間	選擇采集Pod所在的命名空間。如果創(chuàng)建Pod時，未指定命名空間，則默認(rèn)是default。
      Pod Label	添加Pod標(biāo)簽。添加多個標(biāo)簽時，多個標(biāo)簽之間為邏輯與關(guān)系。 重要 刪除Pod標(biāo)簽時，需要至少存在兩個標(biāo)簽。 只能定義為Pod對應(yīng)的Label，不能指定為其他Label，否則會創(chuàng)建失敗（例如不能指定為Deployment Label）。
      容器名稱	指定完整的容器名稱。不填時，F(xiàn)ilebeat會采集命名空間下符合Pod標(biāo)簽的所有容器。

      說明

      獲取Pod相關(guān)信息（命名空間、標(biāo)簽、名稱）的具體操作，請參見管理容器組（Pod）。

6. 單擊下一步，在日志采集配置配置向?qū)е校瑔螕?b data-tag="uicontrol" id="uicontrol-31i-aln-dnh" class="uicontrol">+添加日志采集配置，配置日志采集信息（支持多個）。

   參數(shù)	說明
   日志名稱	每個采集目標(biāo)支持定義多個采集配置，每個采集配置對應(yīng)一個日志名稱，不可重復(fù)。日志名稱可作為索引名的一部分，用于后續(xù)輸出使用。
   采集器配置	使用Docker容器日志采集通用模板。采集配置集成Autodiscover事件變量，支持Docker input，具體說明如下： type：輸入類型。采集容器日志時為docker，不同的數(shù)據(jù)采集支持不同的類型。詳細(xì)信息，請參見Configure inputs。 combine_partial：合并多行日志。詳細(xì)信息，請參見Docker input（combine_partial）。 containers.ids：Docker容器日志的ID列表。詳細(xì)信息，請參見Docker input（containers.ids）。 fileds.k8s_container_name：在采集器的輸出信息中，添加k8s_container_name字段，引用變量${data.kubernetes.container.name}。 說明 Docker容器配置集成了Filebeat Autodiscover，配置模板可引用Autodiscover事件變量。 fileds.k8s_node_name：在采集器的輸出信息中，添加k8s_node_name字段，引用變量${data.kubernetes.node.name}。 fileds.k8s_pod：在采集器的輸出信息中，添加k8s_pod字段，引用變量${data.kubernetes.pod.name}。 fileds.k8s_pod_namespace：在采集器的輸出信息中，添加k8s_pod_namespace字段，引用變量${data.kubernetes.namespace}。 fields_under_root：設(shè)置為true，fileds存儲在輸出文檔的頂級位置。詳細(xì)信息，請參見Docker input（fields_under_root）。 說明 如果通用模板無法滿足需求，建議您參見FileBeat Docker input修改。 一個采集器配置僅支持一個Docker輸出。如果需要使用多個配置，請單擊添加日志采集配置。

7. 可選：單擊下一步，在索引存儲管理配置向?qū)е校鶕?jù)需求開啟并配置索引存儲管理功能。

   開啟索引存儲管理后，單擊+添加索引管理策略，按照以下說明配置策略（支持多個）。

   參數(shù)	說明
   策略名稱	定義策略名稱，可自定義。
   選擇目標(biāo)日志	選擇待關(guān)聯(lián)的目標(biāo)日志，至少選擇一個。一個策略可選擇多個目標(biāo)日志，每個日志僅可被一個日志管理策略選擇。
   資源大小限制	索引實(shí)際占用磁盤空間達(dá)到資源限制時（包括副本），將刪除過舊數(shù)據(jù)，以保證不超過該資源大小限制。
   生命周期管理	是否開啟索引生命周期管理。生命周期管理可以實(shí)現(xiàn)數(shù)據(jù)節(jié)點(diǎn)冷熱分離、過期自動刪除數(shù)據(jù)等。 重要 開啟滾動更新，F(xiàn)ilebeat會將數(shù)據(jù)寫入名稱為<日志名稱>-<日期>-<序號>的索引下，例如log-web-2021.01.22-000001。 不開啟滾動更新，F(xiàn)ilebeat會將數(shù)據(jù)寫入名稱為filebeat-<日志名稱>-<日期>的索引下。

8. 單擊啟動。

   啟動后，您可在采集器列表中查看對應(yīng)的采集器。啟動成功后，您還可以完成以下操作。

   說明

   ACK集群默認(rèn)在名稱為logging的空間下部署采集器資源，部署完成后，您可以訪問對應(yīng)ACK集群查看已部署的采集器資源，例如索引管理容器、索引生命周期滾動更新策略等，詳細(xì)信息請參見查看ACK集群中的采集器資源。

   操作	說明
   配置預(yù)覽	可查看采集器Output、ACK目標(biāo)集群及采集任務(wù)名稱等信息，不支持修改這些信息。
   修改詳情配置	可修改采集目標(biāo)、日志采集配置和索引存儲管理策略。
   更多	可啟動、停止、重啟、刪除采集任務(wù)，并支持查看Dashboard和Helm狀態(tài)。

查看ACK集群中的采集器資源

執(zhí)行以下命令，通過kubectl訪問ACK集群，并查看logging空間下的采集器資源，詳細(xì)信息請參見獲取集群KubeConfig并通過kubectl工具連接集群。

kubectl get pods -n logging