The ipDatabaseInfo() GraphQL query returns
information about the IP location database used by the LogScale
instance.
For information on IP filters, see the
IP Filter reference page.
Below is the syntax for the ipDatabaseInfo()
query field:
ipDatabaseInfo : IpDatabaseInfo!
Below is an example of how this query 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 query {
ipDatabaseInfo { dbFilePath, updateStrategy,
metadata{ type , buildDate, description, dbFileMd5} }
}
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" : "query {
ipDatabaseInfo {dbFilePath, updateStrategy,
metadata{type, buildDate, description, dbFileMd5} }
}"
}
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" : "query {
ipDatabaseInfo {dbFilePath, updateStrategy,
metadata{type, buildDate, description, dbFileMd5} }
}"
}
EOF
Windows Cmd and curl curl -v -X POST $YOUR_LOGSCALE_URL/graphql ^
-H "Authorization: Bearer $TOKEN" ^
-H "Content-Type: application/json" ^
-d @'{"query" : "query { ^
ipDatabaseInfo {dbFilePath, updateStrategy, ^
metadata{type, buildDate, description, dbFileMd5} } ^
}" ^
} '
Windows Powershell and curl curl.exe -X POST
-H "Authorization: Bearer $TOKEN "
-H "Content-Type: application/json"
-d '{"query" : "query {
ipDatabaseInfo {dbFilePath, updateStrategy,
metadata{type, buildDate, description, dbFileMd5} }
}"
}'
"$YOUR_LOGSCALE_URL /graphql"
Perl
use HTTP::Request;
use LWP;
my $INGEST_TOKEN = "TOKEN" ;
my $uri = '$YOUR_LOGSCALE_URL/graphql' ;
my $json = '{"query" : "query {
ipDatabaseInfo {dbFilePath, updateStrategy,
metadata{type, buildDate, description, dbFileMd5} }
}"
}' ;
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" : "query {
ipDatabaseInfo {dbFilePath, updateStrategy,
metadata{type, buildDate, description, dbFileMd5} }
}"
}'''
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" : "query {
ipDatabaseInfo {dbFilePath, updateStrategy,
metadata{type, buildDate, description, dbFileMd5} }
}"
}
);
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 Show:
Success (HTTP Response Code 200 OK)
Success (HTTP Response Code 200 OK) {
"data" : {
"ipDatabaseInfo" : {
"dbFilePath" : "/data/humio-data/IpLocationDb.mmdb" ,
"updateStrategy" : "Automatic updates using ipdb.humio.com" ,
"metadata" : {
"type" : "GeoLite2-City" ,
"buildDate" : "2024-10-22T13:14:51Z" ,
"description" : "GeoLite2City database" ,
"dbFileMd5" : "485c545b0bb70fe27c733b21b1c69852"
}
}
}
}
The returned datatype, ipDatabaseInfo has a
few parameters, and some sub-parameters.
Table: IpDatabaseInfo
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: Sep 25, 2024 dbFilePath
string yes Long-Term
The absolute file path of the file containing the IP database used by LogScale. metadata
IpDatabaseMetadata
Long-Term
Metadata about the IP Database used by LogScale. See IpDatabaseMetadata
. updateStrategy
string yes Long-Term
The update strategy used for the IP Database.