5/FBLP - Firebird Butler Log Protocol

domain:

github.com/FirebirdSQL/Butler

shortname:

5/FBLP

name:

Firebird Butler Log Protocol

status:

raw

editor:

Pavel Císař <pcisar@users.sourceforge.net>

Firebird Butler Log Protocol (FBLP) is designed for unified creation, processing, and exchange of log information within Firebird Butler system.

License

Copyright (c) 2018 The Firebird Butler Project.

This Specification is distributed under Creative Commons Attribution-ShareAlike 4.0 International license.

You should have received a copy of the CC BY-SA 4.0 along with this document; if not, see https://creativecommons.org/licenses/by-sa/4.0/

Change Process

This Specification is a free and open standard and is governed by the Consensus-Oriented Specification System (COSS) (see “2/COSS - Consensus-Oriented Specification System”).

Important

This specification is still incomplete (work in progress), hence the COSS change process is not yet fully applicable. All ideas and change proposals SHOULD be presented and discussed in Firebird Butler forum.

Language

The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “MAY”, and “OPTIONAL” in this document are to be interpreted as described in RFC2119.

1. Goals

The purpose of this specification is to define unified log format, and formal rules for exchanging log messages between Butler Service and its Client. Its goals are:

  1. Define unified, flexible and extensible data format for logging information, suitable for diagnostic and audit purposes.

  2. Define serialization format for such logging information suitable for transmission in 4/FBSP Data Frames.

  3. Define the method of publishing log information through ZeroMQ PUB sockets.

  4. Define a single API for forwarding log information between the Firebird Butler Service and the Client.

2. Implementation

Todo

Specification body.