Update
patch
/services/{version}/datastore
Required Role: Administrator
Change the datastore configuration used by the Performance Metrics Service. Changes to the datastore configuration will cause the Performance Metrics Service to restart.
Request
Supported Media Types
- application/json
Path Parameters
-
version(required): string
Oracle GoldenGate Service API version.
Allowed Values:[ "v2" ]
Root Schema : Oracle GoldenGate Performance Metrics Service Data Store
Type:
object
Title:
Show Source
Oracle GoldenGate Performance Metrics Service Data Store
-
$schema:
Allowed Values:
[ "monitoring:datastore" ]
-
collectorWorkerQueueLimit:
integer
Minimum Value:
5000
Maximum Value:50000
Default Value:10000
Mpoint Collector Queue max size -
collectorWorkerThreads:
integer
Minimum Value:
3
Maximum Value:25
Default Value:5
Mpoint Collector Number of Worker Threads -
dataStoreMaxDBs:
integer
Minimum Value:
5000
Maximum Value:10000
Default Value:5000
Max Databases -
monitorHeartBeatTimeout:
integer
Minimum Value:
5
Maximum Value:60
Default Value:10
Process monitoring heartbeat timeout in seconds -
path:
string
Minimum Length:
1
Maximum Length:4096
The path for the datastore storage. If not set, the datastore will be created in a default directory. -
reinitialize:
boolean
If set to true, the datastore will be reinitialized upon restart.
-
repair:
boolean
If set to true, the datastore will be repaired upon restart.
-
retentionDays:
integer
Minimum Value:
0
Maximum Value:365
Default Value:0
The number of days to retain performance metrics data. If zero, data will be retained indefinitely. -
type(required):
Default Value:
BDB
Allowed Values:[ "BDB", "LMDB" ]
The type of datastore storage, either Berkeley Database (BDB) or Lightning Memory-Mapped Database (LMDB).
Example Request (application/json)
{
"type":"LMDB",
"retentionDays":"30",
"collectorWorkerThreads":"5",
"collectorWorkerQueueLimit":"10000",
"monitorHeartBeatTimeout":"10",
"dataStoreMaxDBs":"5000"
}
Response
Supported Media Types
- application/json
200 Response
Datastore successfully updated.
Root Schema : RESTful API Standard Response
Type:
object
Title:
RESTful API Standard Response
Standard Response for all Oracle GoldenGate RESTful API calls
Show Source
-
$schema:
Allowed Values:
[ "api:standardResponse" ]
-
links(required):
array links
Minimum Number of Items:
0
Maximum Number of Items:16
Oracle GoldenGate links for the request -
messages(required):
array messages
Minimum Number of Items:
0
Maximum Number of Items:65535
Oracle GoldenGate messages issued during the request -
response:
object response
Oracle GoldenGate document from the request
Nested Schema : links
Type:
array
Minimum Number of Items:
0
Maximum Number of Items:
16
Oracle GoldenGate links for the request
Show Source
Nested Schema : messages
Type:
array
Minimum Number of Items:
0
Maximum Number of Items:
65535
Oracle GoldenGate messages issued during the request
Show Source
Nested Schema : response
Type:
object
Oracle GoldenGate document from the request
Nested Schema : items
Type:
Show Source
object
-
$schema:
Allowed Values:
[ "ogg:link" ]
-
description:
string
Minimum Length:
1
Maximum Length:4095
A human-readable description that provides information and detail specific to this link. -
href(required):
string
Minimum Length:
2
Maximum Length:4095
Pattern:^[a-zA-Z][a-zA-Z0-9+-.]*:[^ \t]*$
An absolute URI for the link -
mediaType:
string
Minimum Length:
6
Maximum Length:255
Pattern:^(text|application)/[a-zA-Z0-9!#$&.+-^_]+$
Media type - see RFC 4288 (https://tools.ietf.org/html/rfc4288) -
rel(required):
Allowed Values:
[ "alternate", "canonical", "current", "describedby", "describes", "enclosure", "parent", "related", "self", "first", "last", "next", "previous", "ogg://service" ]
Relationship of href to the requested link
Nested Schema : items
Type:
Show Source
object
-
$schema:
Allowed Values:
[ "ogg:message" ]
-
code(required):
string
Minimum Length:
9
Maximum Length:9
Pattern:^OGG[-][0-9]{5}$
The Oracle GoldenGate message code -
issued(required):
string
Minimum Length:
20
Maximum Length:32
Pattern:^[0-9]{4}[-](0[1-9]|1[0-2])[-](0[1-9]|[12][0-9]|3[01])[tT ]([01][0-9]|2[0-3]):[0-5][0-9]:([0-5][0-9]|60)([.][0-9]{1,6})?([zZ]|[+-][0-9][0-9]:[0-5][0-9])$
The date and time that the message was issued -
severity(required):
Allowed Values:
[ "INFO", "WARNING", "ERROR" ]
The severity of the message -
title(required):
string
Minimum Length:
1
Maximum Length:4095
A human-readable description that provides information and detail specific to this occurence of the information, warning or error. -
type(required):
string
Minimum Length:
2
Maximum Length:4095
Pattern:^[a-zA-Z][a-zA-Z0-9+-.]*:[^ \t]*$
An absolute URI [RFC3986] to a page that describes the info, warning or error type.
Example Response (application/json)
{
"$schema":"api:standardResponse",
"links":[
{
"rel":"canonical",
"href":"http://127.0.0.1:9015/services/v2/datastore",
"mediaType":"application/json"
},
{
"rel":"self",
"href":"http://127.0.0.1:9015/services/v2/datastore",
"mediaType":"application/json"
}
],
"messages":[
]
}