Collector Properties

In the collector.properties file, configure the Collector with the properties described below.

server.name

The name of the Collector server. In a typical monolithic web application the actual server IP or VM names are very familiar and has meaning to you, but if you are running on a kubernetes cluster and 1000s of containers running in pods and are going up and down in an highly elastic manner the IPs mean nothing. In those cases your Server Grouping should be named after logical group instances.
Example: prod-app1, prod-api1, prod-api2, prod-service1, prod-sql1, etc.

Environment VariableProperties File
NewTAKIPI_SERVER_NAMEtakipi.server.name
OldTAKIPI_MACHINE_NAMEserverName

takipi.installation.time (installation.time)

OverOps monitors the Collector installation duration to assess which JVMs require restart. This number is written during installation and is measured in milliseconds.

Environment VariableProperties File
NewTAKIPI_INSTALLATION_TIMEtakipi.installation.time
OldTAKIPI_INSTALLATION_TIMEinstallation.time

takipi.jvm.lib.file (jvmPath)

In the collector.properties, configure a JVM library, to start the internal JVM for the Collector to execute internal code.

Environment VariableProperties File
NewJVM_LIB_FILEtakipi.jvm.lib.file
OldjvmPath
Exampletakipi.jvm.lib.file=/usr/lib/jvm/java-8-oracle/jre/lib/amd64/server/libjvm.so

takipi.listen.port (listenOnPort)

When using a Remote Collector, from collector.properties, configure takipi.listen.port to establish a connection to the Agent, see -Dtakipi.collector.port.

Environment VariableProperties File
NewTAKIPI_LISTEN_PORTtakipi.listen.port
OldlistenOnPort
Exampletakipi.listen.port=6060

takipi.passphrase (passphrase)

When using a Remote Collector, set takipi.passphrase to secure access from the Agent, see: -Dtakipi.collector.passphrase.

Environment VariableProperties File
NewTAKIPI_PASSPHRASEtakipi.passphrase
Oldpassphrase

takipi.backend.url (baseUrl)

The backend endpoint.

Environment VariableProperties File
NewTAKIPI_BACKEND_URLtakipi.backend.url
OldTAKIPI_BASE_URLbaseUrl
Exampletakipi.backend.url=https://backend.takipi.com/
Defaulthttps://backend.takipi.com/

takipi.storage.test.url (s3ConnectionTestUrl)

Set the path to the Storage.

Environment VariableProperties File
NewTAKIPI_STORAGE_TEST_URLtakipi.storage.test.url
Olds3ConnectionTestUrl
Example - SaaStakipi.storage.test.url=https://s3.amazonaws.com/app-takipi-com/ConnectionTest
Example - Hybridtakipi.storage.test.url=https://ec2-18-212-154-63.compute-1.amazonaws.com:8443/storage/v1/diag/ping
Example - On-Premisestakipi.storage.test.url=http://$TAKIPI_HOST:8080/service/png

takipi.jvm.heap.size (javaHeapSize)

The Collector internal JVM defines small heap and stack sizes. Set takipi.jvm.heap.size for the heap size when using a Remote Collector.

Environment VariableProperties File
NewTAKIPI_JVM_HEAP_SIZEtakipi.jvm.heap.size
OldjavaHeapSize
Exampletakipi.jvm.heap.size=1024m

takipi.http.proxy/takipi.https.proxy (httpProxy/httpsProxy)

When the Collector is running through a proxy, set httpProxy and/or httpsProxy

Environment Variable

Properties File

New

HTTP_PROXY/
HTTPS_PROXY

takipi.http.proxy/
takipi.https.proxy

Old

httpProxy/
httpsProxy
Syntaxtakipi.http.proxy=httpdPrococol://user:password@proxyHost:proxyPort
takipi.https.proxy=httpdPrococol://user:password@proxyHost:proxyPort
Exampletakipi.https.proxyy=https://proxy:[email protected]:8433

takipi.handler.threads

The Collector allocates a predefined number of threads to be used for handling the micro-agents. Set takipi.handler.threads to define the thread pool size to be used by the collector. The default value is 50.

Environment VariableProperties File
NewTAKIPI_HANDLER_THREADStakipi.handler.threads
Exampletakipi.handler.threads=50

takipi.handler.clients

The Collector assigns a number of micro-agents to be handled by each of the threads. Set takipi.handler.clients to define the maximum number of micro-agents to be handled by each of threads allocated in the collector. The default value is 20.
Together with the variable above (takipi.handler.threads), these 2 variables determine the maximum number of micro-agents the collector will handle. For example, if using: 50 threads x 20 clients = 1,000 agents. The Collector will reject any agent trying to connect above that set limit.

Environment VariableProperties File
NewTAKIPI_HANDLER_CLIENTStakipi.handler.clients
Exampletakipi.handler.clients=20

takipi.unchained

This flag is enabled by default in remote Collector mode, which is the default installation mode. Unchained means the Collector can use more resources because it's on a separate machine.

FlagProperties FileDefaultExample
takipi.unchainedcollector.propertiesTruetakipi.unchained=true

maxDiskUsagePercentage Attribute

OverOps developed a simple safeguard that prevents the Collector from filling the disk completely, thus rendering the environment non-functional.To this end, the Collector checks for free disk space every time it is about to persist a snapshot, stats or parts thereof, and if the disk space is past a certain percentage, it will write an error to the log, along with the disk space details and the relevant file name.

The default percentage cutoff point (if not specified explicitly) is 0.9 = 90 percent, and is configurable in collector.properties using the maxDiskUsagePercentage attribute.

For example:
If maxDiskUsagePercentage=0.7 then the Collector will stop writing to the disk when it reaches 70 percent capacity.

AttributeProperties FileExplanation
NewmaxDiskUsagePercentagecollector.properties.fileThis attribute is set by default to 0.90 to ensure that the Collector stops before the disk as at 100 percent.