安装探针(INFINI Agent) #

探针(INFINI Agent) 是 INFINI Console 的子模块，负责数据抓取和 Elasticsearch 实例管理等任务，接受 Console 权限控制和统一的任务调度。
支持主流的操作系统和平台，程序包很小，没有任何额外的外部依赖。

安装前准备 #

安装并运行 INFINI Console

下载安装 #

根据您所在的操作系统和平台选择下面相应的下载地址：

https://release.infinilabs.com/agent/

容器部署 #

探针(INFINI Agent) 也支持 Docker 容器方式部署。

了解更多

配置 #

下载探针(INFINI Agent) 安装包解压之后，打开agent.yml配置文件，我们可以看到以下配置：

#存储 INFINI Agent 相关数据的 Elasticsearch 集群信息，版本 v7.3+
#此处的 endpoint 需和 INFINI Console 的一致
elasticsearch:
  - name: default
    enabled: true
    monitored: false
    endpoint: http://192.168.3.4:9200
    basic_auth:
      username: elastic
      password: ZBdkVQUUdF1Sir4X4BGB
...
#INFINI Console的地址
agent.manager.endpoint: http://192.168.3.4:9000

通常，我们只需要修改配置里面的 endpoint 配置，若 Elasticsearch 开启了安全验证，则需要修改 username 和 password 配置。

这里的用户要求具备集群的元数据、索引的元数据以及 .infini* 索引的完全访问权限，以及索引模板的创建权限。

启动 INFINI Agent #

直接运行程序即可启动探针(INFINI Agent) 了(这里使用的是 Mac 版本的，不同平台的程序文件名称略有不同)，如下：

   _      ___   __    __  _____ 
  /_\    / _ \ /__\/\ \ \/__   \
 //_\\  / /_\//_\ /  \/ /  / /\/
/  _  \/ /_\\//__/ /\  /  / /   
\_/ \_/\____/\__/\_\ \/   \/    

[AGENT] A light-weight, powerful and high-performance elasticsearch agent.
[AGENT] 0.1.0#14, 2022-08-26 14:09:29, 2025-12-31 10:10:10, 4489a8dff2b68501a0dd9ae15276cf5751d50e19
[08-31 15:52:07] [INF] [app.go:164] initializing agent.
[08-31 15:52:07] [INF] [app.go:165] using config: /Users/INFINI/agent/agent-0.1.0-14-mac-arm64/agent.yml.
[08-31 15:52:07] [INF] [instance.go:72] workspace: /Users/INFINI/agent/agent-0.1.0-14-mac-arm64/data/agent/nodes/cc7h5qitoaj25p2g9t20
[08-31 15:52:07] [INF] [metrics.go:63] ip:192.168.3.22, host:INFINI-MacBook.local, labels:, tags:
[08-31 15:52:07] [INF] [api.go:261] api listen at: http://0.0.0.0:8080
[08-31 15:52:07] [INF] [module.go:116] all modules are started
[08-31 15:52:07] [INF] [manage.go:180] register agent to console
[08-31 15:52:07] [INF] [actions.go:367] elasticsearch [default] is available
[08-31 15:52:07] [INF] [manage.go:203] registering, waiting for review
[08-31 15:52:07] [INF] [app.go:334] agent is up and running now.

看到上面的启动信息，说明探针(INFINI Agent) 已经成功运行了!

但此时探针(INFINI Agent) 处于等待审核的状态，并不能做任何事情。去审核吧

停止 INFINI Agent #

如果需要停止探针(INFINI Agent) ，按 Ctrl+C 即可停止探针(INFINI Agent)，如下：

^C
[AGENT] got signal: interrupt, start shutting down
[08-31 15:57:13] [INF] [module.go:145] all modules are stopped
[08-31 15:57:13] [INF] [app.go:257] agent now terminated.
[AGENT] 0.1.0, uptime: 5m6.240314s

   __ _  __ ____ __ _  __ __     
  / // |/ // __// // |/ // /    
 / // || // _/ / // || // /    
/_//_/|_//_/  /_//_/|_//_/   

©INFINI.LTD, All Rights Reserved.

配置服务后台运行 #

如果希望将探针(INFINI Agent) 以后台任务的方式运行，如下：

➜ ./agent -service install
Success
➜ ./agent -service start
Success

卸载服务也很简单，如下：

➜ ./agent -service stop
Success
➜ ./agent -service uninstall
Success