clients: this attribute was used in ArangoDB versions prior to 2.1 for returning which replication applier clients connected to the logger. Each client was returned with its date/time of last connect. Since there is no replication-logger in ArangoDB where the client connection data could be kept, this attribute currently always is an empty array.",
"summary": " Return replication logger state",
"httpMethod": "GET",
"examples": "
Returns the state of the replication logger.
shell> curl --dump - http://localhost:8529/_api/replication/logger-state\n\nHTTP/1.1 200 OK\ncontent-type: application/json; charset=utf-8\n\n{ \n \"state\" : { \n \"running\" : true, \n \"lastLogTick\" : \"1605968949\", \n \"totalEvents\" : 9961, \n \"time\" : \"2015-05-05T07:28:46Z\" \n }, \n \"server\" : { \n \"version\" : \"2.6.0-devel\", \n \"serverId\" : \"39957130875700\" \n }, \n \"clients\" : [ ] \n}\n
",
"nickname": "ReturnReplicationLoggerState"
}
],
"path": "/_api/replication/logger-state"
},
{
"operations": [
{
"errorResponses": [
{
"reason": "is returned if the batch was created successfully.
",
"code": "204"
},
{
"reason": "is returned if the ttl value is invalid or if DBserver attribute is not specified or illegal on a coordinator.
",
"code": "400"
},
{
"reason": "is returned when an invalid HTTP method is used.",
"code": "405"
}
],
"parameters": [
{
"dataType": "Json",
"paramType": "body",
"required": true,
"name": "body",
"description": "A JSON object with the batch configuration.
"
}
],
"notes": "Creates a new dump batch and returns the batch's id.
The body of the request must be a JSON object with the following attributes:
- ttl: the time-to-live for the new batch (in seconds)
The response is a JSON object with the following attributes:
Note: on a coordinator, this request must have the URL parameter DBserver which must be an ID of a DBserver. The very same request is forwarded synchronously to that DBserver. It is an error if this attribute is not bound in the coordinator case.
",
"summary": " Create new dump batch",
"httpMethod": "POST",
"examples": "",
"nickname": "CreateNewDumpBatch"
}
],
"path": "/_api/replication/batch"
},
{
"operations": [
{
"errorResponses": [
{
"reason": "is returned if the batch's ttl was extended successfully.
",
"code": "204"
},
{
"reason": "is returned if the ttl value is invalid or the batch was not found.
",
"code": "400"
},
{
"reason": "is returned when an invalid HTTP method is used.",
"code": "405"
}
],
"parameters": [
{
"dataType": "Json",
"paramType": "body",
"required": true,
"name": "body",
"description": "A JSON object with the batch configration.
"
},
{
"dataType": "String",
"paramType": "path",
"required": true,
"name": "id",
"description": "The id of the batch.
"
}
],
"notes": "Extends the ttl of an existing dump batch, using the batch's id and the provided ttl value.
The body of the request must be a JSON object with the following attributes:
- ttl: the time-to-live for the batch (in seconds)
If the batch's ttl can be extended successully, the response is empty.
Note: on a coordinator, this request must have the URL parameter DBserver which must be an ID of a DBserver. The very same request is forwarded synchronously to that DBserver. It is an error if this attribute is not bound in the coordinator case.
",
"summary": " Prolong existing dump batch",
"httpMethod": "PUT",
"examples": "",
"nickname": "ProlongExistingDumpBatch"
}
],
"path": "/_api/replication/batch/{id}"
},
{
"operations": [
{
"errorResponses": [
{
"reason": "is returned if the batch was deleted successfully.
",
"code": "204"
},
{
"reason": "is returned if the batch was not found.
",
"code": "400"
},
{
"reason": "is returned when an invalid HTTP method is used.",
"code": "405"
}
],
"parameters": [
{
"dataType": "String",
"paramType": "path",
"required": true,
"name": "id",
"description": "The id of the batch.
"
}
],
"notes": "Deletes the existing dump batch, allowing compaction and cleanup to resume.
Note: on a coordinator, this request must have the URL parameter DBserver which must be an ID of a DBserver. The very same request is forwarded synchronously to that DBserver. It is an error if this attribute is not bound in the coordinator case.
",
"summary": " Deletes an existing dump batch",
"httpMethod": "DELETE",
"examples": "",
"nickname": "DeletesAnExistingDumpBatch"
}
],
"path": "/_api/replication/batch/{id}"
},
{
"operations": [
{
"errorResponses": [
{
"reason": "is returned if the request was executed successfully, and there are log events available for the requested range. The response body will not be empty in this case.
",
"code": "200"
},
{
"reason": "is returned if the request was executed successfully, but there are no log events available for the requested range. The response body will be empty in this case.
",
"code": "204"
},
{
"reason": "is returned if either the from or to values are invalid.
",
"code": "400"
},
{
"reason": "is returned when an invalid HTTP method is used.
",
"code": "405"
},
{
"reason": "is returned if an error occurred while assembling the response.
",
"code": "500"
},
{
"reason": "is returned when this operation is called on a coordinator in a cluster.
",
"code": "501"
}
],
"parameters": [
{
"dataType": "Number",
"paramType": "query",
"required": false,
"name": "from",
"description": "Lower bound tick value for results.
"
},
{
"dataType": "Number",
"paramType": "query",
"required": false,
"name": "to",
"description": "Upper bound tick value for results.
"
},
{
"dataType": "Number",
"paramType": "query",
"required": false,
"name": "chunkSize",
"description": "Approximate maximum size of the returned result.
"
},
{
"dataType": "Boolean",
"paramType": "query",
"required": false,
"name": "includeSystem",
"description": "Include system collections in the result. The default value is true.
"
}
],
"notes": "Returns data from the server's replication log. This method can be called by replication clients after an initial synchronization of data. The method will return all \"recent\" log entries from the logger server, and the clients can replay and apply these entries locally so they get to the same data state as the logger server.
Clients can call this method repeatedly to incrementally fetch all changes from the logger server. In this case, they should provide the from value so they will only get returned the log events since their last fetch.
When the from URL parameter is not used, the logger server will return log entries starting at the beginning of its replication log. When the from parameter is used, the logger server will only return log entries which have higher tick values than the specified from value (note: the log entry with a tick value equal to from will be excluded). Use the from value when incrementally fetching log data.
The to URL parameter can be used to optionally restrict the upper bound of the result to a certain tick value. If used, the result will contain only log events with tick values up to (including) to. In incremental fetching, there is no need to use the to parameter. It only makes sense in special situations, when only parts of the change log are required.
The chunkSize URL parameter can be used to control the size of the result. It must be specified in bytes. The chunkSize value will only be honored approximately. Otherwise a too low chunkSize value could cause the server to not be able to put just one log entry into the result and return it. Therefore, the chunkSize value will only be consulted after a log entry has been written into the result. If the result size is then bigger than chunkSize, the server will respond with as many log entries as there are in the response already. If the result size is still smaller than chunkSize, the server will try to return more data if there's more data left to return.
If chunkSize is not specified, some server-side default value will be used.
The Content-Type of the result is application/x-arango-dump. This is an easy-to-process format, with all log events going onto separate lines in the response body. Each log event itself is a JSON object, with at least the following attributes:
- tick: the log event tick value
- type: the log event type
Individual log events will also have additional attributes, depending on the event type. A few common attributes which are used for multiple events types are:
- cid: id of the collection the event was for
- tid: id of the transaction the event was contained in
- key: document key
- rev: document revision id
- data: the original document data
A more detailed description of the individual replication event types and their data structures can be found in the manual.
The response will also contain the following HTTP headers:
- x-arango-replication-active: whether or not the logger is active. Clients can use this flag as an indication for their polling frequency. If the logger is not active and there are no more replication events available, it might be sensible for a client to abort, or to go to sleep for a long time and try again later to check whether the logger has been activated.
- x-arango-replication-lastincluded: the tick value of the last included value in the result. In incremental log fetching, this value can be used as the from value for the following request. Note that if the result is empty, the value will be 0. This value should not be used as from value by clients in the next request (otherwise the server would return the log events from the start of the log again).
- x-arango-replication-lasttick: the last tick value the logger server has logged (not necessarily included in the result). By comparing the the last tick and last included tick values, clients have an approximate indication of how many events there are still left to fetch.
- x-arango-replication-checkmore: whether or not there already exists more log data which the client could fetch immediately. If there is more log data available, the client could call logger-follow again with an adjusted from value to fetch remaining log entries until there are no more. If there isn't any more log data to fetch, the client might decide to go to sleep for a while before calling the logger again.
Note: this method is not supported on a coordinator in a cluster.
",
"summary": " Returns log entries",
"httpMethod": "GET",
"examples": "
No log events available:
shell> curl --dump - http://localhost:8529/_api/replication/logger-follow?from=1630151733\n\nHTTP/1.1 204 No Content\ncontent-type: application/x-arango-dump; charset=utf-8\nx-arango-replication-active: true\nx-arango-replication-checkmore: false\nx-arango-replication-lastincluded: 0\nx-arango-replication-lasttick: 1630151733\n\n
A few log events:
shell> curl --dump - http://localhost:8529/_api/replication/logger-follow?from=1630151733\n\nHTTP/1.1 200 OK\ncontent-type: application/x-arango-dump; charset=utf-8\nx-arango-replication-active: true\nx-arango-replication-checkmore: false\nx-arango-replication-lastincluded: 1643914293\nx-arango-replication-lasttick: 1643914293\n\n\"{\\\"tick\\\":\\\"1630479413\\\",\\\"type\\\":2301,\\\"database\\\":\\\"74805\\\",\\\"cid\\\":\\\"1627857973\\\",\\\"tid\\\":\\\"0\\\",\\\"key\\\":\\\"aliceAndBob\\\",\\\"rev\\\":\\\"1630413877\\\",\\\"data\\\":{\\\"_key\\\":\\\"aliceAndBob\\\",\\\"_rev\\\":\\\"1630413877\\\",\\\"_from\\\":\\\"1627595829\\\\/alice\\\",\\\"_to\\\":\\\"1627726901\\\\/bob\\\"}}\\n{\\\"tick\\\":\\\"1630872629\\\",\\\"type\\\":2001,\\\"database\\\":\\\"74805\\\",\\\"cid\\\":\\\"1627857973\\\"}\\n{\\\"tick\\\":\\\"1630938165\\\",\\\"type\\\":2001,\\\"database\\\":\\\"74805\\\",\\\"cid\\\":\\\"1627595829\\\"}\\n{\\\"tick\\\":\\\"1631003701\\\",\\\"type\\\":2001,\\\"database\\\":\\\"74805\\\",\\\"cid\\\":\\\"1627726901\\\"}\\n{\\\"tick\\\":\\\"1631331381\\\",\\\"type\\\":2302,\\\"database\\\":\\\"74805\\\",\\\"cid\\\":\\\"2040885\\\",\\\"cname\\\":\\\"_graphs\\\",\\\"tid\\\":\\\"0\\\",\\\"key\\\":\\\"social\\\",\\\"rev\\\":\\\"1631265845\\\"}\\n{\\\"tick\\\":\\\"1631724597\\\",\\\"type\\\":2000,\\\"database\\\":\\\"74805\\\",\\\"cid\\\":\\\"1631659061\\\",\\\"collection\\\":{\\\"version\\\":5,\\\"type\\\":2,\\\"cid\\\":\\\"1631659061\\\",\\\"deleted\\\":false,\\\"doCompact\\\":true,\\\"maximalSize\\\":1048576,\\\"name\\\":\\\"female\\\",\\\"isVolatile\\\":false,\\\"waitForSync\\\":false}}\\n{\\\"tick\\\":\\\"1631855669\\\",\\\"type\\\":2000,\\\"database\\\":\\\"74805\\\",\\\"cid\\\":\\\"1631790133\\\",\\\"collection\\\":{\\\"version\\\":5,\\\"type\\\":2,\\\"cid\\\":\\\"1631790133\\\",\\\"deleted\\\":false,\\\"doCompact\\\":true,\\\"maximalSize\\\":1048576,\\\"name\\\":\\\"male\\\",\\\"isVolatile\\\":false,\\\"waitForSync\\\":false}}\\n{\\\"tick\\\":\\\"1631986741\\\",\\\"type\\\":2000,\\\"database\\\":\\\"74805\\\",\\\"cid\\\":\\\"1631921205\\\",\\\"collection\\\":{\\\"version\\\":5,\\\"type\\\":3,\\\"cid\\\":\\\"1631921205\\\",\\\"deleted\\\":false,\\\"doCompact\\\":true,\\\"maximalSize\\\":1048576,\\\"name\\\":\\\"relation\\\",\\\"isVolatile\\\":false,\\\"waitForSync\\\":false}}\\n{\\\"tick\\\":\\\"1632183349\\\",\\\"type\\\":2300,\\\"database\\\":\\\"74805\\\",\\\"cid\\\":\\\"2040885\\\",\\\"cname\\\":\\\"_graphs\\\",\\\"tid\\\":\\\"0\\\",\\\"key\\\":\\\"social\\\",\\\"rev\\\":\\\"1632117813\\\",\\\"data\\\":{\\\"_key\\\":\\\"social\\\",\\\"_rev\\\":\\\"1632117813\\\",\\\"edgeDefinitions\\\":[{\\\"collection\\\":\\\"relation\\\",\\\"from\\\":[\\\"female\\\",\\\"male\\\"],\\\"to\\\":[\\\"female\\\",\\\"male\\\"]}],\\\"orphanCollections\\\":[]}}\\n{\\\"tick\\\":\\\"1632511029\\\",\\\"type\\\":2300,\\\"database\\\":\\\"74805\\\",\\\"cid\\\":\\\"1631659061\\\",\\\"tid\\\":\\\"0\\\",\\\"key\\\":\\\"alice\\\",\\\"rev\\\":\\\"1632445493\\\",\\\"data\\\":{\\\"_key\\\":\\\"alice\\\",\\\"_rev\\\":\\\"1632445493\\\",\\\"name\\\":\\\"Alice\\\"}}\\n{\\\"tick\\\":\\\"1632838709\\\",\\\"type\\\":2300,\\\"database\\\":\\\"74805\\\",\\\"cid\\\":\\\"1631790133\\\",\\\"tid\\\":\\\"0\\\",\\\"key\\\":\\\"bob\\\",\\\"rev\\\":\\\"1632773173\\\",\\\"data\\\":{\\\"_key\\\":\\\"bob\\\",\\\"_rev\\\":\\\"1632773173\\\",\\\"name\\\":\\\"Bob\\\"}}\\n{\\\"tick\\\":\\\"1633035317\\\",\\\"type\\\":2300,\\\"database\\\":\\\"74805\\\",\\\"cid\\\":\\\"1631790133\\\",\\\"tid\\\":\\\"0\\\",\\\"key\\\":\\\"charly\\\",\\\"rev\\\":\\\"1632969781\\\",\\\"data\\\":{\\\"_key\\\":\\\"charly\\\",\\\"_rev\\\":\\\"1632969781\\\"}}\\n{\\\"tick\\\":\\\"1633231925\\\",\\\"type\\\":2300,\\\"database\\\":\\\"74805\\\",\\\"cid\\\":\\\"1631659061\\\",\\\"tid\\\":\\\"0\\\",\\\"key\\\":\\\"diana\\\",\\\"rev\\\":\\\"1633166389\\\",\\\"data\\\":{\\\"_key\\\":\\\"diana\\\",\\\"_rev\\\":\\\"1633166389\\\"}}\\n{\\\"tick\\\":\\\"1633559605\\\",\\\"type\\\":2301,\\\"database\\\":\\\"74805\\\",\\\"cid\\\":\\\"1631921205\\\",\\\"tid\\\":\\\"0\\\",\\\"key\\\":\\\"aliceAndBob\\\",\\\"rev\\\":\\\"1633494069\\\",\\\"data\\\":{\\\"_key\\\":\\\"aliceAndBob\\\",\\\"_rev\\\":\\\"1633494069\\\",\\\"_from\\\":\\\"1631659061\\\\/alice\\\",\\\"_to\\\":\\\"1631790133\\\\/bob\\\",\\\"type\\\":\\\"married\\\"}}\\n{\\\"tick\\\":\\\"1633821749\\\",\\\"type\\\":2301,\\\"database\\\":\\\"74805\\\",\\\"cid\\\":\\\"1631921205\\\",\\\"tid\\\":\\\"0\\\",\\\"key\\\":\\\"aliceAndCharly\\\",\\\"rev\\\":\\\"1633756213\\\",\\\"data\\\":{\\\"_key\\\":\\\"aliceAndCharly\\\",\\\"_rev\\\":\\\"1633756213\\\",\\\"_from\\\":\\\"1631659061\\\\/alice\\\",\\\"_to\\\":\\\"1631790133\\\\/charly\\\",\\\"type\\\":\\\"friend\\\"}}\\n{\\\"tick\\\":\\\"1634018357\\\",\\\"type\\\":2301,\\\"database\\\":\\\"74805\\\",\\\"cid\\\":\\\"1631921205\\\",\\\"tid\\\":\\\"0\\\",\\\"key\\\":\\\"charlyAndDiana\\\",\\\"rev\\\":\\\"1633952821\\\",\\\"data\\\":{\\\"_key\\\":\\\"charlyAndDiana\\\",\\\"_rev\\\":\\\"1633952821\\\",\\\"_from\\\":\\\"1631790133\\\\/charly\\\",\\\"_to\\\":\\\"1631659061\\\\/diana\\\"}}\\n{\\\"tick\\\":\\\"1634214965\\\",\\\"type\\\":2301,\\\"database\\\":\\\"74805\\\",\\\"cid\\\":\\\"1631921205\\\",\\\"tid\\\":\\\"0\\\",\\\"key\\\":\\\"bobAndDiana\\\",\\\"rev\\\":\\\"1634149429\\\",\\\"data\\\":{\\\"_key\\\":\\\"bobAndDiana\\\",\\\"_rev\\\":\\\"1634149429\\\",\\\"_from\\\":\\\"1631790133\\\\/bob\\\",\\\"_to\\\":\\\"1631659061\\\\/diana\\\"}}\\n{\\\"tick\\\":\\\"1634673717\\\",\\\"type\\\":2301,\\\"database\\\":\\\"74805\\\",\\\"cid\\\":\\\"1631921205\\\",\\\"tid\\\":\\\"0\\\",\\\"key\\\":\\\"aliceAndBob\\\",\\\"rev\\\":\\\"1634608181\\\",\\\"data\\\":{\\\"_key\\\":\\\"aliceAndBob\\\",\\\"_rev\\\":\\\"1634608181\\\",\\\"_from\\\":\\\"1631659061\\\\/alice\\\",\\\"_to\\\":\\\"1631790133\\\\/bob\\\",\\\"type\\\":\\\"married\\\",\\\"since\\\":\\\"01.01.2001\\\"}}\\n{\\\"tick\\\":\\\"1635066933\\\",\\\"type\\\":2001,\\\"database\\\":\\\"74805\\\",\\\"cid\\\":\\\"1631921205\\\"}\\n{\\\"tick\\\":\\\"1635132469\\\",\\\"type\\\":2001,\\\"database\\\":\\\"74805\\\",\\\"cid\\\":\\\"1631659061\\\"}\\n{\\\"tick\\\":\\\"1635198005\\\",\\\"type\\\":2001,\\\"database\\\":\\\"74805\\\",\\\"cid\\\":\\\"1631790133\\\"}\\n{\\\"tick\\\":\\\"1635525685\\\",\\\"type\\\":2302,\\\"database\\\":\\\"74805\\\",\\\"cid\\\":\\\"2040885\\\",\\\"cname\\\":\\\"_graphs\\\",\\\"tid\\\":\\\"0\\\",\\\"key\\\":\\\"social\\\",\\\"rev\\\":\\\"1635460149\\\"}\\n{\\\"tick\\\":\\\"1635918901\\\",\\\"type\\\":2000,\\\"database\\\":\\\"74805\\\",\\\"cid\\\":\\\"1635853365\\\",\\\"collection\\\":{\\\"version\\\":5,\\\"type\\\":2,\\\"cid\\\":\\\"1635853365\\\",\\\"deleted\\\":false,\\\"doCompact\\\":true,\\\"maximalSize\\\":1048576,\\\"name\\\":\\\"female\\\",\\\"isVolatile\\\":false,\\\"waitForSync\\\":false}}\\n{\\\"tick\\\":\\\"1636049973\\\",\\\"type\\\":2000,\\\"database\\\":\\\"74805\\\",\\\"cid\\\":\\\"1635984437\\\",\\\"collection\\\":{\\\"version\\\":5,\\\"type\\\":2,\\\"cid\\\":\\\"1635984437\\\",\\\"deleted\\\":false,\\\"doCompact\\\":true,\\\"maximalSize\\\":1048576,\\\"name\\\":\\\"male\\\",\\\"isVolatile\\\":false,\\\"waitForSync\\\":false}}\\n{\\\"tick\\\":\\\"1636181045\\\",\\\"type\\\":2000,\\\"database\\\":\\\"74805\\\",\\\"cid\\\":\\\"1636115509\\\",\\\"collection\\\":{\\\"version\\\":5,\\\"type\\\":3,\\\"cid\\\":\\\"1636115509\\\",\\\"deleted\\\":false,\\\"doCompact\\\":true,\\\"maximalSize\\\":1048576,\\\"name\\\":\\\"relation\\\",\\\"isVolatile\\\":false,\\\"waitForSync\\\":false}}\\n{\\\"tick\\\":\\\"1636377653\\\",\\\"type\\\":2300,\\\"database\\\":\\\"74805\\\",\\\"cid\\\":\\\"2040885\\\",\\\"cname\\\":\\\"_graphs\\\",\\\"tid\\\":\\\"0\\\",\\\"key\\\":\\\"social\\\",\\\"rev\\\":\\\"1636312117\\\",\\\"data\\\":{\\\"_key\\\":\\\"social\\\",\\\"_rev\\\":\\\"1636312117\\\",\\\"edgeDefinitions\\\":[{\\\"collection\\\":\\\"relation\\\",\\\"from\\\":[\\\"female\\\",\\\"male\\\"],\\\"to\\\":[\\\"female\\\",\\\"male\\\"]}],\\\"orphanCollections\\\":[]}}\\n{\\\"tick\\\":\\\"1636705333\\\",\\\"type\\\":2300,\\\"database\\\":\\\"74805\\\",\\\"cid\\\":\\\"1635853365\\\",\\\"tid\\\":\\\"0\\\",\\\"key\\\":\\\"alice\\\",\\\"rev\\\":\\\"1636639797\\\",\\\"data\\\":{\\\"_key\\\":\\\"alice\\\",\\\"_rev\\\":\\\"1636639797\\\",\\\"name\\\":\\\"Alice\\\"}}\\n{\\\"tick\\\":\\\"1637033013\\\",\\\"type\\\":2300,\\\"database\\\":\\\"74805\\\",\\\"cid\\\":\\\"1635984437\\\",\\\"tid\\\":\\\"0\\\",\\\"key\\\":\\\"bob\\\",\\\"rev\\\":\\\"1636967477\\\",\\\"data\\\":{\\\"_key\\\":\\\"bob\\\",\\\"_rev\\\":\\\"1636967477\\\",\\\"name\\\":\\\"Bob\\\"}}\\n{\\\"tick\\\":\\\"1637229621\\\",\\\"type\\\":2300,\\\"database\\\":\\\"74805\\\",\\\"cid\\\":\\\"1635984437\\\",\\\"tid\\\":\\\"0\\\",\\\"key\\\":\\\"charly\\\",\\\"rev\\\":\\\"1637164085\\\",\\\"data\\\":{\\\"_key\\\":\\\"charly\\\",\\\"_rev\\\":\\\"1637164085\\\"}}\\n{\\\"tick\\\":\\\"1637426229\\\",\\\"type\\\":2300,\\\"database\\\":\\\"74805\\\",\\\"cid\\\":\\\"1635853365\\\",\\\"tid\\\":\\\"0\\\",\\\"key\\\":\\\"diana\\\",\\\"rev\\\":\\\"1637360693\\\",\\\"data\\\":{\\\"_key\\\":\\\"diana\\\",\\\"_rev\\\":\\\"1637360693\\\"}}\\n{\\\"tick\\\":\\\"1637753909\\\",\\\"type\\\":2301,\\\"database\\\":\\\"74805\\\",\\\"cid\\\":\\\"1636115509\\\",\\\"tid\\\":\\\"0\\\",\\\"key\\\":\\\"aliceAndBob\\\",\\\"rev\\\":\\\"1637688373\\\",\\\"data\\\":{\\\"_key\\\":\\\"aliceAndBob\\\",\\\"_rev\\\":\\\"1637688373\\\",\\\"_from\\\":\\\"1635853365\\\\/alice\\\",\\\"_to\\\":\\\"1635984437\\\\/bob\\\",\\\"type\\\":\\\"married\\\"}}\\n{\\\"tick\\\":\\\"1638016053\\\",\\\"type\\\":2301,\\\"database\\\":\\\"74805\\\",\\\"cid\\\":\\\"1636115509\\\",\\\"tid\\\":\\\"0\\\",\\\"key\\\":\\\"aliceAndCharly\\\",\\\"rev\\\":\\\"1637950517\\\",\\\"data\\\":{\\\"_key\\\":\\\"aliceAndCharly\\\",\\\"_rev\\\":\\\"1637950517\\\",\\\"_from\\\":\\\"1635853365\\\\/alice\\\",\\\"_to\\\":\\\"1635984437\\\\/charly\\\",\\\"type\\\":\\\"friend\\\"}}\\n{\\\"tick\\\":\\\"1638212661\\\",\\\"type\\\":2301,\\\"database\\\":\\\"74805\\\",\\\"cid\\\":\\\"1636115509\\\",\\\"tid\\\":\\\"0\\\",\\\"key\\\":\\\"charlyAndDiana\\\",\\\"rev\\\":\\\"1638147125\\\",\\\"data\\\":{\\\"_key\\\":\\\"charlyAndDiana\\\",\\\"_rev\\\":\\\"1638147125\\\",\\\"_from\\\":\\\"1635984437\\\\/charly\\\",\\\"_to\\\":\\\"1635853365\\\\/diana\\\"}}\\n{\\\"tick\\\":\\\"1638409269\\\",\\\"type\\\":2301,\\\"database\\\":\\\"74805\\\",\\\"cid\\\":\\\"1636115509\\\",\\\"tid\\\":\\\"0\\\",\\\"key\\\":\\\"bobAndDiana\\\",\\\"rev\\\":\\\"1638343733\\\",\\\"data\\\":{\\\"_key\\\":\\\"bobAndDiana\\\",\\\"_rev\\\":\\\"1638343733\\\",\\\"_from\\\":\\\"1635984437\\\\/bob\\\",\\\"_to\\\":\\\"1635853365\\\\/diana\\\"}}\\n{\\\"tick\\\":\\\"1638802485\\\",\\\"type\\\":2200,\\\"database\\\":\\\"74805\\\",\\\"tid\\\":\\\"1638671413\\\"}\\n{\\\"tick\\\":\\\"1638868021\\\",\\\"type\\\":2302,\\\"database\\\":\\\"74805\\\",\\\"cid\\\":\\\"1636115509\\\",\\\"tid\\\":\\\"1638671413\\\",\\\"key\\\":\\\"aliceAndBob\\\",\\\"rev\\\":\\\"1638736949\\\"}\\n{\\\"tick\\\":\\\"1638933557\\\",\\\"type\\\":2201,\\\"database\\\":\\\"74805\\\",\\\"tid\\\":\\\"1638671413\\\"}\\n{\\\"tick\\\":\\\"1639326773\\\",\\\"type\\\":2001,\\\"database\\\":\\\"74805\\\",\\\"cid\\\":\\\"1636115509\\\"}\\n{\\\"tick\\\":\\\"1639392309\\\",\\\"type\\\":2001,\\\"database\\\":\\\"74805\\\",\\\"cid\\\":\\\"1635853365\\\"}\\n{\\\"tick\\\":\\\"1639457845\\\",\\\"type\\\":2001,\\\"database\\\":\\\"74805\\\",\\\"cid\\\":\\\"1635984437\\\"}\\n{\\\"tick\\\":\\\"1639785525\\\",\\\"type\\\":2302,\\\"database\\\":\\\"74805\\\",\\\"cid\\\":\\\"2040885\\\",\\\"cname\\\":\\\"_graphs\\\",\\\"tid\\\":\\\"0\\\",\\\"key\\\":\\\"social\\\",\\\"rev\\\":\\\"1639719989\\\"}\\n{\\\"tick\\\":\\\"1640375349\\\",\\\"type\\\":2000,\\\"database\\\":\\\"74805\\\",\\\"cid\\\":\\\"1640309813\\\",\\\"collection\\\":{\\\"version\\\":5,\\\"type\\\":2,\\\"cid\\\":\\\"1640309813\\\",\\\"deleted\\\":false,\\\"doCompact\\\":true,\\\"maximalSize\\\":1048576,\\\"name\\\":\\\"vertices\\\",\\\"isVolatile\\\":false,\\\"waitForSync\\\":false}}\\n{\\\"tick\\\":\\\"1640506421\\\",\\\"type\\\":2000,\\\"database\\\":\\\"74805\\\",\\\"cid\\\":\\\"1640440885\\\",\\\"collection\\\":{\\\"version\\\":5,\\\"type\\\":3,\\\"cid\\\":\\\"1640440885\\\",\\\"deleted\\\":false,\\\"doCompact\\\":true,\\\"maximalSize\\\":1048576,\\\"name\\\":\\\"edges\\\",\\\"isVolatile\\\":false,\\\"waitForSync\\\":false}}\\n{\\\"tick\\\":\\\"1640703029\\\",\\\"type\\\":2300,\\\"database\\\":\\\"74805\\\",\\\"cid\\\":\\\"2040885\\\",\\\"cname\\\":\\\"_graphs\\\",\\\"tid\\\":\\\"0\\\",\\\"key\\\":\\\"graph\\\",\\\"rev\\\":\\\"1640637493\\\",\\\"data\\\":{\\\"_key\\\":\\\"graph\\\",\\\"_rev\\\":\\\"1640637493\\\",\\\"edgeDefinitions\\\":[{\\\"collection\\\":\\\"edges\\\",\\\"from\\\":[\\\"vertices\\\"],\\\"to\\\":[\\\"vertices\\\"]}]}}\\n{\\\"tick\\\":\\\"1641161781\\\",\\\"type\\\":2300,\\\"database\\\":\\\"74805\\\",\\\"cid\\\":\\\"1640309813\\\",\\\"tid\\\":\\\"0\\\",\\\"key\\\":\\\"1\\\",\\\"rev\\\":\\\"1641096245\\\",\\\"data\\\":{\\\"_key\\\":\\\"1\\\",\\\"_rev\\\":\\\"1641096245\\\"}}\\n{\\\"tick\\\":\\\"1641554997\\\",\\\"type\\\":2300,\\\"database\\\":\\\"74805\\\",\\\"cid\\\":\\\"1640309813\\\",\\\"tid\\\":\\\"0\\\",\\\"key\\\":\\\"2\\\",\\\"rev\\\":\\\"1641489461\\\",\\\"data\\\":{\\\"_key\\\":\\\"2\\\",\\\"_rev\\\":\\\"1641489461\\\"}}\\n{\\\"tick\\\":\\\"1641948213\\\",\\\"type\\\":2301,\\\"database\\\":\\\"74805\\\",\\\"cid\\\":\\\"1640440885\\\",\\\"tid\\\":\\\"0\\\",\\\"key\\\":\\\"1641882677\\\",\\\"rev\\\":\\\"1641882677\\\",\\\"data\\\":{\\\"_key\\\":\\\"1641882677\\\",\\\"_rev\\\":\\\"1641882677\\\",\\\"_from\\\":\\\"1640309813\\\\/1\\\",\\\"_to\\\":\\\"1640309813\\\\/2\\\",\\\"name\\\":\\\"Emil\\\"}}\\n{\\\"tick\\\":\\\"1642079285\\\",\\\"type\\\":2001,\\\"database\\\":\\\"74805\\\",\\\"cid\\\":\\\"1640440885\\\"}\\n{\\\"tick\\\":\\\"1642144821\\\",\\\"type\\\":2001,\\\"database\\\":\\\"74805\\\",\\\"cid\\\":\\\"1640309813\\\"}\\n{\\\"tick\\\":\\\"1642341429\\\",\\\"type\\\":2302,\\\"database\\\":\\\"74805\\\",\\\"cid\\\":\\\"2040885\\\",\\\"cname\\\":\\\"_graphs\\\",\\\"tid\\\":\\\"0\\\",\\\"key\\\":\\\"graph\\\",\\\"rev\\\":\\\"1642275893\\\"}\\n{\\\"tick\\\":\\\"1642472501\\\",\\\"type\\\":2000,\\\"database\\\":\\\"74805\\\",\\\"cid\\\":\\\"1642406965\\\",\\\"collection\\\":{\\\"version\\\":5,\\\"type\\\":2,\\\"cid\\\":\\\"1642406965\\\",\\\"deleted\\\":false,\\\"doCompact\\\":true,\\\"maximalSize\\\":1048576,\\\"name\\\":\\\"products\\\",\\\"isVolatile\\\":false,\\\"waitForSync\\\":false}}\\n{\\\"tick\\\":\\\"1642669109\\\",\\\"type\\\":2001,\\\"database\\\":\\\"74805\\\",\\\"cid\\\":\\\"1642406965\\\"}\\n{\\\"tick\\\":\\\"1642800181\\\",\\\"type\\\":2000,\\\"database\\\":\\\"74805\\\",\\\"cid\\\":\\\"1642734645\\\",\\\"collection\\\":{\\\"version\\\":5,\\\"type\\\":2,\\\"cid\\\":\\\"1642734645\\\",\\\"deleted\\\":false,\\\"doCompact\\\":true,\\\"maximalSize\\\":1048576,\\\"name\\\":\\\"products\\\",\\\"isVolatile\\\":false,\\\"waitForSync\\\":false}}\\n{\\\"tick\\\":\\\"1643127861\\\",\\\"type\\\":2300,\\\"database\\\":\\\"74805\\\",\\\"cid\\\":\\\"1642734645\\\",\\\"tid\\\":\\\"0\\\",\\\"key\\\":\\\"p1\\\",\\\"rev\\\":\\\"1643062325\\\",\\\"data\\\":{\\\"_key\\\":\\\"p1\\\",\\\"_rev\\\":\\\"1643062325\\\",\\\"name\\\":\\\"flux compensator\\\"}}\\n{\\\"tick\\\":\\\"1643455541\\\",\\\"type\\\":2300,\\\"database\\\":\\\"74805\\\",\\\"cid\\\":\\\"1642734645\\\",\\\"tid\\\":\\\"0\\\",\\\"key\\\":\\\"p2\\\",\\\"rev\\\":\\\"1643390005\\\",\\\"data\\\":{\\\"_key\\\":\\\"p2\\\",\\\"_rev\\\":\\\"1643390005\\\",\\\"hp\\\":5100,\\\"name\\\":\\\"hybrid hovercraft\\\"}}\\n{\\\"tick\\\":\\\"1643652149\\\",\\\"type\\\":2302,\\\"database\\\":\\\"74805\\\",\\\"cid\\\":\\\"1642734645\\\",\\\"tid\\\":\\\"0\\\",\\\"key\\\":\\\"p1\\\",\\\"rev\\\":\\\"1643586613\\\"}\\n{\\\"tick\\\":\\\"1643848757\\\",\\\"type\\\":2300,\\\"database\\\":\\\"74805\\\",\\\"cid\\\":\\\"1642734645\\\",\\\"tid\\\":\\\"0\\\",\\\"key\\\":\\\"p2\\\",\\\"rev\\\":\\\"1643783221\\\",\\\"data\\\":{\\\"_key\\\":\\\"p2\\\",\\\"_rev\\\":\\\"1643783221\\\"}}\\n{\\\"tick\\\":\\\"1643914293\\\",\\\"type\\\":2001,\\\"database\\\":\\\"74805\\\",\\\"cid\\\":\\\"1642734645\\\"}\\n\"\n
More events than would fit into the response:
shell> curl --dump - http://localhost:8529/_api/replication/logger-follow?from=1643914293&chunkSize=400\n\nHTTP/1.1 200 OK\ncontent-type: application/x-arango-dump; charset=utf-8\nx-arango-replication-active: true\nx-arango-replication-checkmore: true\nx-arango-replication-lastincluded: 1644438581\nx-arango-replication-lasttick: 1645225013\n\n\"{\\\"tick\\\":\\\"1644110901\\\",\\\"type\\\":2000,\\\"database\\\":\\\"74805\\\",\\\"cid\\\":\\\"1644045365\\\",\\\"collection\\\":{\\\"version\\\":5,\\\"type\\\":2,\\\"cid\\\":\\\"1644045365\\\",\\\"deleted\\\":false,\\\"doCompact\\\":true,\\\"maximalSize\\\":1048576,\\\"name\\\":\\\"products\\\",\\\"isVolatile\\\":false,\\\"waitForSync\\\":false}}\\n{\\\"tick\\\":\\\"1644438581\\\",\\\"type\\\":2300,\\\"database\\\":\\\"74805\\\",\\\"cid\\\":\\\"1644045365\\\",\\\"tid\\\":\\\"0\\\",\\\"key\\\":\\\"p1\\\",\\\"rev\\\":\\\"1644373045\\\",\\\"data\\\":{\\\"_key\\\":\\\"p1\\\",\\\"_rev\\\":\\\"1644373045\\\",\\\"name\\\":\\\"flux compensator\\\"}}\\n\"\n
",
"nickname": "ReturnsLogEntries"
}
],
"path": "/_api/replication/logger-follow"
},
{
"operations": [
{
"errorResponses": [
{
"reason": "is returned if the request was executed successfully.
",
"code": "200"
},
{
"reason": "is returned when an invalid HTTP method is used.
",
"code": "405"
},
{
"reason": "is returned if an error occurred while assembling the response.
",
"code": "500"
}
],
"parameters": [
{
"dataType": "Boolean",
"paramType": "query",
"required": false,
"name": "includeSystem",
"description": "Include system collections in the result. The default value is true.
"
}
],
"notes": "Returns the array of collections and indexes available on the server. This array can be used by replication clients to initiate an initial sync with the server.
The response will contain a JSON object with the collection and state and tick attributes.
collections is a array of collections with the following sub-attributes:
- parameters: the collection properties
- indexes: a array of the indexes of a the collection. Primary indexes and edges indexes are not included in this array.
The state attribute contains the current state of the replication logger. It contains the following sub-attributes:
- running: whether or not the replication logger is currently active. Note: since ArangoDB 2.2, the value will always be true
- lastLogTick: the value of the last tick the replication logger has written
- time: the current time on the server
Replication clients should note the lastLogTick value returned. They can then fetch collections' data using the dump method up to the value of lastLogTick, and query the continuous replication log for log events after this tick value.
To create a full copy of the collections on the server, a replication client can execute these steps:
- call the /inventory API method. This returns the lastLogTick value and the array of collections and indexes from the server.
- for each collection returned by /inventory, create the collection locally and call /dump to stream the collection data to the client, up to the value of lastLogTick. After that, the client can create the indexes on the collections as they were reported by /inventory.
If the clients wants to continuously stream replication log events from the logger server, the following additional steps need to be carried out:
- the client should call /logger-follow initially to fetch the first batch of replication events that were logged after the client's call to /inventory. The call to /logger-follow should use a from parameter with the value of the lastLogTick as reported by /inventory. The call to /logger-follow will return the x-arango-replication-lastincluded which will contain the last tick value included in the response.
- the client can then continuously call /logger-follow to incrementally fetch new replication events that occurred after the last transfer. Calls should use a from parameter with the value of the x-arango-replication-lastincluded header of the previous response. If there are no more replication events, the response will be empty and clients can go to sleep for a while and try again later.
Note: on a coordinator, this request must have the URL parameter DBserver which must be an ID of a DBserver. The very same request is forwarded synchronously to that DBserver. It is an error if this attribute is not bound in the coordinator case.
",
"summary": " Return inventory of collections and indexes",
"httpMethod": "GET",
"examples": "
shell> curl --dump - http://localhost:8529/_api/replication/inventory\n\nHTTP/1.1 200 OK\ncontent-type: application/json; charset=utf-8\n\n{ \n \"collections\" : [ \n { \n \"parameters\" : { \n \"version\" : 5, \n \"type\" : 2, \n \"cid\" : \"7152693\", \n \"deleted\" : false, \n \"doCompact\" : true, \n \"maximalSize\" : 1048576, \n \"name\" : \"_apps\", \n \"isVolatile\" : false, \n \"waitForSync\" : false \n }, \n \"indexes\" : [ \n { \n \"id\" : \"7414837\", \n \"type\" : \"hash\", \n \"unique\" : true, \n \"sparse\" : false, \n \"selectivityEstimate\" : 1, \n \"fields\" : [ \n \"mount\" \n ] \n } \n ] \n }, \n { \n \"parameters\" : { \n \"version\" : 5, \n \"type\" : 2, \n \"cid\" : \"4400181\", \n \"deleted\" : false, \n \"doCompact\" : true, \n \"maximalSize\" : 4194304, \n \"name\" : \"_aqlfunctions\", \n \"isVolatile\" : false, \n \"waitForSync\" : false \n }, \n \"indexes\" : [ ] \n }, \n { \n \"parameters\" : { \n \"version\" : 5, \n \"type\" : 2, \n \"cid\" : \"2040885\", \n \"deleted\" : false, \n \"doCompact\" : true, \n \"maximalSize\" : 1048576, \n \"name\" : \"_graphs\", \n \"isVolatile\" : false, \n \"waitForSync\" : false \n }, \n \"indexes\" : [ ] \n }, \n { \n \"parameters\" : { \n \"version\" : 5, \n \"type\" : 2, \n \"cid\" : \"2171957\", \n \"deleted\" : false, \n \"doCompact\" : true, \n \"maximalSize\" : 1048576, \n \"name\" : \"_modules\", \n \"isVolatile\" : false, \n \"waitForSync\" : false \n }, \n \"indexes\" : [ ] \n }, \n { \n \"parameters\" : { \n \"version\" : 5, \n \"type\" : 2, \n \"cid\" : \"2303029\", \n \"deleted\" : false, \n \"doCompact\" : true, \n \"maximalSize\" : 33554432, \n \"name\" : \"_routing\", \n \"isVolatile\" : false, \n \"waitForSync\" : false \n }, \n \"indexes\" : [ ] \n }, \n { \n \"parameters\" : { \n \"version\" : 5, \n \"type\" : 2, \n \"cid\" : \"19080245\", \n \"deleted\" : false, \n \"doCompact\" : true, \n \"maximalSize\" : 1048576, \n \"name\" : \"_sessions\", \n \"isVolatile\" : false, \n \"waitForSync\" : false \n }, \n \"indexes\" : [ ] \n }, \n { \n \"parameters\" : { \n \"version\" : 5, \n \"type\" : 2, \n \"cid\" : \"19801141\", \n \"deleted\" : false, \n \"doCompact\" : true, \n \"maximalSize\" : 1048576, \n \"name\" : \"_system_users_users\", \n \"isVolatile\" : false, \n \"waitForSync\" : false \n }, \n \"indexes\" : [ ] \n }, \n { \n \"parameters\" : { \n \"version\" : 5, \n \"type\" : 2, \n \"cid\" : \"205877\", \n \"deleted\" : false, \n \"doCompact\" : true, \n \"maximalSize\" : 4194304, \n \"name\" : \"_users\", \n \"isVolatile\" : false, \n \"waitForSync\" : false \n }, \n \"indexes\" : [ \n { \n \"id\" : \"533557\", \n \"type\" : \"hash\", \n \"unique\" : true, \n \"sparse\" : true, \n \"selectivityEstimate\" : 1, \n \"fields\" : [ \n \"user\" \n ] \n } \n ] \n }, \n { \n \"parameters\" : { \n \"version\" : 5, \n \"type\" : 2, \n \"cid\" : \"1244603445\", \n \"deleted\" : false, \n \"doCompact\" : true, \n \"maximalSize\" : 1048576, \n \"name\" : \"animals\", \n \"isVolatile\" : false, \n \"waitForSync\" : false \n }, \n \"indexes\" : [ ] \n }, \n { \n \"parameters\" : { \n \"version\" : 5, \n \"type\" : 2, \n \"cid\" : \"21046325\", \n \"deleted\" : false, \n \"doCompact\" : true, \n \"maximalSize\" : 1048576, \n \"name\" : \"collectable_foxx_data_firstCollection\", \n \"isVolatile\" : false, \n \"waitForSync\" : false \n }, \n \"indexes\" : [ ] \n }, \n { \n \"parameters\" : { \n \"version\" : 5, \n \"type\" : 2, \n \"cid\" : \"1243685941\", \n \"deleted\" : false, \n \"doCompact\" : true, \n \"maximalSize\" : 1048576, \n \"name\" : \"demo\", \n \"isVolatile\" : false, \n \"waitForSync\" : false \n }, \n \"indexes\" : [ ] \n }, \n { \n \"parameters\" : { \n \"version\" : 5, \n \"type\" : 2, \n \"cid\" : \"20915253\", \n \"deleted\" : false, \n \"doCompact\" : true, \n \"maximalSize\" : 1048576, \n \"name\" : \"tescht_todos\", \n \"isVolatile\" : false, \n \"waitForSync\" : false \n }, \n \"indexes\" : [ ] \n } \n ], \n \"state\" : { \n \"running\" : true, \n \"lastLogTick\" : \"1645225013\", \n \"totalEvents\" : 9981, \n \"time\" : \"2015-05-05T07:28:48Z\" \n }, \n \"tick\" : \"1645290549\" \n}\n
With some additional indexes:
shell> curl --dump - http://localhost:8529/_api/replication/inventory\n\nHTTP/1.1 200 OK\ncontent-type: application/json; charset=utf-8\n\n{ \n \"collections\" : [ \n { \n \"parameters\" : { \n \"version\" : 5, \n \"type\" : 2, \n \"cid\" : \"7152693\", \n \"deleted\" : false, \n \"doCompact\" : true, \n \"maximalSize\" : 1048576, \n \"name\" : \"_apps\", \n \"isVolatile\" : false, \n \"waitForSync\" : false \n }, \n \"indexes\" : [ \n { \n \"id\" : \"7414837\", \n \"type\" : \"hash\", \n \"unique\" : true, \n \"sparse\" : false, \n \"selectivityEstimate\" : 1, \n \"fields\" : [ \n \"mount\" \n ] \n } \n ] \n }, \n { \n \"parameters\" : { \n \"version\" : 5, \n \"type\" : 2, \n \"cid\" : \"4400181\", \n \"deleted\" : false, \n \"doCompact\" : true, \n \"maximalSize\" : 4194304, \n \"name\" : \"_aqlfunctions\", \n \"isVolatile\" : false, \n \"waitForSync\" : false \n }, \n \"indexes\" : [ ] \n }, \n { \n \"parameters\" : { \n \"version\" : 5, \n \"type\" : 2, \n \"cid\" : \"2040885\", \n \"deleted\" : false, \n \"doCompact\" : true, \n \"maximalSize\" : 1048576, \n \"name\" : \"_graphs\", \n \"isVolatile\" : false, \n \"waitForSync\" : false \n }, \n \"indexes\" : [ ] \n }, \n { \n \"parameters\" : { \n \"version\" : 5, \n \"type\" : 2, \n \"cid\" : \"2171957\", \n \"deleted\" : false, \n \"doCompact\" : true, \n \"maximalSize\" : 1048576, \n \"name\" : \"_modules\", \n \"isVolatile\" : false, \n \"waitForSync\" : false \n }, \n \"indexes\" : [ ] \n }, \n { \n \"parameters\" : { \n \"version\" : 5, \n \"type\" : 2, \n \"cid\" : \"2303029\", \n \"deleted\" : false, \n \"doCompact\" : true, \n \"maximalSize\" : 33554432, \n \"name\" : \"_routing\", \n \"isVolatile\" : false, \n \"waitForSync\" : false \n }, \n \"indexes\" : [ ] \n }, \n { \n \"parameters\" : { \n \"version\" : 5, \n \"type\" : 2, \n \"cid\" : \"19080245\", \n \"deleted\" : false, \n \"doCompact\" : true, \n \"maximalSize\" : 1048576, \n \"name\" : \"_sessions\", \n \"isVolatile\" : false, \n \"waitForSync\" : false \n }, \n \"indexes\" : [ ] \n }, \n { \n \"parameters\" : { \n \"version\" : 5, \n \"type\" : 2, \n \"cid\" : \"19801141\", \n \"deleted\" : false, \n \"doCompact\" : true, \n \"maximalSize\" : 1048576, \n \"name\" : \"_system_users_users\", \n \"isVolatile\" : false, \n \"waitForSync\" : false \n }, \n \"indexes\" : [ ] \n }, \n { \n \"parameters\" : { \n \"version\" : 5, \n \"type\" : 2, \n \"cid\" : \"205877\", \n \"deleted\" : false, \n \"doCompact\" : true, \n \"maximalSize\" : 4194304, \n \"name\" : \"_users\", \n \"isVolatile\" : false, \n \"waitForSync\" : false \n }, \n \"indexes\" : [ \n { \n \"id\" : \"533557\", \n \"type\" : \"hash\", \n \"unique\" : true, \n \"sparse\" : true, \n \"selectivityEstimate\" : 1, \n \"fields\" : [ \n \"user\" \n ] \n } \n ] \n }, \n { \n \"parameters\" : { \n \"version\" : 5, \n \"type\" : 2, \n \"cid\" : \"1244603445\", \n \"deleted\" : false, \n \"doCompact\" : true, \n \"maximalSize\" : 1048576, \n \"name\" : \"animals\", \n \"isVolatile\" : false, \n \"waitForSync\" : false \n }, \n \"indexes\" : [ ] \n }, \n { \n \"parameters\" : { \n \"version\" : 5, \n \"type\" : 2, \n \"cid\" : \"21046325\", \n \"deleted\" : false, \n \"doCompact\" : true, \n \"maximalSize\" : 1048576, \n \"name\" : \"collectable_foxx_data_firstCollection\", \n \"isVolatile\" : false, \n \"waitForSync\" : false \n }, \n \"indexes\" : [ ] \n }, \n { \n \"parameters\" : { \n \"version\" : 5, \n \"type\" : 2, \n \"cid\" : \"1243685941\", \n \"deleted\" : false, \n \"doCompact\" : true, \n \"maximalSize\" : 1048576, \n \"name\" : \"demo\", \n \"isVolatile\" : false, \n \"waitForSync\" : false \n }, \n \"indexes\" : [ ] \n }, \n { \n \"parameters\" : { \n \"version\" : 5, \n \"type\" : 2, \n \"cid\" : \"1645356085\", \n \"deleted\" : false, \n \"doCompact\" : true, \n \"maximalSize\" : 1048576, \n \"name\" : \"IndexedCollection1\", \n \"isVolatile\" : false, \n \"waitForSync\" : false \n }, \n \"indexes\" : [ \n { \n \"id\" : \"1645618229\", \n \"type\" : \"hash\", \n \"unique\" : false, \n \"sparse\" : false, \n \"selectivityEstimate\" : 1, \n \"fields\" : [ \n \"name\" \n ] \n }, \n { \n \"id\" : \"1645945909\", \n \"type\" : \"skiplist\", \n \"unique\" : true, \n \"sparse\" : false, \n \"fields\" : [ \n \"a\", \n \"b\" \n ] \n }, \n { \n \"id\" : \"1646142517\", \n \"type\" : \"cap\", \n \"unique\" : false, \n \"size\" : 500, \n \"byteSize\" : 0 \n } \n ] \n }, \n { \n \"parameters\" : { \n \"version\" : 5, \n \"type\" : 2, \n \"cid\" : \"1646339125\", \n \"deleted\" : false, \n \"doCompact\" : true, \n \"maximalSize\" : 1048576, \n \"name\" : \"IndexedCollection2\", \n \"isVolatile\" : false, \n \"waitForSync\" : false \n }, \n \"indexes\" : [ \n { \n \"id\" : \"1646601269\", \n \"type\" : \"fulltext\", \n \"unique\" : false, \n \"sparse\" : true, \n \"minLength\" : 10, \n \"fields\" : [ \n \"text\" \n ] \n }, \n { \n \"id\" : \"1646863413\", \n \"type\" : \"skiplist\", \n \"unique\" : false, \n \"sparse\" : false, \n \"fields\" : [ \n \"a\" \n ] \n }, \n { \n \"id\" : \"1647060021\", \n \"type\" : \"cap\", \n \"unique\" : false, \n \"size\" : 0, \n \"byteSize\" : 1048576 \n } \n ] \n }, \n { \n \"parameters\" : { \n \"version\" : 5, \n \"type\" : 2, \n \"cid\" : \"20915253\", \n \"deleted\" : false, \n \"doCompact\" : true, \n \"maximalSize\" : 1048576, \n \"name\" : \"tescht_todos\", \n \"isVolatile\" : false, \n \"waitForSync\" : false \n }, \n \"indexes\" : [ ] \n } \n ], \n \"state\" : { \n \"running\" : true, \n \"lastLogTick\" : \"1645225013\", \n \"totalEvents\" : 9994, \n \"time\" : \"2015-05-05T07:28:48Z\" \n }, \n \"tick\" : \"1647191093\" \n}\n
",
"nickname": "ReturnInventoryOfCollectionsAndIndexes"
}
],
"path": "/_api/replication/inventory"
},
{
"operations": [
{
"errorResponses": [
{
"reason": "is returned if the request was executed successfully.
",
"code": "200"
},
{
"reason": "is returned when an invalid HTTP method is used.
",
"code": "405"
},
{
"reason": "is returned if an error occurred while assembling the response.
",
"code": "500"
}
],
"parameters": [
{
"dataType": "Boolean",
"paramType": "query",
"required": false,
"name": "includeSystem",
"description": "Include system collections in the result. The default value is true.
"
}
],
"notes": "Returns the array of collections and indexes available on the cluster.
The response will be an array of JSON objects, one for each collection. Each collection containscontains exactly two keys \"parameters\" and \"indexes\". This information comes from Plan/Collections//* in the agency, just that the indexes attribute there is relocated to adjust it to the data format of arangodump.
",
"summary": " Return cluster inventory of collections and indexes",
"httpMethod": "GET",
"examples": "",
"nickname": "ReturnClusterInventoryOfCollectionsAndIndexes"
}
],
"path": "/_api/replication/clusterInventory"
},
{
"operations": [
{
"errorResponses": [
{
"reason": "is returned if the request was executed successfully and data was returned. The header x-arango-replication-lastincluded is set to the tick of the last document returned.
",
"code": "200"
},
{
"reason": "is returned if the request was executed successfully, but there was no content available. The header x-arango-replication-lastincluded is 0 in this case.
",
"code": "204"
},
{
"reason": "is returned if either the from or to values are invalid.
",
"code": "400"
},
{
"reason": "is returned when the collection could not be found.
",
"code": "404"
},
{
"reason": "is returned when an invalid HTTP method is used.
",
"code": "405"
},
{
"reason": "is returned if an error occurred while assembling the response.
",
"code": "500"
}
],
"parameters": [
{
"dataType": "String",
"paramType": "query",
"required": true,
"name": "collection",
"description": "The name or id of the collection to dump.
"
},
{
"dataType": "Number",
"paramType": "query",
"required": false,
"name": "from",
"description": "Lower bound tick value for results.
"
},
{
"dataType": "Number",
"paramType": "query",
"required": false,
"name": "to",
"description": "Upper bound tick value for results.
"
},
{
"dataType": "Number",
"paramType": "query",
"required": false,
"name": "chunkSize",
"description": "Approximate maximum size of the returned result.
"
},
{
"dataType": "Boolean",
"paramType": "query",
"required": false,
"name": "includeSystem",
"description": "Include system collections in the result. The default value is true.
"
},
{
"dataType": "Boolean",
"paramType": "query",
"required": false,
"name": "ticks",
"description": "Whether or not to include tick values in the dump. Default value is true.
"
}
],
"notes": "Returns the data from the collection for the requested range.
When the from URL parameter is not used, collection events are returned from the beginning. When the from parameter is used, the result will only contain collection entries which have higher tick values than the specified from value (note: the log entry with a tick value equal to from will be excluded).
The to URL parameter can be used to optionally restrict the upper bound of the result to a certain tick value. If used, the result will only contain collection entries with tick values up to (including) to.
The chunkSize URL parameter can be used to control the size of the result. It must be specified in bytes. The chunkSize value will only be honored approximately. Otherwise a too low chunkSize value could cause the server to not be able to put just one entry into the result and return it. Therefore, the chunkSize value will only be consulted after an entry has been written into the result. If the result size is then bigger than chunkSize, the server will respond with as many entries as there are in the response already. If the result size is still smaller than chunkSize, the server will try to return more data if there's more data left to return.
If chunkSize is not specified, some server-side default value will be used.
The Content-Type of the result is application/x-arango-dump. This is an easy-to-process format, with all entries going onto separate lines in the response body.
Each line itself is a JSON object, with at least the following attributes:
- tick: the operation's tick attribute
- key: the key of the document/edge or the key used in the deletion operation
- rev: the revision id of the document/edge or the deletion operation
- data: the actual document/edge data for types 2300 and 2301. The full document/edge data will be returned even for updates.
- type: the type of entry. Possible values for type are: - 2300: document insertion/update - 2301: edge insertion/update - 2302: document/edge deletion
Note: there will be no distinction between inserts and updates when calling this method.
",
"summary": " Return data of a collection",
"httpMethod": "GET",
"examples": "
Empty collection:
shell> curl --dump - http://localhost:8529/_api/replication/dump?collection=testCollection\n\nHTTP/1.1 204 No Content\ncontent-type: application/x-arango-dump; charset=utf-8\nx-arango-replication-checkmore: false\nx-arango-replication-lastincluded: 0\n\n
Non-empty collection:
shell> curl --dump - http://localhost:8529/_api/replication/dump?collection=testCollection\n\nHTTP/1.1 200 OK\ncontent-type: application/x-arango-dump; charset=utf-8\nx-arango-replication-checkmore: false\nx-arango-replication-lastincluded: 1649681461\n\n\"{\\\"tick\\\":\\\"1649026101\\\",\\\"type\\\":2300,\\\"key\\\":\\\"123456\\\",\\\"rev\\\":\\\"1648960565\\\",\\\"data\\\":{\\\"_key\\\":\\\"123456\\\",\\\"_rev\\\":\\\"1648960565\\\",\\\"c\\\":false,\\\"b\\\":1,\\\"d\\\":\\\"additional value\\\"}}\\n{\\\"tick\\\":\\\"1649484853\\\",\\\"type\\\":2302,\\\"key\\\":\\\"foobar\\\",\\\"rev\\\":\\\"1649419317\\\"}\\n{\\\"tick\\\":\\\"1649681461\\\",\\\"type\\\":2302,\\\"key\\\":\\\"abcdef\\\",\\\"rev\\\":\\\"1649615925\\\"}\\n\"\n
",
"nickname": "ReturnDataOfACollection"
}
],
"path": "/_api/replication/dump"
},
{
"operations": [
{
"errorResponses": [
{
"reason": "is returned if the request was executed successfully.
",
"code": "200"
},
{
"reason": "is returned if the configuration is incomplete or malformed.
",
"code": "400"
},
{
"reason": "is returned when an invalid HTTP method is used.
",
"code": "405"
},
{
"reason": "is returned if an error occurred during sychronisation.
",
"code": "500"
},
{
"reason": "is returned when this operation is called on a coordinator in a cluster.
",
"code": "501"
}
],
"parameters": [
{
"dataType": "Json",
"paramType": "body",
"required": true,
"name": "configuration",
"description": "A JSON representation of the configuration.
"
}
],
"notes": "Starts a full data synchronization from a remote endpoint into the local ArangoDB database.
The sync method can be used by replication clients to connect an ArangoDB database to a remote endpoint, fetch the remote list of collections and indexes, and collection data. It will thus create a local backup of the state of data at the remote ArangoDB database. sync works on a per-database level.
sync will first fetch the list of collections and indexes from the remote endpoint. It does so by calling the inventory API of the remote database. It will then purge data in the local ArangoDB database, and after start will transfer collection data from the remote database to the local ArangoDB database. It will extract data from the remote database by calling the remote database's dump API until all data are fetched.
The body of the request must be JSON object with the configuration. The following attributes are allowed for the configuration:
- endpoint: the endpoint to connect to (e.g. \"tcp://192.168.173.13:8529\").
- database: the database name on the master (if not specified, defaults to the name of the local current database).
- username: an optional ArangoDB username to use when connecting to the endpoint.
- password: the password to use when connecting to the endpoint.
- includeSystem: whether or not system collection operations will be applied
- restrictType: an optional string value for collection filtering. When specified, the allowed values are include or exclude.
- restrictCollections: an optional array of collections for use with restrictType. If restrictType is include, only the specified collections will be sychronised. If restrictType is exclude, all but the specified collections will be synchronized.
In case of success, the body of the response is a JSON object with the following attributes:
- collections: an array of collections that were transferred from the endpoint
- lastLogTick: the last log tick on the endpoint at the time the transfer was started. Use this value as the from value when starting the continuous synchronization later.
WARNING: calling this method will sychronise data from the collections found on the remote endpoint to the local ArangoDB database. All data in the local collections will be purged and replaced with data from the endpoint.
Use with caution!
Note: this method is not supported on a coordinator in a cluster.
",
"summary": " Synchronize data from a remote endpoint",
"httpMethod": "PUT",
"examples": "",
"nickname": "SynchronizeDataFromARemoteEndpoint"
}
],
"path": "/_api/replication/sync"
},
{
"operations": [
{
"errorResponses": [
{
"reason": "is returned if the request was executed successfully.
",
"code": "200"
},
{
"reason": "is returned when an invalid HTTP method is used.
",
"code": "405"
},
{
"reason": "is returned if an error occurred while assembling the response.
",
"code": "500"
}
],
"parameters": [],
"notes": "Returns the servers id. The id is also returned by other replication API methods, and this method is an easy means of determining a server's id.
The body of the response is a JSON object with the attribute serverId. The server id is returned as a string.
",
"summary": " Return server id",
"httpMethod": "GET",
"examples": "
shell> curl --dump - http://localhost:8529/_api/replication/server-id\n\nHTTP/1.1 200 OK\ncontent-type: application/json; charset=utf-8\n\n{ \n \"serverId\" : \"39957130875700\" \n}\n
",
"nickname": "ReturnServerId"
}
],
"path": "/_api/replication/server-id"
},
{
"operations": [
{
"errorResponses": [
{
"reason": "is returned if the request was executed successfully.
",
"code": "200"
},
{
"reason": "is returned when an invalid HTTP method is used.
",
"code": "405"
},
{
"reason": "is returned if an error occurred while assembling the response.
",
"code": "500"
}
],
"parameters": [],
"notes": "Returns the configuration of the replication applier.
The body of the response is a JSON object with the configuration. The following attributes may be present in the configuration:
- endpoint: the logger server to connect to (e.g. \"tcp://192.168.173.13:8529\").
- database: the name of the database to connect to (e.g. \"_system\").
- username: an optional ArangoDB username to use when connecting to the endpoint.
- password: the password to use when connecting to the endpoint.
- maxConnectRetries: the maximum number of connection attempts the applier will make in a row. If the applier cannot establish a connection to the endpoint in this number of attempts, it will stop itself.
- connectTimeout: the timeout (in seconds) when attempting to connect to the endpoint. This value is used for each connection attempt.
- requestTimeout: the timeout (in seconds) for individual requests to the endpoint.
- chunkSize: the requested maximum size for log transfer packets that is used when the endpoint is contacted.
- autoStart: whether or not to auto-start the replication applier on (next and following) server starts
- adaptivePolling: whether or not the replication applier will use adaptive polling.
- includeSystem: whether or not system collection operations will be applied
- restrictType: the configuration for restrictCollections
- restrictCollections: the optional array of collections to include or exclude, based on the setting of restrictType",
"summary": " Return configuration of replication applier",
"httpMethod": "GET",
"examples": "
shell> curl --dump - http://localhost:8529/_api/replication/applier-config\n\nHTTP/1.1 200 OK\ncontent-type: application/json; charset=utf-8\n\n{ \n \"requestTimeout\" : 300, \n \"connectTimeout\" : 10, \n \"ignoreErrors\" : 0, \n \"maxConnectRetries\" : 100, \n \"sslProtocol\" : 0, \n \"chunkSize\" : 0, \n \"autoStart\" : false, \n \"adaptivePolling\" : true, \n \"includeSystem\" : true, \n \"restrictType\" : \"\", \n \"restrictCollections\" : [ ] \n}\n
",
"nickname": "ReturnConfigurationOfReplicationApplier"
}
],
"path": "/_api/replication/applier-config"
},
{
"operations": [
{
"errorResponses": [
{
"reason": "is returned if the request was executed successfully.
",
"code": "200"
},
{
"reason": "is returned if the configuration is incomplete or malformed, or if the replication applier is currently running.
",
"code": "400"
},
{
"reason": "is returned when an invalid HTTP method is used.
",
"code": "405"
},
{
"reason": "is returned if an error occurred while assembling the response.
",
"code": "500"
}
],
"parameters": [
{
"dataType": "Json",
"paramType": "body",
"required": true,
"name": "configuration",
"description": "A JSON representation of the configuration.
"
}
],
"notes": "Sets the configuration of the replication applier. The configuration can only be changed while the applier is not running. The updated configuration will be saved immediately but only become active with the next start of the applier.
The body of the request must be JSON object with the configuration. The following attributes are allowed for the configuration:
- endpoint: the logger server to connect to (e.g. \"tcp://192.168.173.13:8529\"). The endpoint must be specified.
- database: the name of the database on the endpoint. If not specified, defaults to the current local database name.
- username: an optional ArangoDB username to use when connecting to the endpoint.
- password: the password to use when connecting to the endpoint.
- maxConnectRetries: the maximum number of connection attempts the applier will make in a row. If the applier cannot establish a connection to the endpoint in this number of attempts, it will stop itself.
- connectTimeout: the timeout (in seconds) when attempting to connect to the endpoint. This value is used for each connection attempt.
- requestTimeout: the timeout (in seconds) for individual requests to the endpoint.
- chunkSize: the requested maximum size for log transfer packets that is used when the endpoint is contacted.
- autoStart: whether or not to auto-start the replication applier on (next and following) server starts
- adaptivePolling: if set to true, the replication applier will fall to sleep for an increasingly long period in case the logger server at the endpoint does not have any more replication events to apply. Using adaptive polling is thus useful to reduce the amount of work for both the applier and the logger server for cases when there are only infrequent changes. The downside is that when using adaptive polling, it might take longer for the replication applier to detect that there are new replication events on the logger server. Setting adaptivePolling to false will make the replication applier contact the logger server in a constant interval, regardless of whether the logger server provides updates frequently or seldomly.
- includeSystem: whether or not system collection operations will be applied
- restrictType: the configuration for restrictCollections
- restrictCollections: the optional array of collections to include or exclude, based on the setting of restrictType
In case of success, the body of the response is a JSON object with the updated configuration.
",
"summary": " Adjust configuration of replication applier",
"httpMethod": "PUT",
"examples": "
shell> curl -X PUT --data-binary @- --dump - http://localhost:8529/_api/replication/applier-config <<EOF\n{\"endpoint\":\"tcp://127.0.0.1:8529\",\"username\":\"replicationApplier\",\"password\":\"applier1234@foxx\",\"chunkSize\":4194304,\"autoStart\":false,\"adaptivePolling\":true}\nEOF\n\nHTTP/1.1 200 OK\ncontent-type: application/json; charset=utf-8\n\n{ \n \"endpoint\" : \"tcp://127.0.0.1:8529\", \n \"database\" : \"_system\", \n \"username\" : \"replicationApplier\", \n \"requestTimeout\" : 300, \n \"connectTimeout\" : 10, \n \"ignoreErrors\" : 0, \n \"maxConnectRetries\" : 100, \n \"sslProtocol\" : 0, \n \"chunkSize\" : 4194304, \n \"autoStart\" : false, \n \"adaptivePolling\" : true, \n \"includeSystem\" : true, \n \"restrictType\" : \"\", \n \"restrictCollections\" : [ ] \n}\n
",
"nickname": "AdjustConfigurationOfReplicationApplier"
}
],
"path": "/_api/replication/applier-config"
},
{
"operations": [
{
"errorResponses": [
{
"reason": "is returned if the request was executed successfully.
",
"code": "200"
},
{
"reason": "is returned if the replication applier is not fully configured or the configuration is invalid.
",
"code": "400"
},
{
"reason": "is returned when an invalid HTTP method is used.
",
"code": "405"
},
{
"reason": "is returned if an error occurred while assembling the response.
",
"code": "500"
}
],
"parameters": [
{
"dataType": "String",
"paramType": "query",
"required": false,
"name": "from",
"description": "The remote lastLogTick value from which to start applying. If not specified, the last saved tick from the previous applier run is used. If there is no previous applier state saved, the applier will start at the beginning of the logger server's log.
"
}
],
"notes": "Starts the replication applier. This will return immediately if the replication applier is already running.
If the replication applier is not already running, the applier configuration will be checked, and if it is complete, the applier will be started in a background thread. This means that even if the applier will encounter any errors while running, they will not be reported in the response to this method.
To detect replication applier errors after the applier was started, use the /_api/replication/applier-state API instead.
",
"summary": " Start replication applier",
"httpMethod": "PUT",
"examples": "
shell> curl -X PUT --dump - http://localhost:8529/_api/replication/applier-start\n\nHTTP/1.1 200 OK\ncontent-type: application/json; charset=utf-8\n\n{ \n \"state\" : { \n \"running\" : true, \n \"lastAppliedContinuousTick\" : null, \n \"lastProcessedContinuousTick\" : null, \n \"lastAvailableContinuousTick\" : null, \n \"progress\" : { \n \"time\" : \"2015-05-05T07:28:19Z\", \n \"message\" : \"applier created\", \n \"failedConnects\" : 0 \n }, \n \"totalRequests\" : 0, \n \"totalFailedConnects\" : 0, \n \"totalEvents\" : 0, \n \"totalOperationsExcluded\" : 0, \n \"lastError\" : { \n \"errorNum\" : 0 \n }, \n \"time\" : \"2015-05-05T07:28:51Z\" \n }, \n \"server\" : { \n \"version\" : \"2.6.0-devel\", \n \"serverId\" : \"39957130875700\" \n }, \n \"endpoint\" : \"tcp://127.0.0.1:8529\", \n \"database\" : \"_system\" \n}\n
",
"nickname": "StartReplicationApplier"
}
],
"path": "/_api/replication/applier-start"
},
{
"operations": [
{
"errorResponses": [
{
"reason": "is returned if the request was executed successfully.
",
"code": "200"
},
{
"reason": "is returned when an invalid HTTP method is used.
",
"code": "405"
},
{
"reason": "is returned if an error occurred while assembling the response.
",
"code": "500"
}
],
"parameters": [],
"notes": "Stops the replication applier. This will return immediately if the replication applier is not running.
",
"summary": " Stop replication applier",
"httpMethod": "PUT",
"examples": "
shell> curl -X PUT --dump - http://localhost:8529/_api/replication/applier-stop\n\nHTTP/1.1 200 OK\ncontent-type: application/json; charset=utf-8\n\n{ \n \"state\" : { \n \"running\" : false, \n \"lastAppliedContinuousTick\" : null, \n \"lastProcessedContinuousTick\" : null, \n \"lastAvailableContinuousTick\" : null, \n \"progress\" : { \n \"time\" : \"2015-05-05T07:28:51Z\", \n \"message\" : \"applier shut down\", \n \"failedConnects\" : 0 \n }, \n \"totalRequests\" : 2, \n \"totalFailedConnects\" : 0, \n \"totalEvents\" : 0, \n \"totalOperationsExcluded\" : 0, \n \"lastError\" : { \n \"errorNum\" : 0 \n }, \n \"time\" : \"2015-05-05T07:28:51Z\" \n }, \n \"server\" : { \n \"version\" : \"2.6.0-devel\", \n \"serverId\" : \"39957130875700\" \n }, \n \"endpoint\" : \"tcp://127.0.0.1:8529\", \n \"database\" : \"_system\" \n}\n
",
"nickname": "StopReplicationApplier"
}
],
"path": "/_api/replication/applier-stop"
},
{
"operations": [
{
"errorResponses": [
{
"reason": "is returned if the request was executed successfully.
",
"code": "200"
},
{
"reason": "is returned when an invalid HTTP method is used.
",
"code": "405"
},
{
"reason": "is returned if an error occurred while assembling the response.
",
"code": "500"
}
],
"parameters": [],
"notes": "Returns the state of the replication applier, regardless of whether the applier is currently running or not.
The response is a JSON object with the following attributes:
- state: a JSON object with the following sub-attributes: - running: whether or not the applier is active and running - lastAppliedContinuousTick: the last tick value from the continuous replication log the applier has applied. - lastProcessedContinuousTick: the last tick value from the continuous replication log the applier has processed. Regularly, the last applied and last processed tick values should be identical. For transactional operations, the replication applier will first process incoming log events before applying them, so the processed tick value might be higher than the applied tick value. This will be the case until the applier encounters the transaction commit log event for the transaction. - lastAvailableContinuousTick: the last tick value the logger server can provide. - time: the time on the applier server. - totalRequests: the total number of requests the applier has made to the endpoint. - totalFailedConnects: the total number of failed connection attempts the applier has made. - totalEvents: the total number of log events the applier has processed. - totalOperationsExcluded: the total number of log events excluded because of restrictCollections. - progress: a JSON object with details about the replication applier progress. It contains the following sub-attributes if there is progress to report: - message: a textual description of the progress - time: the date and time the progress was logged - failedConnects: the current number of failed connection attempts - lastError: a JSON object with details about the last error that happened on the applier. It contains the following sub-attributes if there was an error: - errorNum: a numerical error code - errorMessage: a textual error description - time: the date and time the error occurred In case no error has occurred, lastError will be empty.
- server: a JSON object with the following sub-attributes: - version: the applier server's version - serverId: the applier server's id
- endpoint: the endpoint the applier is connected to (if applier is active) or will connect to (if applier is currently inactive)
- database: the name of the database the applier is connected to (if applier is active) or will connect to (if applier is currently inactive)",
"summary": " State of the replication applier",
"httpMethod": "GET",
"examples": "
Fetching the state of an inactive applier:
shell> curl --dump - http://localhost:8529/_api/replication/applier-state\n\nHTTP/1.1 200 OK\ncontent-type: application/json; charset=utf-8\n\n{ \n \"state\" : { \n \"running\" : false, \n \"lastAppliedContinuousTick\" : null, \n \"lastProcessedContinuousTick\" : null, \n \"lastAvailableContinuousTick\" : null, \n \"progress\" : { \n \"time\" : \"2015-05-05T07:28:51Z\", \n \"message\" : \"applier shut down\", \n \"failedConnects\" : 0 \n }, \n \"totalRequests\" : 2, \n \"totalFailedConnects\" : 0, \n \"totalEvents\" : 0, \n \"totalOperationsExcluded\" : 0, \n \"lastError\" : { \n \"errorNum\" : 0 \n }, \n \"time\" : \"2015-05-05T07:28:51Z\" \n }, \n \"server\" : { \n \"version\" : \"2.6.0-devel\", \n \"serverId\" : \"39957130875700\" \n }, \n \"endpoint\" : \"tcp://127.0.0.1:8529\", \n \"database\" : \"_system\" \n}\n
Fetching the state of an active applier:
shell> curl --dump - http://localhost:8529/_api/replication/applier-state\n\nHTTP/1.1 200 OK\ncontent-type: application/json; charset=utf-8\n\n{ \n \"state\" : { \n \"running\" : false, \n \"lastAppliedContinuousTick\" : null, \n \"lastProcessedContinuousTick\" : null, \n \"lastAvailableContinuousTick\" : null, \n \"progress\" : { \n \"time\" : \"2015-05-05T07:28:51Z\", \n \"message\" : \"applier shut down\", \n \"failedConnects\" : 0 \n }, \n \"totalRequests\" : 3, \n \"totalFailedConnects\" : 0, \n \"totalEvents\" : 0, \n \"totalOperationsExcluded\" : 0, \n \"lastError\" : { \n \"errorNum\" : 0 \n }, \n \"time\" : \"2015-05-05T07:28:51Z\" \n }, \n \"server\" : { \n \"version\" : \"2.6.0-devel\", \n \"serverId\" : \"39957130875700\" \n }, \n \"endpoint\" : \"tcp://127.0.0.1:8529\", \n \"database\" : \"_system\" \n}\n
",
"nickname": "StateOfTheReplicationApplier"
}
],
"path": "/_api/replication/applier-state"
}
]
}