Project

General

Profile

Actions

Feature #3364

closed

Task #3374: Migrate all core modules from legacy Mentat

Implement mentat-storage.py module

Added by Jan Mach over 7 years ago. Updated over 6 years ago.

Status:
Closed
Priority:
High
Assignee:
Category:
Development - Core
Target version:
Start date:
03/21/2017
Due date:
% Done:

100%

Estimated time:
To be discussed:

Description

Implement daemon module for storing IDEA messages into database.

Key features:
  • Support for multiple database engines (at least enable quick change)
  • Enable configurable target database (database and collection names should be part of configuration file)
  • Enable storing of multiple messages in batches possibly for better database performance
  • Asynchronous querying (with possibility to ask for query state or partial results) would be nice
Actions #1

Updated by Jan Mach over 7 years ago

  • Parent task set to #3374
Actions #2

Updated by Jan Mach over 7 years ago

  • Priority changed from Normal to High
Actions #3

Updated by Pavel Kácha over 7 years ago

  • Description updated (diff)
Actions #4

Updated by Jan Mach over 7 years ago

  • Status changed from New to In Progress
Actions #5

Updated by Jan Mach over 7 years ago

  • Status changed from In Progress to Feedback
  • Assignee changed from Jan Mach to Pavel Kácha

Implemented base libraries for representing IDEA messages in Mentat system and converting them from that internal representation to appropriate representation in MongoDB and back.

Because the implementation is based on Pavel`s typedcol and idea.lite libraries, I would like to ask him to please make a quick review and provide feedback, whether the implementation makes sense to the author of original library.

Most relevant files for convenience:

source:lib/mentat/idea/internal.py
source:lib/mentat/idea/test_internal.py
source:lib/mentat/idea/mongodb.py
source:lib/mentat/idea/test_mongodb.py

Actions #6

Updated by Jan Mach over 7 years ago

I have encountered showstopper that is currently preventing us from successfully using the mentat.idea.mongodb library for storing messages into database. The issue seems to be with native BSON encoder, which is unable to encode objects of type typedcol.TypedList into BSON:

Traceback (most recent call last):
  File "test_mongodb.py", line 354, in test_04_basic
    result_b = self.collection.insert_one(idea_mongo_in_l)
  File "/usr/local/lib/python3.5/dist-packages/pymongo/collection.py", line 630, in insert_one
    bypass_doc_val=bypass_document_validation),
  File "/usr/local/lib/python3.5/dist-packages/pymongo/collection.py", line 535, in _insert
    check_keys, manipulate, write_concern, op_id, bypass_doc_val)
  File "/usr/local/lib/python3.5/dist-packages/pymongo/collection.py", line 516, in _insert_one
    check_keys=check_keys)
  File "/usr/local/lib/python3.5/dist-packages/pymongo/pool.py", line 244, in command
    self._raise_connection_failure(error)
  File "/usr/local/lib/python3.5/dist-packages/pymongo/pool.py", line 372, in _raise_connection_failure
    raise error
  File "/usr/local/lib/python3.5/dist-packages/pymongo/pool.py", line 239, in command
    read_concern)
  File "/usr/local/lib/python3.5/dist-packages/pymongo/network.py", line 82, in command
    None, codec_options, check_keys)
bson.errors.InvalidDocument: Cannot encode object: ['abuse@cesnet.cz']

----------------------------------------------------------------------

A have implemented horrible hack function primitivize() into module mentat.idea.mongodb to verify this. The approprite code can be found in separate branch dev_mek in repository, in unit test file mentat.idea.test_mongodb. The primitivize() function is directly in module mentat.idea.mongodb. I was unable to primitivize only TypedList to list and due to implementation conststraints had to primitivize also TypedDict to dict.

The bson.BSON.encode documentation sadly confirms, that encode method can cope only with MutableMapping objects:

https://api.mongodb.com/python/3.4.0/api/bson/index.html

Actions #7

Updated by Pavel Kácha over 7 years ago

Quick brainblender:
  • wrap TypedList derivatives in simple
    return tl.data
  • try adding
    bson._ENCODERS[TypedList] = _encode_list
Actions #8

Updated by Pavel Kácha over 7 years ago

Pavel Kácha wrote:

Quick brainblender:
  • try adding bson._ENCODERS[TypedList] = _encode_list

Self answer: won't work, bson has also fast C version, which is used by default, and is not monkey-patchable.

Actions #9

Updated by Jan Mach over 7 years ago

Latest commit 6830a9e4 in development branch mek_dev fixed the problem with bson.BSON.encode being unable to encode typedcol.TypedList objects. In commit 9865c900 the source:lib/mentat/idea/mongodb.py library was unable to store IDEA messages into MongoDB. The issue was with bson.BSON encoder, which was hardcoded in a way that handled any unknown object as dict. We were not able to convince the encoder to treat TypedList objects as lists, so we had to use different approach and supply appropriate data structure. The mentat.idea.mongodb.IdeaIn convertor now produces data structure composed of simple dicts and lists instead of TypedDicts and TypedLists.

Current implementation should however be considered as prototype and proof of concept, because it probably will be possible to write it in more elegant way. The current problem is, that the idea.base.idea_typedef contains hardcoded calls for typedcol.typed_list(), which are not customizable from outside of the module via flavour mechanism. The addon feature was used to monkeypatch these definitions. This is of course not optimal solution, because any changes in underlying library must be propagated manually into source:lib/mentat/idea/mongodb.py library.

Additionally, IDEA messages stored in database contain some additional attributes, that are database specific and internal and should be stripped upor retrieving from database. Currently this must be done manually using truncate() function call, more optimal solution would be to incorporate this into typedcol library and strip these attributes during object instantination/conversion process.

Actions #10

Updated by Jan Mach over 7 years ago

Finished prototype of mentat-storage.py module.

The commit 25b51380 introduces finished working prototype of mentat-storage.py real-time message processing module including appropriate unit tests and basic documentation work. Key features are possible customization of target database and collection, usage of core database configuration file, which can be overridden with local config file, or command line options. Messages are currently stored in database one by one, however batch processing will possibly be implemented in the future.

Next work:
  • test deployment on development server with continuous processing of randomly generated messages
  • test deployment on production server with continuous processing of real messages and storing them to different database and collection
  • production deployment
Actions #11

Updated by Pavel Kácha over 7 years ago

Jan Mach wrote:

Current implementation should however be considered as prototype and proof of concept, because it probably will be possible to write it in more elegant way. The current problem is, that the idea.base.idea_typedef contains hardcoded calls for typedcol.typed_list(), which are not customizable from outside of the module via flavour mechanism. The addon feature was used to monkeypatch these definitions. This is of course not optimal solution, because any changes in underlying library must be propagated manually into source:lib/mentat/idea/mongodb.py library.

Ahha, hardcoded typedcol in idea.base.idea_typedef. Good point. Ok, how about changing:

def idea_typedef(flavour, list_flavour, defaults_flavour, source_target_dict, attach_dict, node_dict, addon=None)

to explicit

def idea_typedef(flavour, list_flavour, defaults_flavour, source_list, target_list, attach_list, node_list, addon=None)

Usage then would be something akin to:

    typedef = base.idea_typedef(
        idea_types,
        idea_lists,
        idea_defaults,
        typedcol.typed_list("SourceList", SourceTargetDict),
        typedcol.typed_list("TargetList", SourceTargetDict),
        typedcol.typed_list("AttachList", AttachDict),
        typedcol.typed_list("NodeList", NodeDict)

or, for type-stripped version:

    class SourceTargetList(typedcol.TypedList):
        item_type = simplify(SourceTargetDict)

    class AttachList(typedcol.TypedList):
        item_type = simplify(AttachDict)

    class NodeList(typedcol.TypedList):
        item_type = simplify(NodeDict)

    typedef = base.idea_typedef(
        idea_types,
        idea_lists,
        idea_defaults,
        simplify(SourceTargetList),
        simplify(SourceTargetList),
        simplify(AttachList),
        simplify(NodeList)

Would that be ok?

Actions #12

Updated by Jan Mach over 7 years ago

Pavel Kácha wrote:

Would that be ok?

Yes, that was also my initial idea. That would definitely solve our issue and all custom libraries would be more robust and more customizable.

Actions #13

Updated by Pavel Kácha over 7 years ago

  • Assignee changed from Pavel Kácha to Jan Mach

Jan Mach wrote:

Additionally, IDEA messages stored in database contain some additional attributes, that are database specific and internal and should be stripped upor retrieving from database. Currently this must be done manually using truncate() function call, more optimal solution would be to incorporate this into typedcol library and strip these attributes during object instantination/conversion process.

Are you positively sure that you want them stripped completely? You can't get to them later.

Is it necessary only statically and only in TypedDict (not TypedList)?

Possible solutions:

typedef = {
    "unwanted_one": {
        "drop": True
    }
}

Or, slightly more flexible (however seems out of scope of typedcol for me) possibility, usable also in TypedList:

# More pythonic
def UnwantedType(s):
    raise typedcol.Drop

or

# probably faster
def UnwantedType(s):
    return typedcol.Drop

and

typedef = {
    "unwanted_one": {
        "type": UnwantedType
    }
}
Actions #14

Updated by Pavel Kácha over 7 years ago

Both in.

idea:commit:102034e87b794fcb2f5c5ca2c225e167ebe4fcda

  • explicit list args in idea_typedef
  • list_factory callable in list_types

idea:commit:3a43637b9b6c24cdee66a564b91bd68a8f0d924e

  • Discarding of elements in TypedDict (most common use: "type": Discard)
Actions #15

Updated by Pavel Kácha over 7 years ago

Please check the correctness of the generated structure for IPs - min, max, NO ip for networks, min max ip for single ips.

Actions #16

Updated by Jan Mach about 7 years ago

  • Status changed from Feedback to In Progress
  • % Done changed from 0 to 80
Actions #17

Updated by Jan Mach over 6 years ago

  • Status changed from In Progress to Closed
  • % Done changed from 80 to 100

Current state of this module is sufficient for production environment. We are finally releasing 2.0 version of Mentat system, so the period of frantic coding and implementation chaos is over. Any further improvements of this module will be done as they should in separate Redmine issues.

Actions

Also available in: Atom PDF