ArangoDB v2.8 reached End of Life (EOL) and is no longer supported.

This documentation is outdated. Please see the most recent version here: Try latest

Module “queries”

The query module provides the infrastructure for working with currently running AQL queries via arangosh.

Properties

queries.properties() Returns the servers current query tracking configuration; we change the slow query threshold to get better results:

arangosh> var queries = require("org/arangodb/aql/queries");
arangosh> queries.properties();
arangosh> queries.properties({slowQueryThreshold: 1});

Show execution results

{ 
  "code" : 200, 
  "enabled" : true, 
  "trackSlowQueries" : true, 
  "maxSlowQueries" : 64, 
  "slowQueryThreshold" : 10, 
  "maxQueryStringLength" : 4096 
}
{ 
  "code" : 200, 
  "enabled" : true, 
  "trackSlowQueries" : true, 
  "maxSlowQueries" : 64, 
  "slowQueryThreshold" : 1, 
  "maxQueryStringLength" : 4096 
}

Hide execution results

Currently running queries

We create a task that spawns queries, so we have nice output. Since this task uses resources, you may want to increase period (and not forget to remove it… afterwards):

arangosh> var theQuery = 'FOR sleepLoooong IN 1..5 LET sleepLoooonger = SLEEP(1000) RETURN sleepLoooong';
arangosh> var tasks = require("org/arangodb/tasks");
arangosh> tasks.register({
........>  id: "mytask-1",
........>  name: "this is a sample task to spawn a slow aql query",
........>  command: "require('internal').db._query('" + theQuery + "');"
........> });
arangosh> queries.current();

Show execution results

{ 
  "id" : "mytask-1", 
  "name" : "this is a sample task to spawn a slow aql query", 
  "type" : "timed", 
  "offset" : 0.00001, 
  "created" : 1468399061.54702, 
  "command" : "require('internal').db._query('FOR sleepLoooong IN 1..5 LET sleepLoooonger = SLE...", 
  "database" : "_system", 
  "code" : 200 
}
[ 
  { 
    "id" : "163", 
    "query" : "FOR sleepLoooong IN 1..5 LET sleepLoooonger = SLEEP(1000) RETURN sleepLoooong", 
    "started" : "2016-07-13T08:37:41Z", 
    "runTime" : 1.1689817905426025 
  } 
]

Hide execution results

The function returns the currently running AQL queries as an array.

Slow queries

The function returns the last AQL queries that exceeded the slow query threshold as an array:

arangosh> queries.slow();

Show execution results

[ ]

Hide execution results

Clear slow queries

Clear the list of slow AQL queries:

arangosh> queries.clearSlow();
arangosh> queries.slow();

Show execution results

{ 
  "code" : 200 
}
[ ]

Hide execution results

Kill

Kill a running AQL query:

arangosh> var runningQueries = queries.current().filter(function(query) {
........>   return query.query === theQuery;
........> });
arangosh> queries.kill(runningQueries[0].id);

Show execution results

{ 
  "code" : 200 
}

Hide execution results

❮ "actions" "planner" ❯