Skip to content
LogScale Self-Hosted
Content was updated: Mar 5, 2024
This is an archived version of the documentation downloaded from LogScale Documentation Archives. Up to date documentation, and documentation for later versions, is available on LogScale Documentation

## Dynamic Configuration Parameters

Dynamic Configuration parameters allow for setting configuration values for the cluster while it is running.

- To get the current configuration value for a dynamic variable, see Getting Dynamic Configuration List

- To set the current configuration value for a dynamic variable, see Setting a Dynamic Configuration Value

Table: Dynamic Configuration Parameters Table

Variable | Default Value | Availability | Description
--- | --- | --- | ---
`ArchivingClusterWideDisabled` | `true` |  | Boolean flag that controls whether archiving is disabled across the entire cluster. When set to true, all archiving operations will be disabled for all repositories in the cluster regardless of individual settings.
`ArchivingClusterWideEndAt` | `7` |  | Timestamp that defines when cluster-wide archiving should end. This setting applies to all repositories that match the archiving cluster-wide regex pattern. The format is ISO 8601 (e.g., "2023-12-31T23:59:59Z"). When empty, archiving will continue indefinitely (or until disabled).
`ArchivingClusterWideRegexForRepoName` | `.*` |  | Regular expression pattern to match repository names for cluster-wide archiving operations. Only repositories with names matching this pattern will be subject to cluster-wide archiving settings. Use ".*" to match all repositories or provide a specific pattern to target a subset of repositories.
`ArchivingClusterWideStartFrom` | `1` |  | Timestamp that defines when cluster-wide archiving should begin. This setting applies to all repositories that match the archiving cluster-wide regex pattern. The format is ISO 8601 (e.g., "2023-01-01T00:00:00Z"). When empty, archiving will start from the beginning of available data.
`BlockSignup` | `true` |  | Boolean flag that controls whether new user signups are blocked. When set to true, new user registration will be disabled, preventing the creation of new accounts. Useful for maintenance periods or when you want to control access to the system.
`BucketStorageKeySchemeVersion` | `2 MB` |  | Sets a new format for the keys (file names) placed in the bucket.
`BucketStorageUploadInfrequentThresholdDays` |  | added in 1.85 | Minimum data retention days remained to switch from default "S3 Standard" to "S3 Intelligent-Tiering".
`BucketStorageWriteVersion` | `3` |  | Allows files larger than 2GB in bucket storage for less memory pressure.
`DebugAuditRequestTrace` | `true` |  | Controls whether to enable debug tracing for audit requests.
`DeleteDuplicatedNameViewsAfterMerging` | `false` |  | Controls whether to delete views with duplicate names after merging.
`DisableAnalyticsJob` | `true` |  | Controls whether analytics jobs are disabled.
`DisableUserTracking` | `true` |  | Controls whether user tracking is disabled.
`DisableViewWithSameNameCleanup` | `true` |  | Disable views with the same name during clean-up.
`EnableGlobalJsonStatsLogger` | `false` |  | Controls whether the global JSON statistics logger is enabled.
`ExternalFunctionRequestResponseEventCountLimit` | `10,000` |  | Maximum number of events allowed in an external function response.
`ExternalFunctionRequestResponseSizeLimitBytes` | `10,485,760` |  | Maximum size in bytes allowed for an external function response.
`FdrEnable` | `false` |  | Turns FDR polling on/off on the entire cluster with a single update.
`FdrExcludedNodes` | `empty` |  | Excludes specific nodes from polling from FDR.
`FdrMaxNodes` | `5 nodes` |  | Maximum number of nodes that simultaneously poll data from the same FDR feed.
`FdrMaxNodesPerFeed` | `5` |  | Maximum number of nodes allowed per feed for FDR.
`FdrS3FileSizeMax` | `250,000,000` |  | Maximum file size in bytes for S3 files in FDR.
`FileReplicationFactor` | `5` |  | Replication factor for files in the cluster.
`FlushSegmentsAndGlobalOnShutdown` | `false` |  | Allows the shutdown of all in-progress segments and forces a write (and upload) of global snapshot.
`GracePeriodBeforeDeletingDeadEphemeralHostsMs` | `100` |  | Grace period in milliseconds before dead ephemeral hosts are deleted.
`GraphQLAliasCountLimit` | `100` |  | Maximum number of aliases allowed in a GraphQL query.
`GraphQLDirectiveCountLimit` | `100` |  | Maximum number of directives allowed in a GraphQL query.
`GraphQLQueryAnalysisDisabled` | `true` |  | Controls whether GraphQL query analysis is disabled.
`GroupDefaultLimit` | `20,000 group elements` |  | Default limit of group elements allowed in functions like `groupBy()` or `selfJoin()`.
`GroupMaxLimit` | `1,000,000 group elements` |  | Maximum limit of group elements allowed in `groupBy()`.
`IsAutomaticUpdateCheckingAllowed` | `false` |  | Controls whether automatic update checking is allowed.
`JoinDefaultLimit` | `100,000` |  | Default limit for join operations in queries.
`JoinRowLimit` | `200,000 rows` |  | Max number of rows that `join()` and `selfJoin()` can return.
`LiveQueryMemoryLimit` | `100,000,000 bytes` | deprecated in 1.116 | Amount of memory that a live query can consume during its execution.
`MaxAccessTokenTTL` | `2,592,000` |  | Maximum time-to-live in seconds for access tokens.
`MaxRelocatedDatasourcesInGlobal` | `100` |  | Maximum number of datasources that can be relocated to global.
`MaxConcurrentQueriesOnWorker` | `1,000` |  | Maximum number of historic queries that can be executed on a single worker node. This limit does not apply to live parts of queries.
`MaxIngestRequestSize` | `33,554,432 bytes` |  | Size limit of ingest requests after content-encoding has been applied.
`MaxQueryPenaltyCreditForBlockedQueriesFactor` | `5.0` |  | Maximum factor for penalty credit given for blocked queries.
`MaxQueryPollsForWorker` | `100` |  | Maximum number of worker polls (across all workers) scheduled per second.
`MinQueryPermitsFactor` | `1.0` |  | Minimum factor for query permits allocation.
`MinimumHumioVersion` | `1.0.0` |  | Minimum version of Humio (LogScale) required for the cluster.
`MultiPassDefaultIterationLimit` | `10` |  | Default limit for the number of iterations in multi-pass operations.
`MultiPassMaxIterationLimit` | `50` |  | Maximum limit for the number of iterations in multi-pass operations.
`ParserThrottlingAllocationFactor` | `1.0` |  | Factor used to determine the allocation of resources for parser throttling. Controls the fraction of resources dedicated to parsing operations to prevent overload.
`QueryFSMSyncMergeThreshold` | `1,000` |  | Threshold value for synchronous merging in the Query Finite State Machine (FSM). Controls when query results should be merged synchronously rather than asynchronously.
`QueryMemoryLimit` | `100,000,000 bytes` | deprecated in 1.116 | How much memory a non-live query can consume during its execution.
`QueryResultRowCountLimit` | `500,000 rows` |  | How many events a query can return.
`RejectIngestOnParserExceedingFraction` | `0.85` |  | Fraction threshold that determines when to reject ingest operations if a parser is exceeding its allocated resources. When parser resource usage exceeds this fraction of its allocation, new ingest operations will be rejected.
`SampleIntervalForDatasourceRates` | `60,000` |  | Interval in milliseconds at which datasource rates are sampled. Controls how frequently the system measures and updates data ingest rates for each datasource.
`SelfJoinLimit` | `10` |  | Maximum number of self-joins allowed in a query. Limits the complexity of queries to prevent excessive resource consumption from queries with too many self-joins. If 0 or less, then it is unlimited.
`StateRowLimit` | `500,000 rows` |  | Maximum number of rows allowed in functions.
`TableCacheMemoryAllowanceFraction` | `0.2` |  | Specifies the maximum fraction of available memory for the table cache. Controls how much of the system's memory can be used for caching query result tables. It is specified as a fraction of the total memory available for files.
`TargetMaxRateForDatasource` | `2 MB` |  | Target maximum rate of ingest for each shard of a datasource.
`UndersizedMergingRetentionPercentage` | `20 %` |  | Time span percentage that can be merged together when selecting undersized segments to merge.

#### Enter search term