API Stability Short-Term

The dynamicConfig() GraphQL query returns the current value for the dynamic configuration.

For more information on configuring all aspects of LogScale, see the Configuration Settings reference section.

Syntax

Below is the syntax for the dynamicConfig() query field:

graphql
dynamicConfig(
     dynamicConfig: DynamicConfig!
   ): string!

This query is fairly versatile. Below is an example calling for information on the currentUser, similar to using currentUser() .

Raw
graphql
query{
   dynamicConfig:currentUser {
     id
     firstName
     isOrgRoot
   }
}
Mac OS or Linux (curl)
shell
curl -v -X POST $YOUR_LOGSCALE_URL/graphql \
    -H "Authorization: Bearer $TOKEN" \
    -H "Content-Type: application/json" \
    -d @- << EOF
{"query" : "query{
   dynamicConfig:currentUser {
     id
     firstName
     isOrgRoot
   }
}"
}
EOF
Mac OS or Linux (curl) One-line
shell
curl -v -X POST $YOUR_LOGSCALE_URL/graphql \
    -H "Authorization: Bearer $TOKEN" \
    -H "Content-Type: application/json" \
    -d @- << EOF
{"query" : "query{
   dynamicConfig:currentUser {
     id
     firstName
     isOrgRoot
   }
}"
}
EOF
Windows Cmd and curl
shell
curl -v -X POST $YOUR_LOGSCALE_URL/graphql ^
    -H "Authorization: Bearer $TOKEN" ^
    -H "Content-Type: application/json" ^
    -d @'{"query" : "query{ ^
   dynamicConfig:currentUser { ^
     id ^
     firstName ^
     isOrgRoot ^
   } ^
}" ^
} '
Windows Powershell and curl
powershell
curl.exe -X POST 
    -H "Authorization: Bearer $TOKEN"
    -H "Content-Type: application/json"
    -d '{"query" : "query{
   dynamicConfig:currentUser {
     id
     firstName
     isOrgRoot
   }
}"
}'
    "$YOUR_LOGSCALE_URL/graphql"
Perl
perl
#!/usr/bin/perl

use HTTP::Request;
use LWP;

my $INGEST_TOKEN = "TOKEN";

my $uri = '$YOUR_LOGSCALE_URL/graphql';

my $json = '{"query" : "query{
   dynamicConfig:currentUser {
     id
     firstName
     isOrgRoot
   }
}"
}';
my $req = HTTP::Request->new("POST", $uri );

$req->header("Authorization" => "Bearer $TOKEN");
$req->header("Content-Type" => "application/json");

$req->content( $json );

my $lwp = LWP::UserAgent->new;

my $result = $lwp->request( $req );

print $result->{"_content"},"\n";
Python
python
#! /usr/local/bin/python3

import requests

url = '$YOUR_LOGSCALE_URL/graphql'
mydata = r'''{"query" : "query{
   dynamicConfig:currentUser {
     id
     firstName
     isOrgRoot
   }
}"
}'''

resp = requests.post(url,
                     data = mydata,
                     headers = {
   "Authorization" : "Bearer $TOKEN",
   "Content-Type" : "application/json"
}
)

print(resp.text)
Node.js
javascript
const https = require('https');

const data = JSON.stringify(
    {"query" : "query{
   dynamicConfig:currentUser {
     id
     firstName
     isOrgRoot
   }
}"
}
);


const options = {
  hostname: '$YOUR_LOGSCALE_URL/graphql',
  path: '/graphql',
  port: 443,
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Content-Length': data.length,
    Authorization: 'BEARER ' + process.env.TOKEN,
    'User-Agent': 'Node',
  },
};

const req = https.request(options, (res) => {
  let data = '';
  console.log(`statusCode: ${res.statusCode}`);

  res.on('data', (d) => {
    data += d;
  });
  res.on('end', () => {
    console.log(JSON.parse(data).data);
  });
});

req.on('error', (error) => {
  console.error(error);
});

req.write(data);
req.end();
Example Responses
Success (HTTP Response Code 200 OK)
json
{
  "data": {
    "dynamicConfig": { 
      "id": "jSl8Iz25SLwiEUzXBE6YDetG",
      "firstName": "Bob",
      "isOrgRoot": true
    }
  }
}

Per the requested fields in the return datatype, the example above returned the current user's unique identifier, first name and answered the question as to whether they're a root user.

Given Datatypes

For the given datatype, dynamicConfig(), there are several values from which to choose. Below is a list of them along with a description of each:

Table: DynamicConfig

ParameterTypeRequiredDefaultStabilityDescription
Some arguments may be required, as indicated in the Required column. For some fields, this column indicates that a result will always be returned for this column.
Table last updated: May 8, 2025
AdHocTablesLimit   Short-TermUsed to limit on adhoc tables.
AggregatorOutputRowLimit   Short-TermUsed to set a row limit on the aggregator output.
ArchivingClusterWideDisabled   Short-TermSet of disable archiving across a cluster.
ArchivingClusterWideEndAt   Short-TermSpecifying an end date and time for cluster wide archiving.
ArchivingClusterWideRegexForRepoName   Short-TermSetting a regex for identifying the repository name for archiving cluster wide.
ArchivingClusterWideStartFrom   Short-TermSpecifying a start date and time for cluster wide archiving.
AstDepthLimit   DeprecatedUsed to set an abstract syntax tree depth limit. This option will be eliminated in version 1.164 of LogScale.
BlockSignup   Short-TermEnables blocking of user sign up.
BucketStorageKeySchemeVersion   Short-TermSet a new format for the keys (i.e., file names) placed in bucket storage.
BucketStorageUploadInfrequentThresholdDays   Short-TermSet the minimum data retention days remained to switch from default S3 Standard to S3 Intelligent-Tiering.
BucketStorageWriteVersion   Short-TermUsed to allow files larger than 2GB in bucket storage for less memory pressure.
CorrelateConstellationTickLimit   Short-TermSet the tick limit of a correlated constellation.
CorrelateConstraintLimit   Short-TermUsed to set limit on a correlated constraint.
CorrelateLinkValuesLimit   Short-TermSet the limit of correlated link values.
CorrelateLinkValuesMaxByteSize   Short-TermUsed to set a maximum byte size to correlated link values.
CorrelateMinIterations   Short-TermThe correlated minimum iterations that may be used.
CorrelateNumberOfTimeBuckets   Short-TermSet the correlated number of times buckets are used.
CorrelateQueryEventLimit   Short-TermSet the limit of correlated query events.
CorrelateQueryLimit   Short-TermSet the correlated query limit allowed.
DebugAuditRequestTrace   Short-TermSets debugging audit request tracing.
DelayIngestResponseDueToIngestLagMaxFactor   Short-TermIndicate maximum factor of delay ingest response due to ingest lag.
DelayIngestResponseDueToIngestLagScale   Short-TermSet the number of milliseconds of lag that adds 1 to the factor applied.
DelayIngestResponseDueToIngestLagThreshold   Short-TermSet the number of milliseconds of digest lag where the feature starts.
DeleteDuplicatedNameViewsAfterMerging   Short-TermUsed to indicate if duplicated views based on names should be deleted after merging.
DisableAnalyticsJob   Short-TermUsed to disable analytic jobs.
DisableInconsistencyDetectionJob   Short-TermUsed to disable job if inconsistency is detected.
DisableNewRegexEngine   Short-TermUsed to disable the new regex engine.
DisableUserTracking   Short-TermUsed to disable user tracking.
DisableViewWithSameNameCleanup   Short-TermUsed to disable views with the same name during clean-up.
EnableDemoData   Short-TermUsed to enable demo data.
EnableGlobalJsonStatsLogger   Short-TermUsed to enable logging of global JSON statistics.
ExternalFunctionRequestResponseEventCountLimit   Short-TermLimit external function request response event count.
ExternalFunctionRequestResponseSizeLimitBytes   Short-TermSet limit in bytes for external function request response size.
FdrMaxNodesPerFeed   Short-TermSet the maximum nodes in FDR used per feed.
FdrS3FileSizeMax   Short-TermSet the maximum Federated S3 file size.
FileReplicationFactor   Short-TermSet the file replication factor.
FlushSegmentsAndGlobalOnShutdown   Short-TermAllows the shutdown of all in-progress segments, and forces a write and upload of a global snapshot.
GracefulShutdownConsideredAliveSeconds   Short-TermUsed to set the number of seconds during a graceful shutdown that LogScale is still considered alive.
GracePeriodBeforeDeletingDeadEphemeralHostsMs   Short-TermSet in milliseconds the grace period before deleting dead ephemeral hosts.
GraphQlDirectivesAmountLimit   Short-TermSets the amount of GraphQL directives allowed in a query.
GraphQLSelectionSizeLimit   Short-TermSets the number of GraphQL queries on the total number of selected fields and fragments.
GroupDefaultLimit   Short-TermSets the default limit of group elements allowed in functions.
GroupMaxLimit   Short-TermUsed to set the maximum limit of group elements allowed in groupBy().
IngestFeedAwsDownloadMaxObjectSize   Short-TermUsed to set the maximum size of ingest feed objects downloaded from AWS S3.
IngestFeedAwsProcessingDownloadBufferSize   Short-TermSet the size of the buffer when downloading.
IngestFeedAwsProcessingEventBufferSize   Short-TermSet the size of the AWS ingest feed processing event buffer after preprocessing and splitting into individual events.
IngestFeedAwsProcessingEventsPerBatch   Short-TermSet the number of AWS events ingested per batch.
IngestFeedGovernorCycleDuration   Short-TermSet the ingest feed governor cycle duration.
IngestFeedGovernorGainPerCore   Short-TermSet the ingest feed governor gain per core.
IngestFeedGovernorIngestDelayHigh   Short-TermSet the default ingest delay high setpoint for the ingest feed governor.
IngestFeedGovernorIngestDelayLow   Short-TermUsed to set the default ingest delay low setpoint for the ingest feed governor.
IngestFeedGovernorRateOverride   Short-TermUsed to change in rate when under or over the setpoint. Increasing this will make the governor more aggressive in changing the ingest rate.
IngestFeedMaxConcurrentPolls   Short-TermSets the ingest feed maximum of the concurrent polls.
IsAutomaticUpdateCheckingAllowed   Short-TermEnable automatic update checking.
JoinDefaultLimit   Short-TermSets the join default limit used.
JoinRowLimit   Short-TermSets the maximum number of rows that join() and selfJoin() can return.
LarsMode   Short-TermThis is used internally to enable or disable the LogScale Assets Resolution Service (LARS).
LiveAdhocTableUpdatePeriodMinimumMs   Short-TermDefines the minimum period of time between two table updates.
LiveQueryMemoryLimit   DeprecatedSets the amount of memory in bytes that a live query can consume during its execution.
LookupTableSyncAwaitSeconds   Short-TermUsed to set the waiting time before a lookup operation fails.
MatchFilesMaxHeapFraction   Short-TermSets the total fraction of the heap allowed for lookup tables.
MaxAccessTokenTTL   Short-TermUsed to set the maximum access token expiration.
MaxConcurrentQueriesOnWorker   Short-TermSets the maximum concurrent queries on worker.
MaxCsvFileUploadSizeBytes   Short-TermRestricts the maximum CSV File upload size bytes.
MaxIngestRequestSize   Short-TermSets the maximum ingest request size used.
MaxJsonFileUploadSizeBytes   Short-TermUsed to set the maximum JSON file upload size in bytes used.
MaxNumberOfOrganizations   Short-TermSets the maximum number of organizations used.
MaxOpenSegmentsOnWorker   Short-TermSets the maximum open segment files for the scheduler. Do not modify this setting unless advised to do so by CrowdStrike Support.
MaxQueryPenaltyCreditForBlockedQueriesFactor   Short-TermUsed to set a maximum query penalty credit for blocked queries.
MaxQueryPollsForWorker   Short-TermSets the maximum query polls for worker.
MaxRelocatedDatasourcesInGlobal   Short-TermSets the maximum relocated datasources in global.
MinimumHumioVersion   Short-TermSets the minimum Falcon LogScale version used.
MinQueryPermitsFactor   Short-TermSets the minimum query permits factor used.
MultiPassDefaultIterationLimit   Short-TermSets the multiple pass default iteration limit.
MultiPassMaxIterationLimit   Short-TermSets the multiple pass maximum iteration limit.
NumberOfDaysToRemoveStaleOrganizationsAfter   Short-TermSets the number of days after which to remove stale organizations.
ParserBacktrackingLimit   Short-TermSets the number of backtracks for how many new events can be created from a single input event in parsers.
ParserThrottlingAllocationFactor   Short-TermUsed to set the parser throttling allocation factor.
PruneCommunityLockedOrganizationsAfterHours   Short-TermSet to prune community locked organizations after hours.
PruneMissingTOSAcceptanceOrganizationsAfterHours   Short-TermSet to prune missing terms of service acceptance by organizations after hours.
QueryBacktrackingLimit   Short-TermSets the number of allowed query backtracks to limit a query iterating over individual events.
QueryBlockMillisOnHighIngestDelay   Short-TermSets in milliseconds the high ingest delay of query blocks.
QueryCoordinatorMaxHeapFraction   Short-TermConfigures query queueing based on the available memory in the query coordinator.
QueryCoordinatorMemoryLimit   Short-TermUsed to set the amount of memory that the query coordinator can consume during execution per query, to ensure that the coordinating nodes of a cluster don't run out of memory.
QueryMemoryLimit   DeprecatedSets how much memory a non-live query can consume during execution.
QueryPartitionAutoBalance   Short-TermToggles on and off automatic balancing of query partitions across nodes.
QueryResultRowCountLimit   Short-TermSets how many events a query can return.
RdnsDefaultLimit   Short-TermSets the default number of resulting events allowed in rdns().
RdnsMaxLimit   Short-TermSets the maximum number of resulting events for rdns().
RejectIngestOnParserExceedingFraction   Short-TermSet to reject ingest on parsers exceeding fraction.
ReplaceANSIEscapeCodes   Short-TermSpecifies whether LogScale replaces ANSI escape codes in the result set.
RetentionPreservationEndDt   Short-TermSpecifies an end date and time for retention preservation.
RetentionPreservationStartDt   Short-TermSpecifies a start date and time for retention preservation.
RetentionPreservationTag   Short-TermSpecifies a retention preservation tag to use.
SampleIntervalForDatasourceRates   Short-TermUsed to set the a sample interval for datasource rates.
SelfJoinLimit   Short-TermUsed to set limits of a self-join.
StateRowLimit   Short-TermSets the maximum number of rows allowed in functions.
StaticQueryFractionOfCores   Short-TermSets the limit of queries in which one organization or user can run on a certain percentage of mapper threads.
TableCacheMaxStorageFraction   Short-TermDefines the fraction of disk space allowed for caching file data used by query functions such as match() and readFile().
TableCacheMaxStorageFractionForIngestAndHttpOnly   Short-TermDefines fraction of disk space allowed on ingest or httponly node for caching file data used for query functions such asmatch() and readFile().
TableCacheMemoryAllowanceFraction   Short-TermSets the table cache memory allowance fraction.
TargetMaxRateForDatasource   Short-TermSets the target maximum rate of ingest for each shard of a datasource.
UnauthenticatedGraphQLSelectionSizeLimit   Short-TermUsed to set the number of GraphQL queries on the total number of selected fields and fragments for unauthenticated users.
UndersizedMergingRetentionPercentage   Short-TermUsed to set the time span percentage that can be merged together when selecting undersized segments to merge.
VerifySegmentInBucketCompletionIntervalDays   Short-TermSets the number of interval days to verify segments in bucket completion.
VerifySegmentInBucketHeadOnly   Short-TermUsed to set the verify segment in bucket head only.