To apply changes saymon-agent service must be restarted.
Parameters of the agent configuration file .../saymon-agent/conf/agent.properties are described below.
General settings
Parameter | Description |
---|---|
agent.discoveryEnabled | It enables automatic searching for network devices by the agent;
By default false | automatic searching is disabled. The parent object for discovered objects can be set with the parameter discovery_parent_id in the section Server of the server configuration file. |
agent.id | It is the unique ID of the object of the class Saymon Agent in the web interface. With agent.id=0 a new object of the Saymon Agent class will be created on the server. The ID of the object will be transferred to the agent. In this case the .../saymon-agent/storage/registration.json file will be created on the host with the agent. The agent ID will be stored in the file. In order to run the procedure of obtaining an ID again, for example, if it is necessary to connect the agent to another server, you just need to delete the registration.json file and restart the agent. |
agent. optimizedThreadManagement | It enables the flows optimization mode;
By default false | optimization mode is disabled. |
agent.scriptsEnabled | It enables execution scripts with text by the agent;
By default true | execution scripts is enabled. |
agent.snmpTrapEnabled | It enables receiving traps by the agent;
By default false | receiving traps is disabled. To learn more about SNMP Trap functionality refer to the sections Event Log and Monitoring and checks settings. |
agent.snmpTrapListenPort | Port for receiving traps. By default 1162. |
agent. snmpTrapReceiverThreadPoolSize | Number of simultaneous flows for receiving traps. By default 4. |
server.host | Address of the Kafka server. By default 127.0.0.1 |
server.port | Kafka port to connect to the system server. By default 9092. |
Connection to Kafka Cluster
While using Kafka Cluster it is necessary to use additional parameters starting with kafka.. Please refer to the Kafka documentation for the complete parameters list and their description.
Example:
... kafka.bootstrap.servers=192.168.1.11:9092,192.168.1.12:9092,192.168.1.13:9092 kafka.security.protocol=SASL_SSL kafka.ssl.truststore.location=/opt/kafka/kafka.client.truststore.jks kafka.ssl.truststore.password=saymon kafka.sasl.mechanism=PLAIN kafka.sasl.jaas.config=org.apache.kafka.common.security.plain.PlainLoginModule required \ username="user" \ password="password" ...
Parameter | Description |
---|---|
kafka.bootstrap.servers | List of host:port pairs which are used for the initial connection to the Kafka Cluster. |
With using Kafka Cluster the server.host field must not be empty. There must be specified the address of one of the kafka.bootstrap.servers.
Authorization and encryption
Parameter | Description |
---|---|
kafka.sasl.jaas.config | Parameters of context of entering to the system for SASL-connections in the format which is used by JAAS configuration files. |
kafka.sasl.mechanism | SASL mechanism, which is used for client connections. |
kafka.security.protocol | Protocol, which is used to communicate with brokers. Possible values:
|
kafka.ssl.truststore.location | Truststore file location. |
kafka.ssl.truststore.password | Password for the truststore file. If the password is not set, the configured file still can be used, but without integrity check. |