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 the current INFINI Agent package for your platform. https://release.infinilabs.com/agent/
Container Deployment #
INFINI Agent also supports Docker container deployment.Learn More
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
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
➜ ./agent -service stop Success ➜ ./agent -service uninstall Success