Installing Agent

Installing The Agent #

  • INFINI Agent is a submodule of INFINI Console, charge of data scraping and Elasticsearch instance manage. it’s manage by INFINI Console
  • INFINI Agent supports mainstream operating systems and platforms. The program package is small, with no extra external dependency. So, the agent can be installed very rapidly.

Before You Begin #

Install and keep INFINI Console running.

Download #

Download the current INFINI Agent package for your platform. https://release.infinilabs.com/agent/

Container Deployment #

INFINI Agent also supports Docker container deployment.

Learn More

Configuration #

Most of the configuration of INFINI Agent can be completed using agent.yml. After the configuration is modified, the agent program needs to be restarted to make the configuration take effect.

After unzip the file and open agent.yml, you will see this:

#Used to store data for INFINI Console And Agent
#Elasticsearch cluster version should be v7.3+
elasticsearch:
  - name: default
    enabled: true
    monitored: false
    endpoint: http://192.168.3.4:9200
    basic_auth:
      username: elastic
      password: ZBdkVQUUdF1Sir4X4BGB
...
#INFINI Console Endpoint
agent.manager.endpoint: http://192.168.3.4:9000

In most case, you only need to config the endpoint, but if Elasticsearch has security authentication enabled,then config the username and password.

The user must have access to the cluster metadata,index metadata,and all indexes with .infini prefix.

Starting the Agent #

Run the agent program to start INFINI Agent, as follows:

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

[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.

If the above startup information is displayed, the agent is running successfully and listening on the responding port.

But now agent can’t work normally util it’s being added to INFINI Console. See Agent Manage

Shutting Down the Agent #

To shut down INFINI Agent, hold down Ctrl+C. The following information will be displayed:

^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.

System Service #

To run the INFINI Agent as a system service, run the following commands:

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

Uninstall service:

➜ ./agent -service stop
Success
➜ ./agent -service uninstall
Success
  • Languages English
©INFINI.LTD, All Rights Reserved.