---
name: "confdb_keys"
section: "8"
platform: "linux"
package: "corosync"
version: "1.4.6-1.1"
release: "Debian 8 (Jessie)"
platforms: ["linux"]
url: "https://new.carta.tech/confdb_keys"
---

# confdb\_keys(8)

Overview of keys stored in the Configuration Database

## NAME

confdb\_keys - Overview of keys stored in the Configuration Database

## OVERVIEW

There are roughly 3 types of keys stored in ConfDB:

\* Values stored in config file.

\* Runtime statistics.

\* Other user created values.

## OBJECTS AND KEYS

- internal\_configuration.\*

  Internal configuration data. It's only useful for getting list of loaded services.

- logging.\*

  Values read from configuration file. It's possible to change them at runtime. If subsystem specific configuration is needed, each subsys must have one object with subsys key. Other keys are same as in config file.

- runtime.blackbox.\*

  Trigger keys for store fplay data. It's recommended to use corosync-blackbox command to change keys in this object.

- runtime.connections.\*

  There are informations about total number of active connections in given moment in **active** key, number of closed connections during whole runtime of corosync in **closed** key and informations about each active IPC connection.

- runtime.connections.ID.\*

  Each IPC connection has unique ID. This is in form \[\[short\_name:\]\[PID:\]internal\_id. On some platforms, short\_name and PID are not filled and only internal\_id is used.

  Typical keys in object are:

  **client\_pid** containing PID of IPC connection (unavailable on some platforms).

  **dispatched** with number of dispatched messages.

  **invalid\_request** is number of requests made by IPC which are invalid (calling non-existing call, ...).

  **name** containing short name of IPC connection (unavailable on some platforms).

  **overload** is number of requests which were not processed because of overload.

  **queue\_size** contains number of messages in queue waiting for send.

  **recv\_retries** is total number of interrupted receives.

  **requests** contains number of requests made by IPC.

  **responses** is number of responses sent to IPC client.

  **send\_retries** contains total number of interrupted sends.

  **service\_id** contains ID of service which IPC is connected to.

- runtime.services.\*

  Objects with statistics for service engines. Each service has it's own subobject with name SERVICE, where SERVICE is lower case name of service. Inside object is number of received and send messages by corosync engine in format runtime.services.SERVICE.EXEC\_CALL.rx and runtime.services.SERVICE.EXEC\_CALL.tx, where EXEC\_CALL is internal id of service call (so for example 3 in cpg service is receive of multicast message from other nodes).

- runtime.totem.pg.mrp.srp.\*

  Object with statistics about totem. Typical keys:

  **commit\_entered** Number of times processor entered COMMIT state.

  **commit\_token\_lost** Number of times processor lost token in COMMIT state.

  **consensus\_timeouts** How many times processor timeouted making consensus about membership.

  **continuous\_gather** How many times was processor not able to reach consensus.

  **firewall\_enabled\_or\_nic\_failure** Set to 1 when processor was not able to reach consensus for long time. Usual reason is badly configured firewall or connection failure.

  **gather\_entered** Number of times processor entered GATHER state.

  **gather\_token\_lost** Number of times processor lost token in GATHER state.

  **mcast\_retx** Number of retransmitted messages.

  **mcast\_rx** Number of received multicast messages.

  **mcast\_tx** Number of transmitted multicast messages.

  **memb\_commit\_token\_rx** Number of received commit tokens.

  **memb\_commit\_token\_tx** Number of transmitted commit tokens.

  **memb\_join\_rx** Number of received join messages.

  **memb\_join\_tx** Number of transmitted join messages.

  **memb\_merge\_detect\_rx** Number of received member merge messages.

  **memb\_merge\_detect\_tx** Number of transmitted member merge messages.

  **orf\_token\_rx** Number of received orf tokens.

  **orf\_token\_tx** Number of transmitted orf tokens.

  **recovery\_entered** Number of times processor entered recovery.

  **recovery\_token\_lost** Number of times token was lost in recovery state.

  **rx\_msg\_dropped** Number of received messages which was dropped because they were not expected (as example multicast message in commit state).

  **token\_hold\_cancel\_rx** Number of received token hold cancel messages.

  **token\_hold\_cancel\_tx** Number of transmitted token hold cancel messages.

  **mtt\_rx\_token** Mean transit time of token in milliseconds. In other words, time between two consecutive token receives.

  **avg\_token\_workload** Average time in milliseconds of holding time of token on current processor.

  **avg\_backlog\_calc** Average number of not yet sent messages of current processor.

- runtime.totem.pg.mrp.srp.members.\*

  Object containing members of totem single ring protocol. Each member key has format runtime.totem.pg.mrp.srp.members.NODEID.KEY, where key is one of:

  **ip** IP address of member. It's stored in format r(RING\_ID) ip(IP\_ADDRESS).

  **join\_count** Number of times processor joined membership with local processor. When processor fails and rejoins again, this value is incremented.

  **status** Status of processor. Can be one of joined and left.

- resources.process.PID.\*

  Object created by applications using SAM with ConfDB integration. It contains following keys:

  **recovery** Recovery policy of process. Can be one of quit or restart.

  **poll\_period** Value passed in sam\_initialize as time\_interval.

  **last\_updated** Last time when SAM received heartbeat from client.

  **state** State of client. Can be one of failed, stopped, running and waiting for quorum.

- uidgid.\*

  Informations about users/groups which are allowed to do IPC connection to corosync. Objects can contain uid and gid keys, with user and group allowed to connect corosync IPC.

## SEE ALSO

[**corosync\_overview**(8)](/corosync_overview/8.md), [**corosync.conf**(5)](/corosync.conf/5.md), [**corosync-objctl**(8)](/corosync-objctl/8.md)