Base collector

the base collector is factry's collector framework it contains all common functionality for collectors the commands for installation and upgrades the configuration retrieval logic from factry historian store and forward mechanisms filtering and compression techniques as such, this page serves as a reference for settings that are shared across all collector types it is not available for download the default values will be sufficient in most cases make sure you know what you’re doing when changing these variables changing these could have unintended side effects! logging loglevel description specifies the log level, only messages with the configured log level will be visible in the system logs and sent to the historian default info log levels trace debug info higher log levels will always be sent to the historian logging (windows only) logsize description the maximum size that a single log file can grow to before it is rotated default 100 logfilemax description the number of logfiles that will be kept default 10 logfiledays description the maximum age an archived logfile may have before it is deleted default 10 windows priorityclass description the priority class for the process valid values are normal priority class, above normal priority class, high priority class, realtime priority class default above normal priority class more info about the priority class buffer the buffer keeps a set amount of points in memory and when this fills up starts writing to a file it will periodically process the buffer, from file and then memory, by sending the points to the historian bufferprocessinterval description the interval in milliseconds that the buffer processes the buffer default 250 buffermaxbatchsize description the maximum size of a batch in the buffer default 5000 buffermaxbatches description the maximum amount of batches the buffer will keep in memory default 20 bufferdiskbatches description the maximum amount of batches that will be written to a buffer file default 100 bufferminfreediskspace description the buffer wont write to more files if the minimum free disk space is reached default 2gb a negative value means no limit to remaining disk space on the system buffermaxdiskspace description the maximum disk space that the buffer files may take up default no limit default 0mb a negative value means no limit to disk space used communication compressionlevel description the compression level grpc uses, for default compression 1 9 1 = fastest, 9 = most compressed, 1 = default default 1 grpcmaxmessagesize description the maximum message size for grpc messages default 64mb ticker the ticker is used by collectors that poll measurements, like the opc ua collector this ticker determines how fast the measurements can polled and how accurate it needs to be polled measurements can’t be polled at a lower interval than the ticker tickerinterval description the interval for the base ticker in milliseconds default 1000 tickerresolution description the resolution for the base ticker in milliseconds maximum 1/10th of the the interval default 25 tickermaxdrift description the maximum drift a tick may have in milliseconds must be lower than the interval default 125 other alternativetimezone description the timezone to reinterpret all timestamps in, the name is taken to be a location name corresponding to a file in the iana time zone database default / hapollinginterval description the interval in milliseconds at which the backup collector polls the main collector’s health default 1000 allowedfutureduration description defines the maximum duration into the future from the current time (collector’s perspective) that a source timestamp is considered valid default / allowedpast description defines the earliest allowable point in time for source timestamps this can be specified either as a fixed timestamp (e g , 2023 07 01t00 00 00z) or as a duration in the past relative to the current time (e g , 1w for 1 week ago) default / badtimestampaction description specifies the action to take when a timestamp is found to be outside the allowed ranges discard the point is discarded sendwithcurrent the point is sent with the current timestamp and badtimestampoutofrange instead default discard statusgood description a comma separated list of status strings that will be interpreted as a good status escaping is possible with a backslash environment variables this section describes all environment variables that can be configured server name override default value historian factry local description only need to change this if using a different certificate