The enableFeature() GraphQL mutation may be used to enable globally a feature in LogScale. To see which features are enabled, see featureFlags()

If you want to enable a feature for a single user, use enableFeatureForUser() . To enable it for an organizaiton, use enableFeatureForOrg() .

For more information on enabling and disabling features, see the Enabling & Disabling Feature Flags reference page.

Syntax

Below is the syntax for the enableFeature() mutation field:

graphql
enableFeature(
      feature: FeatureFlag!
   ): boolean!

To enable a feature for a user, enter something like the following:

Raw
graphql
mutation {
  enableFeature(
    feature: LiveTables
  )
}
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 {
  enableFeature(
    feature: LiveTables
  )
}"
}
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 {
  enableFeature(
    feature: LiveTables
  )
}"
}
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 { ^
  enableFeature( ^
    feature: LiveTables ^
  ) ^
}" ^
} '
Windows Powershell and curl
powershell
curl.exe -X POST 
    -H "Authorization: Bearer $TOKEN"
    -H "Content-Type: application/json"
    -d '{"query" : "mutation {
  enableFeature(
    feature: LiveTables
  )
}"
}'
    "$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 {
  enableFeature(
    feature: LiveTables
  )
}"
}';
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 {
  enableFeature(
    feature: LiveTables
  )
}"
}'''

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 {
  enableFeature(
    feature: LiveTables
  )
}"
}
);


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": {
    "enableFeature": true
  }
}

Only one feature may be enabled at a time.

Given Datatypes

For the FeatureFlag enumerated list, there are several choices. The table below should list them. However, since they're all beta features, you'll have to click on the "Show Beta Features" button. Also, some features may not be enabled globally with enableFeature().

Table: FeatureFlag

ParameterTypeRequiredDefaultDescription
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: Oct 9, 2024
AlternateQueryMergeTargetHandlingboolean  Allow alternate query merge target handling.
ArrayFunctionsboolean  Enable ArrayFunctions in query language.
AzureBlobStorageboolean  Enables support for Azure Blob Storage.
CachePoliciesboolean  Prioritize newer over older segments.
CancelQueriesExceedingAggregateOutputRowLimitboolean  When enabled, queries exceeding the AggregatorOutputRowLimit will be cancelled instead of being logged.
CookieAuthServerSidedatetime  Authenticate cookies server-side.
CustomIngestTokensboolean  Enable custom ingest tokens not generated by LogScale.
DefaultRolesForGroupsboolean  Assign default roles for groups.
DerivedCidTagboolean  Permit derived CID tag.
ExportToBucketboolean  Export data to bucket storage.
ExternalFunctionsboolean  External Functions.
FalconDataConnectorboolean  Uses the Falcon data connector.
FieldAliasingboolean  Allow field aliasing.
FleetCollectorDebugLoggingboolean  Enables fleet management collector debug logging.
FleetCollectorMetricsboolean  Enables fleet management collector metrics.
FleetEphemeralHostsboolean  Use Fleet ephemeral hosts.
FleetLabelsboolean  Allow Fleet Management labels.
FleetRemoteUpdatesboolean  Fleet remote updates features.
FlightControlboolean  Enable Flight Control support in cluster.
GeographyFunctionsboolean  Enable geography functions in query language.
GraphQueriesboolean  Enables graph queries.
LiveTablesboolean  Allow use of live tables.
LogAverageUsageboolean  Enables UsageJob to log average usage as part of usage log.
LoginBridgeboolean  Enable login bridge.
MacosInstallerForLogCollectorboolean  Enables download of macos installer for logcollector through fleet management.
ManagedRepositoriesboolean  Enable LogScale Managed repositories. The customer is not permitted to change certain configurations in a LogScale Managed repository.
ManagedRepositoriesAllowFDRConfigboolean  Allow users to configure FDR feeds for managed repositories.
MeasureNewSegmentFileFormatboolean  When using the new segment file format on write, also do the old solely for comparison.
MitreDetectionAnnotationboolean  Enable Mitre detection annotation.
MultiClusterSearchboolean  Enable searching across LogScale clusters.
MultipleViewRoleBindingsboolean  Enable multiple view role bindings.
NewOrganizationLimitsboolean  Use new organization limits.
NoCurrentsForBucketSegmentsboolean  Disable currents for Bucket segments.
OneToManyGroupSynchronizationboolean  Enables mapping one group to more than one LogScale group with the same lookup name during group synchronization.
OrganizationSecurityPoliciesboolean  Enable organization level security policies. For instance the ability to enable only certain action types.
PermissionTokensboolean  Enable permission tokens.
PreMergeMiniSegmentsboolean  Pre-merge mini-segments.
QueryAssistantboolean  Enable the LogScale Query Assistant.
QueryBacktrackingLimitboolean  Limit query backtracking.
RepeatingQueriesboolean  Whether the queries are repeating.
SleepFunctionboolean  Flag for testing, does nothing.
SubdomainForOrganizationsboolean  Enable subdomains for current cluster.
UsagePageUsingIngestAfterFieldRemovalSizeboolean  The UsagePage shows data from ingestAfterFieldRemovalSize instead of segmentWriteBytes.
WriteNewSegmentFileFormatboolean  Allow writing in new segment file format.