General settings

available at configuration > general , are the following fieldsets api the information configured here will be incorporated in the token when configuring collectors if any of these are changed, existing collectors will need to have their token updated these settings are only used by the collectors, the historian itself will use the values configured in the configuration file grpc port description the grpc port is the tcp port used by the historian server to communicate with factry collectors this should reflect the value entered for grpc port variable in the configuration file /etc/systemd/system/environments/factry historian server default 80001 rest port description the rest port is the tcp port on which the historian server rest api and management interface is exposed this should reflect the value entered for port variable in the configuration file /etc/systemd/system/environments/factry historian server , unless you are using a reverse proxy in front of factry historian, in which case this should reflect the port that is exposed by your reverse proxy default 8000 url description this value is used by the factry collectors to derive the ip address to communicate with the historian server api a valid and reachable url is required here for collector communication to work default http //127 0 0 1 authentication session inactive duration description the time after which an inactive login session expires this setting accepts duration string literals, eg 1w2d7h15m (1 week 2 days 7 hours and 15 minutes) default 7d statistics allow historian to send statistics description this setting will enable the historian server to send statistics to our docid 29rc0yqxa3syqos99t7zk if this setting is disabled, automatic monitoring and alerting will not work default true collector updates allow historian to check for updates description if enabled the historian server will check for updates to the collectors default true update check interval description the interval at which the historian server will check for updates to the collectors this setting accepts duration string literals, e g , 1w2d7h15m (1 week 2 days 7 hours and 15 minutes) default 1h general logs minimum free space (mb) description the minimum free disk space in mb required to log to disk if the free disk space falls below this threshold, logs will be dropped default 2048 limit logs description if enabled, logs sent to the internal database will be rate limited default true log rate description the maximum allowed number of logs per second if this threshold is exceeded, logs will be dropped default 50 log burst description the maximum number of log lines that can be sent in a single burst this is used to allow a temporary spike of logs default 500 limit by level description if enabled, the log rate limit will be applied to each log level separately if disabled, the limit will be applied to all logs regardless of their level default true audit logs duration to keep audit logs description the duration to keep the audit logs this setting accepts duration string literals, e g , 1w2d7h15m (1 week 2 days 7 hours and 15 minutes) set to 0d to keep indefinitely default 0d time series cache enabled description if enabled, the historian will cache time series data in memory this will speed up queries but will consume more memory default true global cache size description how many points to keep at most in the global cache measurements that produce more data will consume more memory, up to the measurement cache size limit default 4194304 measurement cache size description how many points to keep at most in the cache per measurement this cannot exceed the global cache size default 4096