API Stability |
Short-Term
|
The overrideRolledOutFeatureFlag() GraphQL mutation is used to override whether a feature should be rolled out.
Syntax
Below is the syntax for the overrideRolledOutFeatureFlag() mutation field:
graphql
overrideRolledOutFeatureFlag(
feature: FeatureFlag!,
rollOut: boolean!
): boolean!
Below is an example of how this mutation field might be used:
Show:
Raw
graphql
mutation {
overrideRolledOutFeatureFlag(
feature: NewOrganizationLimits,
rollOut: false
)
}
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" : "mutation {
overrideRolledOutFeatureFlag(
feature: NewOrganizationLimits,
rollOut: false
)
}"
}
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" : "mutation {
overrideRolledOutFeatureFlag(
feature: NewOrganizationLimits,
rollOut: false
)
}"
}
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" : "mutation { ^
overrideRolledOutFeatureFlag( ^
feature: NewOrganizationLimits, ^
rollOut: false ^
) ^
}" ^
} '
Windows Powershell and curl
powershell
curl.exe -X POST
-H "Authorization: Bearer $TOKEN"
-H "Content-Type: application/json"
-d '{"query" : "mutation {
overrideRolledOutFeatureFlag(
feature: NewOrganizationLimits,
rollOut: false
)
}"
}'
"$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" : "mutation {
overrideRolledOutFeatureFlag(
feature: NewOrganizationLimits,
rollOut: false
)
}"
}';
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" : "mutation {
overrideRolledOutFeatureFlag(
feature: NewOrganizationLimits,
rollOut: false
)
}"
}'''
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" : "mutation {
overrideRolledOutFeatureFlag(
feature: NewOrganizationLimits,
rollOut: false
)
}"
}
);
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();
Given Datatypes
For FeatureFlag
, there
are several values. The table below has a list of them, but you'll
have to click on the Show Beta Features button to see them.
Table: FeatureFlag
Parameter | Type | Required | Default | Stability | Description |
---|---|---|---|---|---|
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: Mar 14, 2025 | |||||
AlternateQueryMergeTargetHandling | boolean | Allow alternate query merge target handling. | |||
ArrayFunctions | boolean | Enable ArrayFunctions in query language. | |||
CachePolicies | boolean | Prioritize newer over older segments. | |||
CancelQueriesExceedingAggregateOutputRowLimit | boolean | When enabled, queries exceeding the AggregatorOutputRowLimit will be cancelled instead of being logged. | |||
CustomIngestTokens | boolean | Enable custom ingest tokens not generated by LogScale. | |||
DerivedCidTag | boolean | Permit derived CID tag. | |||
DigestersDontNeedMergeTargetMinis | boolean | Allow digesters to start without having all of the minis for the current merge target. This requires the AlternateQueryMergeTargetHandling feature flag to be enabled. | |||
DontSplitSegmentsForArchiving | boolean | Prevents the archiving logic from splitting segments into multiple archived files based on their tag groups. | |||
ExportToBucket | boolean | Export data to bucket storage. | |||
ExternalDataSourceSyncForEntity | boolean | Enables the external data source sync job to sync entity data. This functionality is restricted. Enabling this functionality should not be done in any production environment. | |||
ExternalDataSourceSyncForIdentity | boolean | Enables the external data source sync job to sync identity data. This functionality is restricted. Enabling this functionality should not be done in any production environment. | |||
ExternalFunctions | boolean | External Functions. | |||
FalconDataConnector | boolean | Uses the Falcon data connector. | |||
FieldAliasing | boolean | Allow field aliasing. | |||
FleetCollectorDebugLogging | boolean | Enables fleet management collector debug logging. | |||
FleetCollectorMetrics | boolean | Enables fleet management collector metrics. | |||
FleetEphemeralHosts | boolean | Use Fleet ephemeral hosts. | |||
FleetLabels | boolean | Allow Fleet Management labels. | |||
FleetOverviewDashboards | boolean | Enables dashboards on fleet overview page. This functionality is experimental. Enabling experimental functionality is strongly discouraged. It can lead to LogScale in a bad state beyond repair. | |||
FleetRemoteUpdates | boolean | Fleet remote updates features. | |||
FleetTablePageUI | boolean | Enables TablePage UI on fleet management pages. This functionality is experimental. Enabling experimental functionality is strongly discouraged. It can lead to LogScale in a bad state beyond repair. | |||
FlightControl | boolean | Enable Flight Control support in cluster. | |||
GeographyFunctions | boolean | Enable geography functions in query language. | |||
GoogleCloudArchiving | boolean | Enables archiving for Google Cloud Storage. This functionality is experimental. Enabling experimental functionality is strongly discouraged. It can lead to LogScale in a bad state beyond repair. | |||
GraphQueries | boolean | Enables graph queries. | |||
LiveTables | boolean | Allow use of live tables. | |||
LlmParserGeneration | boolean | Enables LLM parser generation. This functionality is experimental. Enabling experimental functionality is strongly discouraged. It can lead to LogScale in a bad state beyond repair. | |||
LoginBridge | boolean | Enable login bridge. | |||
MacosInstallerForLogCollector | boolean | Enables download of macos installer for logcollector through fleet management. | |||
ManagedRepositories | boolean | Enable LogScale Managed repositories. The customer is not permitted to change certain configurations in a LogScale Managed repository. | |||
ManagedRepositoriesAllowFDRConfig | boolean | Allow users to configure FDR feeds for managed repositories. | |||
MeasureNewSegmentFileFormat | boolean | When using the new segment file format on write, also do the old solely for comparison. | |||
MitreDetectionAnnotation | boolean | Enable Mitre detection annotation. | |||
MultiClusterSearch | boolean | Enable searching across LogScale clusters. | |||
MultipleViewRoleBindings | boolean | Enable multiple view role bindings. | |||
NewAutoshardRuleStore | boolean | Use new store for Autosharding rules. | |||
NewOrganizationLimits | boolean | Use new organization limits. | |||
NoCurrentsForBucketSegments | boolean | Disable currents for Bucket segments. | |||
OneToManyGroupSynchronization | boolean | Enables mapping one group to more than one LogScale group with the same lookup name during group synchronization. | |||
PreMergeMiniSegments | boolean | Pre-merge mini-segments. | |||
QueryAssistant | boolean | Enable the LogScale Query Assistant. | |||
QueryBacktrackingLimit | boolean | Limit query backtracking. | |||
RefreshClusterManagementStatsInUnregisterNode | boolean | Force a refresh of ClusterManagementStats cache before calculating UnregisterNodeBlockers in clusterUnregisterNode() mutation. | |||
RepeatingQueries | boolean | Whether the queries are repeating. | |||
ReplacePeriodicIngestOffsetPushing | boolean | Disables periodic ingestOffset pushing for datasources in favor of alternate handling. | |||
ResolveFieldsCodeGen | boolean | Resolve field names during codegen rather than for every event. | |||
SegmentRebalancerHandlesMinis | boolean | Segment rebalancer handles mini segments. Can only take effect when the AlternateQueryMergeTargetHandling and DigestersDontNeedMergeTargetMinis feature flags are also enabled. | |||
SetConsideredAliveUntilOnGracefulShutdown | boolean | Lets the cluster know that non-evicted nodes undergoing a graceful shutdown should be considered alive for 5 minutes with regards to segment rebalancing. | |||
SleepFunction | boolean | Flag for testing, does nothing. | |||
SortNewDatastructure | boolean | Use the new sort, head, tail, and table datastructure. | |||
SubdomainForOrganizations | boolean | Enable subdomains for current cluster. | |||
TimeIntervalInQuery | boolean | Enables support specifying the query time interval using the query function, setTimeInterval(). | |||
UsagePageUsingIngestAfterFieldRemovalSize | boolean | The UsagePage shows data from ingestAfterFieldRemovalSize instead of segmentWriteBytes . | |||
UseNewQueryCoordinationPartitions | boolean | Use the new query coordination partition logic. | |||
WriteNewSegmentFileFormat | boolean | Allow writing in new segment file format. |