{"id":13807672,"url":"https://github.com/datamechanics/delight","last_synced_at":"2025-10-03T01:31:13.591Z","repository":{"id":40687218,"uuid":"307389674","full_name":"datamechanics/delight","owner":"datamechanics","description":"A Spark UI and Spark History Server alternative with CPU and Memory metrics! Delight is free, cross-platform, and open-source.","archived":true,"fork":false,"pushed_at":"2024-05-31T14:14:28.000Z","size":2422,"stargazers_count":341,"open_issues_count":0,"forks_count":52,"subscribers_count":16,"default_branch":"main","last_synced_at":"2024-09-29T07:03:09.563Z","etag":null,"topics":["apache-spark","cpu","dashboard","delight","kubernetes","memory","monitoring","netapp-public","spark","spark-history-server","spark-ui"],"latest_commit_sha":null,"homepage":"https://www.datamechanics.co/delight","language":"Scala","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/datamechanics.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-10-26T13:56:02.000Z","updated_at":"2024-09-01T00:31:27.000Z","dependencies_parsed_at":"2024-01-06T12:20:29.593Z","dependency_job_id":"1e9a6c75-e7df-4759-b175-b05587a6be31","html_url":"https://github.com/datamechanics/delight","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/datamechanics%2Fdelight","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/datamechanics%2Fdelight/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/datamechanics%2Fdelight/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/datamechanics%2Fdelight/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/datamechanics","download_url":"https://codeload.github.com/datamechanics/delight/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":235059234,"owners_count":18929279,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["apache-spark","cpu","dashboard","delight","kubernetes","memory","monitoring","netapp-public","spark","spark-history-server","spark-ui"],"created_at":"2024-08-04T01:01:28.591Z","updated_at":"2025-10-03T01:31:08.177Z","avatar_url":"https://github.com/datamechanics.png","language":"Scala","readme":"## :warning: Delight have been shutdown on May 31st 2024 :warning:\n## All functionalities have been integrated into [NetApp's Ocean for Apache Spark](https://spot.io/product/ocean-apache-spark/)\n\n# Delight - The New \u0026 Improved Spark UI and Spark History Server\n\n[Delight](https://www.datamechanics.co/delight) is a free Spark UI \u0026 Spark History Server alternative with new metrics and visualizations that will delight you!\n\nThe Delight project is developed by [Data Mechanics](https://www.datamechanics.co), which is now part of the [Spot](https://spot.io) family. Delight works on top of any Spark platform, whether it's open-source or commercial, in the cloud or on-premise.\n\n## Overview\n\nThe [Delight web dashboard](https://delight.datamechanics.co) lists your completed Spark applications with high-level information and metrics.\n\u003cp align=\"center\"\u003e\n\u003ca href=\"documentation/images/delight_dashboard.png\"\u003e\u003cimg src=\"documentation/images/delight_dashboard.png\" width=\"80%\" align=\"middle\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\nWhen you click on a specific application, you access an overview screen for this application. It contains a graph of your Executor Cores Usage, broken down by categories. This graph is aligned with a timeline of your Spark jobs and stages, so that it's easy for you to correlate CPU metrics with the code of your Spark application.\n\nFor example, Delight made it obvious that this application (left) suffered from a slow shuffle.\nAfter using instances with mounted local SSDs (right), the application performance improved by over 10x.\n\n\u003ca href=\"documentation/images/before.png\"\u003e\u003cimg src=\"documentation/images/before.png\" width=\"45%\"\u003e\u003c/a\u003e\n\u003ca href=\"documentation/images/after.png\"\u003e\u003cimg src=\"documentation/images/after.png\" width=\"45%\"\u003e\u003c/a\u003e\n\nUnder this graph, you will get a report of the peak memory usage of your Spark executors (the overview screen shows the top 5 executors). This graph should help you tune your container memory sizes - so that memory usage stays in the 70-90% range. This graph breaks down memory usage between JVM, Python, and other processes (at the time of the peak total usage).\n\n\u003cp align=\"center\"\u003e\n\u003ca href=\"documentation/images/memory.png\"\u003e\u003cimg src=\"documentation/images/memory.png\" width=\"65%\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\nDelight also runs a Spark History Server for you, so it's a great way to access the Spark UI, without having to setup and maintain a Spark History Server yourself.\n\n## History \u0026 Roadmap\n\n- June 2020: Project starts with a widely shared [blog post](https://www.datamechanics.co/blog-post/building-a-better-spark-ui-data-mechanics-delight) detailing our vision.\n- November 2020: [First release](https://www.datamechanics.co/blog-post/were-releasing-a-free-cross-platform-spark-ui-and-spark-history-server). A dashboard with one-click access to a Hosted Spark History Server (Spark UI).\n- March 2021: Beta release of the overview screen with Executor CPU metrics and Spark timeline.\n- April 2021: [Delight is Generally Available](https://www.datamechanics.co/blog-post/delight-the-new-improved-spark-ui-spark-history-server-is-now-ga)! The overview screen now displays the executors peak memory usage, broken down by the type of memory usage (Java, Python, other processes).\n- June 2022: The list of executors and the memory over time of each executor is available. Overall UI is updated following the [acquisiton of Data Mechanics by Spot](https://spot.io/blog/accelerating-wave-big-data/)\n- Coming Next: Driver memory usage, Automated tuning recommendations, Make Delight accessible while the app is running.\n\n## Architecture\n\nDelight consists of an open-sourced agent, which runs inside your Spark application (using the [SparkListener](https://mallikarjuna_g.gitbooks.io/spark/content/spark-SparkListener.html) interface).\n\n![Delight Architecture](documentation/images/architecture.png)\n\nThis agent streams Spark events to Delight backend. These contain metadata about your Spark application execution: how long each task took, how much data was read \u0026 written, how much memory was used, etc. These logs do not contain sensitive information like the data that your Spark application is processing. Here's a [sample Spark event](documentation/resources/example_spark_event_log_message.json) and a [full Spark event log](documentation/resources/example_spark_event_log.txt).\n\nOnce your application is finished, it becomes available on the Delight hosted [dashboard](https://delight.datamechanics.co). It gives you access to high-level metrics, to a new Delight screen showing CPU \u0026 Memory metrics, and to the Spark UI.\n\n## Installation\n\nTo use Delight:\n\n- Sign in through our [website](https://delight.datamechanics.co) using your Google account. If you want to share a single Delight dashboard, you should use your company's Google account.\n- Head to settings on the left navigation bar, and create a personal access token. This token will uniquely identify your applications in Delight - treat it as a secret.\n- Follow the installation instructions below for your platform.\n\nHere are the available instructions:\n\n- [Local run with the `spark-submit` CLI](documentation/local_run.md)\n- [Generic instructions for the `spark-submit` CLI](documentation/spark_submit.md)\n- [AWS EMR](documentation/aws_emr.md)\n- [AWS EMR on EKS](documentation/aws_emr_eks.md)\n- [Google Cloud Dataproc](documentation/dataproc.md)\n- [Spark on Kubernetes operator](documentation/spark_operator.md)\n- [Databricks](documentation/databricks.md)\n- [Apache Livy](documentation/apache_livy.md)\n\n## Compatibility\n\nDelight is compatible with Spark `2.4.0` to Spark `3.3.0` with the following Maven coordinates:\n\n`co.datamechanics:delight_\u003creplace-with-your-scala-version-2.11-or-2.12\u003e:latest-SNAPSHOT`\n\nWe also maintain a version compatible with Spark `2.3.x`.\nPlease use the following Maven coordinates to use it:\n\n`co.datamechanics:delight_2.11:2.3-latest-SNAPSHOT`\n\n**Delight is compatible with Pyspark.**\nBut even if you use Python, you'll have to determine the Scala version used by your Spark distribution and fill out the placeholder above in the Maven coordinates!\n\n## Configurations\n\n| Config                             | Explanation                                                                                                                                      | Default value    |\n| :--------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------- | :--------------- |\n| `spark.delight.accessToken.secret` | An access token to authenticate yourself with Delight. If the access token is missing, the listener will not stream events        | (none)           |\n| `spark.delight.appNameOverride`    | The name of the app that will appear in Delight. This is only useful if your platform does not allow you to set `spark.app.name`. | `spark.app.name` |\n\n### Advanced configurations\n\nWe've listed more technical configurations in this section for completeness.\nYou should not need to change the values of these configurations though, so drop us a line if you do, we'll be interested to know more!\n\n| Config                                                  | Explanation                                                                                                                                                                                                                               | Default value                                   |\n| :------------------------------------------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------- |\n| `spark.delight.collector.url`                           | URL of the Delight collector API                                                                                                                                                                                           | https://api.delight.datamechanics.co/collector/ |\n| `spark.delight.buffer.maxNumEvents`                     | The number of Spark events to reach before triggering a call to Delight Collector API. Special events like job ends also trigger a call.                                                                                           | 1000                                            |\n| `spark.delight.payload.maxNumEvents`                    | The maximum number of Spark events to be sent in one call to Delight Collector API.                                                                                                                                                | 10000                                           |\n| `spark.delight.heartbeatIntervalSecs`                   | (Internal config) the interval at which the listener send an heartbeat requests to the API. It allow us to detect if the app was prematurely finished and start the processing ASAP                                                       | 10s                                             |\n| `spark.delight.pollingIntervalSecs`                     | (Internal config) the interval at which the object responsible for calling the API checks whether there are new payloads to be sent                                                                                                       | 0.5s                                            |\n| `spark.delight.maxPollingIntervalSecs`                  | (Internal config) upon connection error, the polling interval increases exponentially until this value. It returns to its initial value once a call to the API passes through                                                             | 60s                                             |\n| `spark.delight.maxWaitOnEndSecs`                        | (Internal config) the time the Spark application waits for remaining payloads to be sent after the event `SparkListenerApplicationEnd`. Not applicable in the case of Databricks                                                          | 10s                                             |\n| `spark.delight.waitForPendingPayloadsSleepIntervalSecs` | (Internal config) the interval at which the object responsible for calling the API checks whether there are new remaining to be sent, after the event `SparkListenerApplicationEnd` is received. Not applicable in the case of Databricks | 1s                                              |\n| `spark.delight.logDuration`                             | (Debugging config) whether to log the duration of the operations performed by the Spark listener                                                                                                                                          | false                                           |\n\n## Frequently Asked Questions\n\nIf you don't find the answer you're loooking for, contact us through the chat window on the bottom right corner of your\nDelight dashboard.\n\n### Is Delight really free?\n\nYes, it's entirely free of charge.\n\n### Is Delight open-source?\n\nDelight consists of two components:\n1. An open-source agent which runs within your Spark applications (as a SparkListener) and streams metrics in real-time to our backend. The code for this agent is on this github repository, so you can audit it and trust it.\n2. A closed-source backend system responsible of collecting, storing, and serving the metrics necessary to Delight, as well as authentication.\n\n### Which data does Delight collect? Is it secure?\n\nDelight collects Spark event logs. This is non-sensitive metadata about your Spark application execution (for example, for each Spark task there is metadata on memory usage, CPU usage, network traffic). Delight does not record any sensitive information (like the data that your application operates on).\n‍\nThis data is encrypted with your access token and sent over HTTPS to the Delight backend. Your access token guarantees that the metrics collected will only be visible to yourself (and to your colleagues, if you signed up with your company's Google account).\n\nThis data is automatically deleted 30 days its collection, and it is not shared with any third party.\n\n### What is the efficiency score visible in the Delight dashboard?\n\nThe efficiency ratio is calculated as the sum of the duration of all the Spark tasks, divided by the sum of the core uptime of your Spark executors.\n\nAn efficiency score of 75% means that on average, your Spark executor cores are running Spark tasks three quarter of the time. A low efficiency score means that you are wasting a lot of your compute resources. The [Ocean for Apache Spark platform](https://spot.io/products/ocean-apache-spark/) automatically tunes your Spark application configurations to make them more efficient!\n\n### Is Delight accessible while the app is running?\n\nNo, at this moment you can only access Delight once your app has completed. This means that Delight is not suited for long-running applications (like interactive clusters staying up 24x7, or streaming jobs).\n\nMaking Delight accessible in real time is on our roadmap.\n\n### I don't have a google account, how can I sign up?\n\nAt this time, the only sign in method is using a Google account. We'll be adding support for login+password authentication in the future.\n\n### How can I invite a colleague to share the same Delight dashboard?\n\nIf you sign up using the same Google organization as your colleague, you will automatically share the same dashboard. You don't need to invite your colleague, they can just sign up and get started.\n\n### What's your log retention? For how long can I access Delight?\n\nThe Delight UI is accessible for 30 days after the app completion. After this time, the logs are deleted.\n\nThere's also a limit of 10,000 apps per customer. If you reach this limit, we will start cleaning up the logs of your oldest apps.\n\n### NoSuchMethodError\n\nI installed Delight and saw the following error in the driver logs. How do I solve it?\n\n```\nException in thread \"main\" java.lang.NoSuchMethodError: org.apache.spark.internal.Logging.$init$(Lorg/apache/spark/internal/Logging;)V\n\tat co.datamechanics.delight.DelightListener.\u003cinit\u003e(DelightListener.scala:11)\n\tat sun.reflect.NativeConstructorAccessorImpl.newInstance0(Native Method)\n\tat sun.reflect.NativeConstructorAccessorImpl.newInstance(NativeConstructorAccessorImpl.java:62)\n\tat sun.reflect.DelegatingConstructorAccessorImpl.newInstance(DelegatingConstructorAccessorImpl.java:45)\n```\n\nThis probably means that the Scala version of Delight does not match the Scala version of the Spark distribution.\n\nIf you specified `co.datamechanics:delight_2.11:latest-SNAPSHOT`, please change to `co.datamechanics:delight_2.12:latest-SNAPSHOT`. And vice versa!\n\n### I'd like to troubleshoot Delight, how can I see its logs?\n\nThe Delight jar attached to your Spark driver produces troubleshooting logs within the Spark Driver logs.\nLook for the class name DelightStreamingConnector. There should be INFO logs printed when your application starts.\n\nIf you don't see these logs, you may need to modify the log4j configuration file used by Spark to add this line:\n```\nlog4j.logger.co.datamechanics.delight=INFO\n```\n","funding_links":[],"categories":["Clojure","Batch Processing","Packages"],"sub_categories":["[Tools](#tools-1)","Monitoring"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdatamechanics%2Fdelight","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdatamechanics%2Fdelight","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdatamechanics%2Fdelight/lists"}