Apache Druid: a high performance real-time analytics database.
Go to file
Abhishek Radhakrishnan 38ecf980d0
Refactor and add tests and metric to KillUnusedSegments duty (auto-kill) (#15941)
* Kill duty and test improvements.

Initial commit with:
- Bug fixes - auto-kill can throw NPE when there are no datasources present and defaults mismatch.
- Add new stat for candidate segment intervals killed.
- Move a couple of debug logs to info logs for improved visibility (should only log once per kill period).
- Remove redundant checks for code readability.
- Updated tests from using mocks (also the mocks weren't using last updated timestamp) and
  add more test coverage for different config parameters.
- Add a couple of unit tests that are ignored for the eternity case to prove that
  the kill duty doesn't clean up segments with ALL grain or that end in DateTimes.MAX.
- Migrate Druid exception from user to operator persona.

* Address review comments.

* Remove unused methods.

* fix up format specifier and validate bad config tests.

* Consolidate the helpers a bit more and add another test.

* Update test names. Add javadoc placeholders for slightly involved tests.

* Add docs for metric kill/candidateUnusedSegments/count.

Also, rename to disambiguate.

* Comments.

* Apply logging suggestions from code review

Co-authored-by: Kashif Faraz <kashif.faraz@gmail.com>

* Review comments

- Clarify docs on eligibility.
- Add test for multiple segments in the same interval. Clarify comment.
- Remove log line from test.
- Remove lastUpdatedDate = now.plus(10) from test.

* minor cleanup.

* Clarify javadocs for getUnusedSegmentIntervals().

---------

Co-authored-by: Kashif Faraz <kashif.faraz@gmail.com>
2024-02-27 12:14:41 +05:30
.github Reduce the size of distribution docker image (#15968) 2024-02-26 21:18:55 +05:30
.idea Ignore misc.xml (#14362) 2023-06-02 12:00:52 +05:30
benchmarks Add sqlReverseLookupThreshold for ReverseLookupRule. (#15832) 2024-02-06 16:32:05 +05:30
cloud Prepare main branch for next 30.0.0 release. (#15707) 2024-01-23 15:55:54 +05:30
codestyle fix rat and checkstyle issue (#15530) 2023-12-14 09:33:01 +08:00
dev Suggest adoption of Google Style guide (#14905) 2023-11-01 13:31:03 -07:00
distribution Reduce the size of distribution docker image (#15968) 2024-02-26 21:18:55 +05:30
docs Refactor and add tests and metric to KillUnusedSegments duty (auto-kill) (#15941) 2024-02-27 12:14:41 +05:30
examples remove legacy Jupyter tutorial files (#15834) 2024-02-12 13:45:47 -08:00
extensions-contrib Feature: add support for ingesting from rabbitmq super streams (#14137) 2024-02-22 10:50:37 +05:30
extensions-core Refactor GroupBy and TopN code to relax the constraint of dimensions being comparable (#15559) 2024-02-27 11:39:29 +05:30
hooks Git hooks should fail on errors; pass args to git hooks (#12322) 2022-03-10 09:07:50 +09:00
indexing-hadoop Prepare main branch for next 30.0.0 release. (#15707) 2024-01-23 15:55:54 +05:30
indexing-service Try to fetch the task status for an active from memory (#15724) 2024-02-26 13:53:05 +05:30
integration-tests Reduce the size of distribution docker image (#15968) 2024-02-26 21:18:55 +05:30
integration-tests-ex Add security ITs to the revised integration tests (#15885) 2024-02-20 11:32:08 +05:30
licenses Web console: Update and prune dependancies (#15487) 2023-12-05 14:25:07 -08:00
processing Refactor GroupBy and TopN code to relax the constraint of dimensions being comparable (#15559) 2024-02-27 11:39:29 +05:30
publications De-incubation cleanup in code, docs, packaging (#9108) 2020-01-03 12:33:19 -05:00
server Refactor and add tests and metric to KillUnusedSegments duty (auto-kill) (#15941) 2024-02-27 12:14:41 +05:30
services Parallelize storage of incremental segments (#13982) 2024-02-07 10:43:05 +05:30
sql Refactor GroupBy and TopN code to relax the constraint of dimensions being comparable (#15559) 2024-02-27 11:39:29 +05:30
web-console Web console: fix typos in Kinesis suggestions, add regions and groups (#15900) 2024-02-27 10:00:02 +08:00
website Fix redirects for streaming ingestion (#15943) 2024-02-22 22:34:19 +05:30
.asf.yaml .asf.yaml: Add required "repository" field. (#14499) 2023-06-28 15:05:07 -07: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 Docusaurus2 upgrade for master (#14411) 2023-08-16 19:01:21 -07:00
.lgtm.yml be consistent about referring to the web console by its name (#13118) 2022-09-19 15:02:17 -07:00
CONTRIBUTING.md Document our conventions for writing messages (#13916) 2023-04-03 21:30:20 -07:00
LABELS Fixing security vulnerability check errors (#13956) 2023-03-23 11:10:06 +05:30
LICENSE Adding the PropertyNamingStrategies from jackson for fixing hadoop ingestion (#14671) 2023-08-01 20:02:43 +05:30
NOTICE Update notice file. (#15702) 2024-01-23 15:56:22 +05:30
README.md Update the link of Helm Chart to avoid 404 error (#15905) 2024-02-21 16:57:41 +08:00
README.template De-incubation cleanup in code, docs, packaging (#9108) 2020-01-03 12:33:19 -05:00
check_test_suite.py Update Hadoop3 as default build version (#14005) 2023-04-26 12:52:51 +05:30
check_test_suite_test.py remove Travis CI (#13789) 2023-02-10 01:46:56 -08:00
doap_Druid.rdf Fix the created property in DOAP RDF file (#14971) 2023-09-13 06:12:35 -07:00
it.sh Build reliablity fixes (#15048) 2023-09-28 12:27:52 -07:00
licenses.yaml Bump log4j.version from 2.18.0 to 2.22.1 (#15934) 2024-02-23 16:19:35 +08:00
owasp-dependency-check-suppressions.xml CVE Fix: Update json-path version (#15772) 2024-02-14 20:58:27 -08:00
pom.xml Bump log4j.version from 2.18.0 to 2.22.1 (#15934) 2024-02-23 16:19:35 +08:00
upload.sh Adding licenses and enable apache-rat-plugin. (#6215) 2018-09-18 08:39:26 -07:00

README.md

Coverage Status Docker Helm

Workflow Status
⚙️ CodeQL Config codeql-config
🔍 CodeQL codeql
🕒 Cron Job ITS cron-job-its
🏷️ Labeler labeler
♻️ Reusable Revised ITS reusable-revised-its
♻️ Reusable Standard ITS reusable-standard-its
♻️ Reusable Unit Tests reusable-unit-tests
🔄 Revised ITS revised-its
🔧 Standard ITS standard-its
🛠️ Static Checks static-checks
🧪 Unit and Integration Tests Unified unit-and-integration-tests-unified
🔬 Unit Tests unit-tests

Website Twitter Download Get Started Documentation Community Build Contribute License


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 web 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

See the latest documentation for the documentation for the current official release. If you need information on a previous release, you can browse previous releases documentation.

Make documentation and tutorials updates in /docs using Markdown or extended Markdown (MDX). Then, open a pull request.

To build the site locally, you need Node 16.14 or higher and to install Docusaurus 2 with npm|yarn install in the website directory. Then you can run npm|yarn start to launch a local build of the docs.

If you're looking to update non-doc pages like Use Cases, those files are in the druid-website-src repo.

Community

Visit the official project community page to read about getting involved in contributing to Apache Druid, and how we help one another use and operate Druid.

  • Druid users can find help in the druid-user mailing list on Google Groups, and have more technical conversations in #troubleshooting on Slack.
  • Druid development discussions take place in the druid-dev mailing list (dev@druid.apache.org). Subscribe by emailing dev-subscribe@druid.apache.org. For live conversations, join the #dev channel on Slack.

Check out the official community page for details of how to join the community Slack channels.

Find articles written by community members and a calendar of upcoming events on the project site - contribute your own events and articles by submitting a PR in the apache/druid-website-src repository.

Building from source

Please note that JDK 8 or JDK 11 is required to build Druid.

See the latest build guide for instructions on building Apache Druid from source.

Contributing

Please follow the community guidelines for contributing.

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

License

Apache License, Version 2.0