GitHub user mattf-horton opened a pull request:
https://github.com/apache/incubator-metron/pull/481
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 cases.
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](https://cwiki.apache.org/confluence/pages/viewpage.action?pageId=61332235)
for the complete guide to follow for contributions.
Please refer also to our [Build Verification
Guidelines](https://cwiki.apache.org/confluence/display/METRON/Verifying+Builds?show-miniview)
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](https://issues.apache.org/jira/browse/METRON/?selectedTab=com.atlassian.jira.jira-projects-plugin:summary-panel).
- [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 master)?
### 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 manually?
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/verify_licenses.sh
```
- [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](http://www.apache.org/legal/resolved.html#category-a)?
- [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 https://github.com/mattf-horton/incubator-metron METRON-322
Alternatively you can review and apply these changes as the patch at:
https://github.com/apache/incubator-metron/pull/481.patch
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 <mfo...@hortonworks.com>
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 infrastruct...@apache.org or file a JIRA ticket
with INFRA.
---
