The refreshClusterManagementStats()
GraphQL mutation may be used to force a refresh of the
ClusterManagementStats
cache and return
reasonsNodeCannotBeSafelyUnregistered
for the
specified node.
When developing scripts to automate the unregistration of multiple
evicted nodes at a time, this mutation can be called to validate
that the node being unregistered can be terminated without risking
data loss. As the mutation is expensive, it should not be called
frequently.
Below is the syntax for the
refreshClusterManagementStats()
mutation field:
refreshClusterManagementStats(
nodeId : integer!
) : RefreshClusterManagementStatsMutation!
Below is an example of how this mutation field might be used:
Show:
Raw Mac OS or Linux (curl) Mac OS or Linux (curl) One-line Windows Cmd and curl Windows Powershell and curl Perl Python Node.js
Raw mutation {
refreshClusterManagementStats( nodeId : 3 )
{ reasonsNodeCannotBeSafelyUnregistered { isAlive, hasUnderReplicatedData } }
}
Mac OS or Linux (curl) curl -v -X POST $YOUR_LOGSCALE_URL/graphql \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d @- << EOF
{"query" : "mutation {
refreshClusterManagementStats( nodeId: 3 )
{ reasonsNodeCannotBeSafelyUnregistered { isAlive, hasUnderReplicatedData } }
}"
}
EOF
Mac OS or Linux (curl) One-line curl -v -X POST $YOUR_LOGSCALE_URL/graphql \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d @- << EOF
{"query" : "mutation {
refreshClusterManagementStats( nodeId: 3 )
{ reasonsNodeCannotBeSafelyUnregistered { isAlive, hasUnderReplicatedData } }
}"
}
EOF
Windows Cmd and curl curl -v -X POST $YOUR_LOGSCALE_URL/graphql ^
-H "Authorization: Bearer $TOKEN" ^
-H "Content-Type: application/json" ^
-d @'{"query" : "mutation { ^
refreshClusterManagementStats( nodeId: 3 ) ^
{ reasonsNodeCannotBeSafelyUnregistered { isAlive, hasUnderReplicatedData } } ^
}" ^
} '
Windows Powershell and curl curl.exe -X POST
-H "Authorization: Bearer $TOKEN "
-H "Content-Type: application/json"
-d '{"query" : "mutation {
refreshClusterManagementStats( nodeId: 3 )
{ reasonsNodeCannotBeSafelyUnregistered { isAlive, hasUnderReplicatedData } }
}"
}'
"$YOUR_LOGSCALE_URL /graphql"
Perl
use HTTP::Request;
use LWP;
my $INGEST_TOKEN = "TOKEN" ;
my $uri = '$YOUR_LOGSCALE_URL/graphql' ;
my $json = '{"query" : "mutation {
refreshClusterManagementStats( nodeId: 3 )
{ reasonsNodeCannotBeSafelyUnregistered { isAlive, hasUnderReplicatedData } }
}"
}' ;
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
import requests
url = '$YOUR_LOGSCALE_URL/graphql'
mydata = r'''{"query" : "mutation {
refreshClusterManagementStats( nodeId: 3 )
{ reasonsNodeCannotBeSafelyUnregistered { isAlive, hasUnderReplicatedData } }
}"
}'''
resp = requests.post(url,
data = mydata,
headers = {
"Authorization" : "Bearer $TOKEN" ,
"Content-Type" : "application/json"
}
)
print (resp.text)
Node.js const https = require ('https' );
const data = JSON .stringify (
{"query" : "mutation {
refreshClusterManagementStats( nodeId: 3 )
{ reasonsNodeCannotBeSafelyUnregistered { isAlive, hasUnderReplicatedData } }
}"
}
);
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 ();
For
RefreshClusterManagementStatsMutation ),
there is one parameter, but it has a few sub-parameters. A link to
a table with those sub-parameters is in the description field
here.
Table: RefreshClusterManagementStatsMutation