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` |  |  | 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.
`defaultDigestReplicationFactor` | `2` | added in 1.122 | Configures the replication factor used for the digest partitions table.
`defaultSegmentReplicationFactor` | `2` | added in 1.122 | Specifies the number of replicas each segment file will have.
`DelayIngestResponseDueToIngestLagScale` | `300,000 milliseconds` | added in 1.118.2 | Sets the number of milliseconds of lag that adds `1` to the factor applied.
`DelayIngestResponseDueToIngestLagMaxFactor` | `2` | added in 1.118.2 | Sets the delay of the ingest response when the digest node experiences digest lag.
`DelayIngestResponseDueToIngestLagThreshold` | `20,000 milliseconds` | added in 1.118.2 | Sets the number of milliseconds of digest lag where the feature starts to kick in.
`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.
`GraphQLSelectionSizeLimit` | `1,000 queries` |  | Number of GraphQL queries on the total number of selected fields and fragments.
`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()`.
`IngestFeedAwsDownloadMaxObjectSize` | `2,147,483,648 bytes` |  | Max size of objects downloaded from S3.
`IngestFeedAwsProcessingDownloadBufferSize` | `8,388,608 bytes` |  | Size of the buffer when downloading.
`IngestFeedAwsProcessingEventBufferSize` | `1 MB` |  | Size of the buffer after preprocessing and splitting into individual events.
`IngestFeedAwsProcessingEventsPerBatch` | `1,000 events` |  | Number of events ingested per batch.
`IngestFeedGovernorRateOverride` | `100,000` |  | Change in rate when under/over the setpoint. Increasing this will make the governor more aggressive in changing the ingest rate.
`IngestFeedGovernorIngestDelayHigh` | `10 seconds` |  | Default ingest delay high setpoint for the ingest feed governor.
`IngestFeedGovernorIngestDelayLow` | `5 seconds` |  | Default ingest delay low setpoint for the ingest feed governor.
`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.
`LookupTableSyncAwaitSeconds` | `60 seconds` | added in 1.119 | Waiting time before the lookup operation fails.
`MatchFilesMaxHeapFraction` | `0.5` | added in 1.118 | Total fraction of the heap allowed for lookup tables. Defaults to half of the total configured heap.
`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.
`MaxCsvFileUploadSizeBytes` | `209,715,200 bytes` | added in 1.124 | Maximum size of uploaded CSV files.
`MaxIngestRequestSize` | `33,554,432 bytes` |  | Size limit of ingest requests after content-encoding has been applied.
`MaxJsonFileUploadSizeBytes` | `104,857,600 bytes` | added in 1.124 | Maximum size of uploaded JSON files. If `MAX_FILEUPLOAD_SIZE` is set, its value will be the default.
`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.
`QueryCoordinatorMaxHeapFraction` | `0.5` |  | Configures query queueing based on the available memory in the query coordinator.
`QueryCoordinatorMemoryLimit` | `4,000,000,000 bytes` | added in 1.118.2 | Memory that the query coordinator can consume during execution per query, to ensure that the coordinating nodes of a cluster do not run out of memory.
`QueryMemoryLimit` | `100,000,000 bytes` | deprecated in 1.116 | How much memory a non-live query can consume during its execution.
`QueryPartitionAutoBalance` | `true` |  | Turns on/off automatic balancing of query partitions across nodes.
`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.
`ReplaceANSIEscapeCodes` | `true` |  | Specifies whether LogScale replaces ANSI escape codes in the result set.
`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.
`StaticQueryFractionOfCores` | `2` |  | Limit in the queries that one organization or user can run on a certain percentage of mapper threads.
`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.
`UnauthenticatedGraphQLSelectionSizeLimit` | `150 queries` |  | Number of GraphQL queries on the total number of selected fields and fragments for unauthenticated users.
`UndersizedMergingRetentionPercentage` | `20 %` |  | Time span percentage that can be merged together when selecting undersized segments to merge.

#### Enter search term