metron-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From mattf-horton <>
Subject [GitHub] incubator-metron pull request #481: METRON-322 Global Batching and Flushing
Date Thu, 16 Mar 2017 20:27:29 GMT
GitHub user mattf-horton opened a pull request:

    METRON-322 Global Batching and Flushing

    This patch starts by adding "batchTimeout" essentially every place "batchSize" is used.
 Since the configuration-related classes are many-layered, this addition is trivial in many
    The flush-on-timeout logic is fairly straightforward. It was implemented by a refactoring
of `BulkWriterComponent` to extract an explicit "flush" from the "write" logic, and then call
flush from Tick Tuple processing in `BulkMessageWriterBolt`.
    The tricky part was figuring out the appropriate setting for `topology.tick.tuple.freq.secs`
if the administrator configures non-default batchTimeouts. It is necessary to enumerate the
batchTimeout settings for all configured sensorNames, which is implemented in `IndexingConfigurations::getAllConfiguredTimeouts()`.
Then multiple other factors must be taken into account to determine the allowed and recommended
settings, which is implemented in `BatchTimeoutHelper`. If there are better ways to accomplish
these things, please share your ideas.
    For test and review, it may be useful to know that the default value of `batchTimeout`,
and hence for `topology.tick.tuple.freq.secs`, is 14 seconds (which is the default value of
`topology.message.timeout.secs` (30 sec) / 2 - 1).
    To unit test this feature, we added `Clock` logic and implemented a writable `FakeClock`.
 This may be generally useful for testing other time-based behavior as we add such functionality.
    All configuration issues were done in such a way as to default to "good" behavior, with
no changes needed in current configs of previously installed systems.  In fact, recommended
configuration is to leave batchTimeout unconfigured, or set it to zero, thereby accepting
the system calculated default.
    After this patch is reviewed and accepted, similar work needs to be done for the `ParserWriter`,
and possibly other sub-components.  That will be in a separate PR.
    It is possible to split this patch into sections related to each of sub-tasks METRON-516,
METRON-577, METRON-329 and METRON-330.  Let me know if you would like me to do so.  In the
past, people seem to prefer to see a whole feature development in one PR, even though it gets
a little long, so that's the way I'm submitting this one, for now.
    ## Pull Request Checklist
    Thank you for submitting a contribution to Apache Metron (Incubating).  
    Please refer to our [Development Guidelines](
for the complete guide to follow for contributions.  
    Please refer also to our [Build Verification Guidelines](
for complete smoke testing guides.  
    In order to streamline the review of the contribution we ask you follow these guidelines
and ask you to double check the following:
    ### For all changes:
    - [x] Is there a JIRA ticket associated with this PR? If not one needs to be created at
[Metron Jira](

    - [x] Does your PR title start with METRON-XXXX where XXXX is the JIRA number you are
trying to resolve? Pay particular attention to the hyphen "-" character.
    - [x] Has your PR been rebased against the latest commit within the target branch (typically
    ### For code changes:
    - [NA] Have you included steps to reproduce the behavior or problem that is being changed
or addressed?
    - [x] Have you included steps or a guide to how the change may be verified and tested
        Yes, see the two modified .md files, and the above information.
    - [x] Have you ensured that the full suite of tests and checks have been executed in the
root incubating-metron folder via:
      mvn -q clean integration-test install && build_utils/ 
    - [x] Have you written or updated unit tests and or integration tests to verify your changes?
    - [NA] If adding new dependencies to the code, are these dependencies licensed in a way
that is compatible for inclusion under [ASF 2.0](

    - [IN PROCESS] Have you verified the basic functionality of the build by building and
running locally with Vagrant full-dev environment or the equivalent?
    ### For documentation related changes:
    - [x] Have you ensured that format looks appropriate for the output in which it is rendered
by building and verifying the site-book? 

You can merge this pull request into a Git repository by running:

    $ git pull METRON-322

Alternatively you can review and apply these changes as the patch at:

To close this pull request, make a commit to your master/trunk branch
with (at least) the following in the commit message:

    This closes #481
commit c2a700e78143b4c7a143a2b061ffb210cdb2d36f
Author: mattf-horton <>
Date:   2017-03-07T01:29:13Z

    METRON-322 Global Batching and Flushing
    changes for sub-tasks METRON-516 and METRON-577, METRON-329 and METRON-330.


If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at or file a JIRA ticket
with INFRA.

View raw message