SAYMON Documentation
Page tree

SAYMON документация

Skip to end of metadata
Go to start of metadata

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;

    • false | automatic searching is disabled,
    • true | automatic searching is enabled.

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;

    • false | optimization mode is disabled,
    • true | optimization mode is enabled.

By default false | optimization mode is disabled.

agent.scriptsEnabled

It enables execution scripts with text by the agent;

    • false | execution scripts is disabled,
    • true | execution scripts is enabled.

By default true | execution scripts is enabled.

agent.snmpTrapEnabled

It enables receiving traps by the agent;

    • false | receiving traps is disabled,
    • true | receiving traps is enabled.

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.serversList 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.mechanismSASL mechanism, which is used for client connections.
kafka.security.protocol

Protocol, which is used to communicate with brokers.

Possible values:

  • PLAINTEXT,
  • SSL,
  • SASL_PLAINTEXT,
  • SASL_SSL.
kafka.ssl.truststore.locationTruststore 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.

  • No labels