Apache Druid: a high performance real-time analytics database.
Go to file
zachjsh 1d6df48145
Warn if cache size of lookup is beyond max size (#11863)
Enhanced the ExtractionNamespace interface in lookups-cached-global core extension with the ability to set a maxHeapPercentage for the cache of the respective namespace. The reason for adding this functionality, is make it easier to detect when a lookup table grows to a size that the underlying service cannot handle, because it does not have enough memory. The default value of maxHeap for the interface is -1, which indicates that no maxHeapPercentage has been set. For the JdbcExtractionNamespace and UriExtractionNamespace implementations, the default value is null, which will cause the respective service that the lookup is loaded in, to warn when its cache is beyond mxHeapPercentage of the service's configured max heap size. If a positive non-null value is set for the namespace's maxHeapPercentage config, this value will be honored for all services that the respective lookup is loaded onto, and consequently log warning messages when the cache of the respective lookup grows beyond this respective percentage of the services configured max heap size. Warnings are logged every time that either Uri based or Jdbc based lookups are regenerated, if the maxHeapPercentage constraint is violated. No other implementations will log warnings at this time. No error is thrown when the size exceeds the maxHeapPercentage at this time, as doing so could break functionality for existing users. Previously the JdbcCacheGenerator generated its cache by materializing all rows of the underling table in memory at once; this made it difficult to log warning messages in the case that the results from the jdbc query were very large and caused the service to run out of memory. To help with this, this pr makes it so that the jdbc query results are instead streamed through an iterator.
2021-11-03 21:32:22 -04:00
.github Lock hadoop dependencies to 2.8.5 (#11583) 2021-08-12 15:16:47 +05:30
.idea Use ExecutorService variables to assign ExecutorService Instances (#11373) 2021-06-25 16:56:34 -07:00
benchmarks Remove IncrementalIndex template modifier (#11160) 2021-10-27 13:10:37 -07:00
cloud bump version to 0.23.0-SNAPSHOT (#11670) 2021-09-08 15:56:04 -07:00
codestyle handle timestamps of complex types when parsing protobuf messages (#11293) 2021-06-07 15:19:39 +05:30
core Remove CloseQuietly and migrate its usages to other methods. (#10247) 2021-10-23 17:03:21 -07:00
dev chore: fix case of GitHub (#10928) 2021-05-07 01:15:43 -07:00
distribution Support for hadoop 3 via maven profiles (#11794) 2021-10-30 22:46:24 +05:30
docs Warn if cache size of lookup is beyond max size (#11863) 2021-11-03 21:32:22 -04:00
examples Support for hadoop 3 via maven profiles (#11794) 2021-10-30 22:46:24 +05:30
extendedset bump version to 0.23.0-SNAPSHOT (#11670) 2021-09-08 15:56:04 -07:00
extensions-contrib Support for hadoop 3 via maven profiles (#11794) 2021-10-30 22:46:24 +05:30
extensions-core Warn if cache size of lookup is beyond max size (#11863) 2021-11-03 21:32:22 -04:00
helm/druid docs: update helm flag (#11721) 2021-11-02 13:25:49 +08:00
hll bump version to 0.23.0-SNAPSHOT (#11670) 2021-09-08 15:56:04 -07:00
hooks Add git pre-commit hook to source control (#9554) 2020-06-05 11:19:42 -10:00
indexing-hadoop Support for hadoop 3 via maven profiles (#11794) 2021-10-30 22:46:24 +05:30
indexing-service Support for hadoop 3 via maven profiles (#11794) 2021-10-30 22:46:24 +05:30
integration-tests Fixing typos in docker build scripts (#11866) 2021-11-02 23:50:52 +05:30
licenses Web console: Better hotkeys and library upgrades (#11365) 2021-06-17 18:24:29 -07:00
processing Remove IncrementalIndex template modifier (#11160) 2021-10-27 13:10:37 -07:00
publications De-incubation cleanup in code, docs, packaging (#9108) 2020-01-03 12:33:19 -05:00
server Add Broker config `druid.broker.segment.watchRealtimeNodes` (#11732) 2021-11-02 12:38:42 +05:30
services Support for hadoop 3 via maven profiles (#11794) 2021-10-30 22:46:24 +05:30
sql SqlAggregationModuleTest now extends CalciteTestBase to ensure consistent string encoding (#11861) 2021-11-01 15:11:40 -07:00
web-console Update default values for tuning parameters in kinesis data loader (#11867) 2021-11-02 23:51:28 +05:30
website Support for hadoop 3 via maven profiles (#11794) 2021-10-30 22:46:24 +05:30
.asf.yaml Add .asf.yaml. (#9083) 2019-12-20 16:45:38 -08:00
.backportrc.json Add 0.18.0 to .backportrc.json to facilitate backport. (#9661) 2020-04-11 13:49:04 -07:00
.codecov.yml Use Codecov (#8388) 2019-08-28 08:49:30 -07:00
.dockerignore Add docker container for druid (#6896) 2019-02-08 12:12:28 +00:00
.gitignore Web console basic end-to-end-test (#9595) 2020-04-09 12:38:09 -07:00
.lgtm.yml Suppress LGTM warnings about stack trace exposure (#9631) 2020-04-09 17:31:03 -07:00
.travis.yml Support for hadoop 3 via maven profiles (#11794) 2021-10-30 22:46:24 +05:30
CONTRIBUTING.md Fix numbered list formatting in markdown. (#9664) 2020-04-21 20:18:12 -07:00
LABELS Add plain text README.txt, use relative link from README.md to build.md (#7611) 2019-05-09 21:29:26 -07:00
LICENSE support Aliyun OSS service as deep storage (#9898) 2020-07-01 22:20:53 -07:00
NOTICE license.yaml fixes for code introduced related to AWS RDS token based password provider in PR #9518 (#10885) 2021-03-10 12:59:25 -08:00
README.md Fix travis' link behind build badge (#11858) 2021-11-01 07:26:30 -07:00
README.template De-incubation cleanup in code, docs, packaging (#9108) 2020-01-03 12:33:19 -05:00
check_test_suite.py suppress false positive cve (#11699) 2021-09-13 20:45:38 -07:00
check_test_suite_test.py suppress false positive cve (#11699) 2021-09-13 20:45:38 -07:00
licenses.yaml Support for hadoop 3 via maven profiles (#11794) 2021-10-30 22:46:24 +05:30
owasp-dependency-check-suppressions.xml Support for hadoop 3 via maven profiles (#11794) 2021-10-30 22:46:24 +05:30
pom.xml Support for hadoop 3 via maven profiles (#11794) 2021-10-30 22:46:24 +05:30
setup-hooks.sh Add git pre-commit hook to source control (#9554) 2020-06-05 11:19:42 -10:00
upload.sh Adding licenses and enable apache-rat-plugin. (#6215) 2018-09-18 08:39:26 -07:00

README.md

Slack Build Status Language grade: Java Coverage Status Docker Helm


Website | Documentation | Developer Mailing List | User Mailing List | Slack | Twitter | Download


Apache Druid

Druid is a high performance real-time analytics database. Druid's main value add is to reduce time to insight and action.

Druid is designed for workflows where fast queries and ingest really matter. Druid excels at powering UIs, running operational (ad-hoc) queries, or handling high concurrency. Consider Druid as an open source alternative to data warehouses for a variety of use cases. The design documentation explains the key concepts.

Getting started

You can get started with Druid with our local or Docker quickstart.

Druid provides a rich set of APIs (via HTTP and JDBC) for loading, managing, and querying your data. You can also interact with Druid via the built-in console (shown below).

Load data

data loader Kafka

Load streaming and batch data using a point-and-click wizard to guide you through ingestion setup. Monitor one off tasks and ingestion supervisors.

Manage the cluster

management

Manage your cluster with ease. Get a view of your datasources, segments, ingestion tasks, and services from one convenient location. All powered by SQL systems tables, allowing you to see the underlying query for each view.

Issue queries

query view combo

Use the built-in query workbench to prototype DruidSQL and native queries or connect one of the many tools that help you make the most out of Druid.

Documentation

You can find the documentation for the latest Druid release on the project website.

If you would like to contribute documentation, please do so under /docs in this repository and submit a pull request.

Community

Community support is available on the druid-user mailing list, which is hosted at Google Groups.

Development discussions occur on dev@druid.apache.org, which you can subscribe to by emailing dev-subscribe@druid.apache.org.

Chat with Druid committers and users in real-time on the #druid channel in the Apache Slack team. Please use this invitation link to join the ASF Slack, and once joined, go into the #druid channel.

Building from source

Please note that JDK 8 is required to build Druid.

For instructions on building Druid from source, see docs/development/build.md

Contributing

Please follow the community guidelines for contributing.

For instructions on setting up IntelliJ dev/intellij-setup.md

License

Apache License, Version 2.0