ChangeLog (PATCH)

Patch for and Fixes a regression introduced in for clusterSnapshotBronze. This patch also updates the static cloud VM instance details.


We recommend that regardless which version you’re upgrading from, you run the following upgrade script to update your instance details table.

Released June 21st, 2024 - Full Change Inventory (PATCH)

Patch for Fixes a regression introduced in for clusterSnapshotBronze. This patch also adds a validation rule so that the driver workspace doesn’t specify a sql_endpoint in the configuration file.

  • If you did not run 0810, you can simply swap the jar.
  • If you previously ran you must run the following repair script to correct data in clusters_snapshot_bronze. If you don’t you might receive schema merge errors in clusterSnapshot bronze module.

Released May 22nd, 2024 - Full Change Inventory

In this release we made some changes that address key data quality issues, to ensure we are collecting all the data and to improve our parallel cluster utilization calculations. As a result of these changes, you will see more data in jobruncostpotential_fact and clusterstatefact_gold since we’re also bringing in jobs that run on serverless compute or DLT clusters. Now, Overwatch still doesn’t support cost calculations for either serverless or DLT, but you will at least be able to see those jobs’ performance metrics and monitor their utilization.


There are no mandatory changes in this release, you can simply swap the jar, and Overwatch will run normally. Now, it is recommended that you run this script, given that the changes in this release try to mitigate changes in the source Databricks APIs that could lead to some data loss for some clusters details.

Upgrade script: HTML | DBC

Also, remember to upgrade the jar version used in your Optimizer job :)

Bug Fixes

  • Created a workaround for generating the Clusters snapshot table, since we were using the clusters/list API endpoint, which now has started enforcing limits to the number of clusters returned
  • Improved logic to include late-arriving cluster events
  • Revamped the logic for splitting cluster usage and dbu share per job tasks when they are ran in parallel on the same cluster

Released May 8th, 2024 - Full Change Inventory (Patch)

Fixed a bug when creating Warehouse dimension during the very first run

Released March 21st, 2024 (Major Release)


There are no mandatory changes in this release, you can simply swap the jar if you’re not migrating Audit logs to read from system tables. We’ve created a script to help you in migrating your deployment configuration to system tables, if you choose to do so.

Upgrade script: HTML | DBC

Major Feature

  • First integration with System Tables! Now Overwatch can collect audit logs directly from System Tables. You can find the docs here

Bug Fixes

In this version there were many bug fixes, as well as the development of internal tooling to help us validate new releases. Some of the most notable bug fixes include:

  • Created a workaround for cases when job clusters are missing terminating cluster events. This fix is very important as it will improve the accuracy of the data. We recommend that you rollback and backprocess the data for modules 2019, 3005 and 3015. If you need a step by step guide on how to do this, follow the steps here
  • Improve error handling for empty upstream sources for Gold_SparkStream, NotebookCommands, and SilverWarehouseSpec
  • Fixed Helpers.getWorkspaceByDatabase which was broken for retrieving remote workspaces
  • Performance improvements for NotebookCommands
  • Added a notebook for troubleshooting configuration issues under Troubleshooting

Released Jan 25, 2024 - Full Change Inventory (Patch)

This patch addresses some critical fixes. If you ran versions 0721 or 0722, you need to run the upgrade script in order to repair the data.

Upgrade script: HTML | DBC

Bug Fixes

  • Fixed lookup to ensure NotebookCommands there are no NULL notebook_ids in NotebookCommands
  • There are some new services available in EventHub that if activated, would send duplicated audit log columns.
  • Improve performance of WarehouseSpec table and resolve schema discrepancies in Warehouse Gold which would lead to failures
  • Improves the coverage of job_run_cluster_util by ensuring we can also compute it for jobs submitted using SparkSubmit
  • (Dashboard bug) Fix to metric “DBU Spend by the top 3 expensive Interactive clusters” in Clusters dashboard
    • Find the updated version here

Released Oct 31st, 2023 - Full Change Inventory

This release contains a change to how we query the Databricks Jobs API, to prevent failures, given that the API is changing from offset based pagination, to token based.

To Upgrade, if you’re currently running Overwatch v0. onwards, simply swap the JAR. If you’re in a previous version, contact your Databricks representative.

Bug Fixes

  • Updated Jobs API queries to use token based pagination
  • Fixed an issue in the Optimizer code that would show up if the driver workspace was not in the list of workspaces to be optimized
  • Updated GCP instance details to the correct API Names

Released Oct 5th, 2023 - Full Change Inventory


Although there are no breaking schema changes with this release, we recommend you run the upgrade script to:

  • Update your instance details to the latest available data
  • (GCP ONLY) Process all the remote workspaces cluster logs, which you weren’t able to do until this release.

Upgrade script: HTML | DBC

Major Features

  • Warehouse dimension now available
    • Schema is available here
  • NotebookCommands table now available
    • Customers will now be able to see metrics for each command run on every notebook in your workspace, including estimated costs
    • Support is limited to Notebooks run on clusters for now. Notebooks run on warehouses will be supported soon
    • Schema is available here
    • It requires Verbose Audit Logging to be enabled in each workspace that needs to be monitored
  • Customers can now Snapshot, Restore, and Migrate their Overwatch data in a few clicks. Read more info about it here
  • Updated Azure and GCP instanceDetails node types to include all new supported node types as of August 24, 2023.
  • Released the first set of pre-canned dashboards
    • You can find them here

Key Bug Fixes

  • (GCP) Capture cluster logs for remote workspaces
  • Captured cluster changes when they are only resized when running
  • Improved logic for detecting job/automated clusters in JRCP
  • Ensured AutoOptimize is set for tables that needed
  • Fixed bug where all error messages were printing to “API Call” incorrectly
  • When Bronze_Clusters_Snapshot didn’t have data then Bronze_SparkEventLogs was failing
  • Fixed bug when converting data from Struct to map where keys had multiple periods in it

Released Sept 11th, 2023 - Full Change Inventory (Patch)

To Upgrade, simply swap the JAR

Bug Fixes

  • Fixed schema issue while merging in job_status_silver (Deprecated)

Pulled forward all bug fixes from 0715

To Upgrade, simply swap the JAR

Bug Fixes

  • PVC - instanceId and containerId duplicate columns in audit_log_bronze handled

Released Aug 3rd, 2023 - Full Change Inventory (Deprecated)

Pulled forward all bug fixes from 0714

To Upgrade, simply swap the JAR

Full Change Inventory (Patch)

Bug Fix - mount_mapping_path was being ignored

Only customers using multi-workspace deployments with remote workspaces with > 50 mounts and using mount_mapping_path will be affected.

To Upgrade, simply swap the JAR


There were a few column name changes to the config file (multi-workspace). Please run this script to update your config file if upgrading from 071x multi-workspace deployment. HTML | DBC

Major Features

  • Enablement for GCP
    • Overwatch can now be deployed on Google Compute. The process is identical to AWS
  • Enablement for Unity Catalog
    • Customers can now deploy to either Hive Metastore or Unity Catalog (UC)
    • To deploy to UC follow the guide for Deploying To Unity Catalog
    • To migrate existing Hive Metastore deployments to a UC, follow the Migrating To UC guide
  • Enablement for Event Hub Auth via AAD in multi-workspace deployments
  • Search enabled for docs
  • Updated instanceDetails node types to include all new supported node types as of April 12, 2023.

Key Bug Fixes

  • Single Tenant Multi-Workspace None.get issue for workspaceID
  • Pipeline output showing 0 Output Rows for merged tables | Issue 692
  • (Azure) When Event Hub Library Dependency is missing / corrupted kill bronze pipeline properly

Full Change Inventory (Patch)

To Upgrade, simply swap the JAR

Bug Fixes

  • Fixed schema issue while merging in job_status_silver
  • PVC - instanceId and containerId duplicate columns in audit_log_bronze handled

Released Aug 3rd, 2023 - Full Change Inventory (Deprecated)

To Upgrade, simply swap the JAR


  • Backported AAD Authentication for Event Hubs
  • Added support for permanently deleted clusters
    • Costs will now stop accumulating for permanently deleted clusters

Bug Fixes

  • api calls / job_status_silver - Added lag overlap to handle late arriving events
  • getOrgID fix for single-tenant and PVC backported from 072x
  • PVC - shardName duplicate column in audit_log_bronze handled
  • Only promote crud events for successful events (clusters / jobs / notebooks)
  • Spark Events Bronze - AWS Remote workspaces with s3:// direct logging paths empty
  • Spark Executor Table - empty
  • Spark Tasks – end timestamp nulls

Full Change Inventory

  • Data Quality Fixes - primarily around cost and utilization
  • Upgrade Process
    • Swap the Jar – that’s it – all new data will be built with these corrections
    • (Optional) Run Historical Data Repair script HTML | DBC
      • If you want to rebuild historical data, run the script above and Overwatch’s subsequent run will rebuild the necessary tables
    • (Optional) Since one of the bug fixes is changing the job run start timestamp, subsequent Overwatch runs can result in duplicate records for job runs. If you experience this you can run the following script once to eliminate duplicate runs. You only need to run this once per deployment (i.e. storage prefix) it will properly dedup all records from all workspaces in the targets. You only need to run this one time after you experience job run duplicates. Note that you will not experience duplicates until after you execute the 0713+ Overwatch Pipeline. The notebook has a check in it to determine whether you’ve experienced this issue.

Bug Fixes

  • DBU Photon Costs for Automated workloads
    • DBU multiplier updated
  • Single Node DBUs & Cost Calculations
    • Overwatch was showing 0 DBUs and $0 costs for workers but since the worker is the driver this is not accurate
  • Job Task Run - Start Timestamp
    • The task_runtime was referencing “submission_time” instead of “start_time” but it turns out that Databricks does not publish the task start time and all job tasks get submitted at the same time; thus start_time must be used.
  • Job Run Cost Potential Fact - (JRCP) Cluster Utilization
    • Due to the taskRun timestamp issue in the last bullet and a miscalculation for concurrent jobs running on a single cluster the cluster utilization in JRCP could be off – this was resolved and should now be accurate.
  • Cluster name / id imputes can incorrect in certain scenarios

Full Change Inventory

  • Fixes bugs from 0711 that may affect workflow

Full Change Inventory (Deprecated)

USE 0712 Version Bug Fixes Plus a Few New Features

Upgrade Script – Simple but necessary script to be run once per Overwatch Deployment (i.e. storage prefix) the details of script are in the script.

Noteworthy Bug Fixes

  • Significant Improvement in DBU / Cost calculations
    • DBU calculation accuracy improvement (especially for Photon clusters)
  • Significant Performance improvements
  • Delayed log arrival now ingested properly
  • Completeness of first-run record initialization

Noteworthy New Features

  • Remote workspaces with >50 mounts supported
  • Several new bronze tables
    • job_runs_snapshot_bronze – Experimental
    • libs_snapshot_bronze
    • policies_snapshot_bronze
    • instance_profiles_snapshot_bronze (AWS)
    • tokens_snapshot_bronze
    • global_inits_snapshot_bronze
  • Multi-workspace config delta compatible now (instead of only CSV)
    • Allows simple updates to config without download/upload of new config CSV
  • Threaded spark session to avoid collisions
  • Table locking for parallel workspace ingestion (avoids delta concurrent write errors)

Full Change Inventory (0711)

Multi-Workspace Deployments Are Here!!

If you’re tired of managing and maintaining Overwatch jobs on all your workspaces, be tired no more. Migrate your configurations to the new, enhanced configuration method and simplify your deployment with this release. Existing customers wanting to migrate to this deployment method, START HERE


You must be running 0.7.0.x before upgrading to this version. No upgrade script is required but steps are required to migrate to the new deployment method.

Additional Changes

  • Enhanced Documentation
  • Enhanced API Manager
  • Updated Default hourly DBUs and Node Pricing
  • Upgrade to DBR 11.3LTS as default DBR
  • Performance Improvements
  • Photon Tested and Validated with significant efficiency gains (in most cases)

Full Change Inventory (PATCH)

Patch for Fixes a regression introduced in for clusterEventsBronze. This patch also promotes total_dbus field to JRCP table.

  • If you previously ran you must run the following repair script to correct data in cluster_events_bronze. If you don’t you will receive schema merge errors in clusterEvents bronze module. If you did not run 07004, you do not need to run this script. (PATCH)

This is a patch for There were a few issues identified with 0.7.0 by our early movers. This patch is the same as 0700 with the bug fixes closed in PR 633.

  • This update includes all bug fixes published in 07003.
  • No upgrade needed - the Jars may simply be swapped out – do this on all workspaces.
  • If you were affected by one of the issues fixed in the PR above and you would like to repair the historical data, please do so using this script. Instructions are in the notebook. HTML | DBC

Bug Fixes

  • Bug fix related to dbu utilization and cost calculation Issue 632.
  • Bug fix related to sqlQueryHistory Issue 625. (PATCH)

This is a patch for There were a few issues identified with 0.7.0 by our early movers. This patch is the same as 0700 with the bug fixes closed in PR 602.

  • This update includes all bug fixes published in 07002
  • No upgrade needed - the Jars may simply be swapped out – do this on all workspaces
  • If you were affected by one of the issues fixed and you would like to repair the historical data, please do so using this script. Instructions are in the notebook. HTML | DBC (PATCH)

This is a patch for There were a few issues identified with 0.7.0 by our early movers. This patch is the same as 0700 with the bug fixes closed in PR 580.

  • This update includes all bug fixes published in 07001
  • No upgrade needed - the Jars may simply be swapped out – do this on all workspaces
  • If you were affected by one of the issues fixed in the PR above and you would like to repair the historical data, please do so using this script. Instructions are in the notebook. HTML | DBC (PATCH)

This is a patch for There were a few issues identified with 0.7.0 by our early movers. This patch is the same as 0700 with the bug fixes closed in PR 559. (Major Release)

Please use PATCH from maven. Everything in this release stands

0700 Upgrade Script HTML | DBC

Major Changes

  • Support for Multi-Task Jobs (MTJs)
    • Prior to this release Overwatch was unable to properly analyze and display jobs with multiple tasks and, at times even struggled to properly display new-format single-task jobs
    • As this is a major change, there are significant changes in the jobs tables in silver and gold
    • Production Dashboards should be validated/updated in non-prod 0.7.0 deployment as there will likely be some changes to column naming, typing, and structures. For details on the new schema, see the Data Dictionary
  • Support for Job Clusters
  • Jobs 2.1 API Support
    • Databricks Jobs team has migrated to API 2.1 and now so has Overwatch. This resolves some data gaps as well as API capacity issues
  • Support for DBSQL Query History Including Metrics
    • DBSQL Query History is our first step into first-party support for DBSQL. Warehouses are expected to follow shortly but was unable to make the cut for this release
    • Be sure to enable the new scope “dbsql” or use the new 0.7.0 Runner Notebook to ensure you’re loading the DBSQL tables if your workspace[s] are using DBSQL.
    • Limitation - Databricks does not publish Warehouse events yet and as such, explicit cost anlaysis is not yet possible for DBSQL. As soon as this is made available the Overwatch Dev team will begin work to integrate it.
  • Photon Costs Attributed in CLSF and JRCP
    • Photon cost calculations have been integrated into Overwatch.
    • By default the Photon costs will begin being applied after the upgrade date. If you want to retroactively apply this change you can by rolling back and rebuilding the following tables as this is not automatically handled in the upgrade (some customers don’t want to see that change in their historical reports)
      • cluster_spec_silver
      • clusterstatefact_gold
      • jobruncostpotentialfact_gold
  • New API Manager
    • The API management libraries were completely rebuilt from the ground up to maximize throughput, capabilities, and safety for your environment.
    • The new API manager offers users much deeper control on how Overwatch uses the APIs. See the APIEnv Configs on the Configurations details page.
  • Support for Authenticated PROXY
    • Most customers are able to configure proxies with cluster configs and init scripts but Overwatch now offers deeper, first-party suppot for authenticated Proxy configs. See more details in the APIEnv Configs section.
  • SparkJob User-Email Coverage & Accuracy
    • User_Email in sparkJob table now has complete coverage but may require some action
      • The user_email had incompletions and inaccuracies. Databricks was not publishing the user data for users using Python and R languages. This has now been resolved automatically for clusters (operational clusters not the Overwatch cluster) running DBR 11.3+. To enable this feature on <= DBR 11.2 clusters a config must be added to the cluster. See the FAQ 9 for details on how to ensure you’re getting complete coverage for this field.
  • Multi-Workspace Deployment (DELAYED)
    • Allows customers to deploy, manage, and run Overwatch from a single Workspace while still collecting data from several.
    • Provides unified global configuration via Excel / Delta tables
    • While many customers are eagerly awaiting this feature and the dev team thought it could be released as part of this major release; unfortunately, due to some complications this wasn’t possible but should be out in the coming weeks and isn’t expected to need any sort of “upgrade”, it should be just a JAR swap.
      • More details and full documentation coming soon.

Bug Fixes

  • Biggest fix is with regard to data quality surrounding multi-task jobs and job-clusters. This should all be resolved at this point.

Full list of bug fixes for this release can be found here (Maintenance Release)

To upgrade from, simply swap the JAR from to this version, no upgrade script necessary

  • Enhancements

    • Extreme performance improvement (~75% for large workspaces) for several of the largest silver/gold modules.
    • Increased reliability on AQE for further perf improvements
    • Perf improvements for CLSF windows
    • Bronze workspace snapshot helper function created to backup bronze
    • Duplicates hunter / dropper functions enabled
  • Bug Fixes

    • Full list of bug fixes for this release can be found here (Upgrade Release)

Upgrade Process Required for existing customers on 0.6.0.x The upgrade is small and quick but is very important. Some new Databricks features have resulted in some unsafe columns (i.e. complex unbound structs) in bronze; thus, these need to be converted to map types to reduce schema cardinality. There are three tables affected and the details can be found in the upgrade script linked below.

You are strongly urged to upgrade DBR version to 10.4LTS (from 9.1LTS). If you do not upgrade DBR to 10.4LTS, the upgrade can be quite compute intensive due to the need to fully rebuild one of the largest tables, spark_events_bronze. A new feature called, column mapping is available in 10.4LTS that doesn’t require a full table rebuild. The caveat is that all future reads/writes to this table require 10.4LTS+. The ONLY customers not upgrading to 10.4LTS should be those with a legitimate business blocker for upgrading to 10.4LTS.

When upgrading to 0.6.1 using 10.4LTS all future reads/writes to bronze table spark_events_bronze will require a cluster with DBR 10.4LTS+

  • 0610 Upgrade Script - 10.4LTS HTML | DBC
  • 0610 Upgrade Script - 9.1LTS HTML | DBC

For questions / issues with the upgrade, please file a git ticket

  • Noteworthy Features
    • Add Overwatch databases and contents to a workspace not running Overwatch (i.e. remote only)
    • Ability to specify custom temporary working directories
      • Used to default to a dir in /tmp but due to some root policies allowing it to be overridden for more details see Configs
    • Pipeline Management simplifications
  • Major Fixes
    • Data Quality Enhancements
    • Pipeline edge case stability improvements

The full list of fixes can be found on the 0610 Milestone (Maintenance Release)

  • Bug fixes
    • Issue 305 - Silver_jobStatus timeout_seconds schema type
    • Issue 308 - Optimize job could get the wrong workspace credentials in some cases
    • Issue 310 - SparkJob table, many nulled fields
    • Issue 313 - Silver_ClusterStateDetail - no column autoscale (Deprecated)

If an issue is found in this version, please try the latest 0.6.x version, if the issue persists, please open a git ticket

  • Fixes regression found in 0602
    • Issue 297
    • If you are affected, please use the script linked below to cleanup the historical data. If you’d like assistance, please file a git ticket and someone will review the process with you.
  • Minimum Events for Azure audit log stream ingest – improvement for very busy workspaces
  • Resolves issue where “init_scripts” field is missing
    • Workspaces that have never had a cluster with an init script could hit this issue
  • Performance Improvement for Azure Audit log ingestion
  • Improved Schema enforcement
  • Fix for ArrayType minimum schema requirements – DEPRECATED – DONT USE

Contains data quality regression - See Issue 297 Several bug fixes - mostly edge cases

A full list of resolutions can be found here (MAJOR UPGRADE/RELEASE)

Existing Customers on 0.5.x –> 0.6.x UPGRADE PROCESS REQUIRED

  • Upgrade process detailed in linked upgrade script HTML | DBC

Notice – 0.6.0 had a concurrent merge conflict for some multi-workspace deployments described in issue 284. When upgrading to 0.6 please use as the base version, 0.6.0 shouldn’t be used.

Noteworthy Features

  • Custom workspace names
  • Upserts - Previous versions only appended data which meant that the run / clusterState / etc had to end before the Overwatch job would pick it up. Now Overwatch utilizes delta upserts/merges so all data comes into the pipeline anchored on start_time not end_time.
  • Numerous and Significant Schema enhancements in Gold/Consumer layer
    • Increases resiliency and simplifies analysis
  • New Entities in Consumer Layer
    • InstancePools
    • Streams (preview) – Releasing as preview to get more feedback and improve structure for use cases.
    • DBSQL - slipped – DBSQL entities did not make it to gold in 0.6.0 but are staged to be released in next minor release
  • Separated node (compute) contract costs from dbu contract costs
    • DBU costs by sku slow-changing-dimension added (dbuCostDetails)
    • Old instanceDetails table greatly simplified. Name is still the same, only the structure changed
  • Enabled externalized optimize & z-order pipelines
    • This was and is baked into the Overwatch process but as of 0.6.0 users can decide to externalize this. This
      is powerful as it allows the Overwatch pipeline to be more efficient and the Optimize/Zorder job to be completed from a single workspace with the appropriate cluster size/configuration for the workload.
  • Gold Table Initializations
    • In previous version there were often significant gaps in early runs of Overwatch as the objects that create the slow-changing-dims weren’t created/edited thus were absent from the audit logs. The APIs are now used to get an initial full picture of the workspace and that is merged with the audit logs to jump-start all records for early runs of Overwatch
  • Error Message Improvements
    • The error messaging pipelines have been signficantly improved to provide more useful and specific errors
  • All tables fully externalized to paths
    • Enables finer-grained security for multi-workspace environments also brings numerous data quality enhancements, performance optimization, and resolves several outstanding bugs

Please note that pipelines may run a bit longer in some cases as we are now executing merges instead of appends. Merges are a bit more compute intensive and future optimizations are already in the works to minimize the increase. The increases were marginal but noteworthy.

A more complete list of features and improvements can be found on the closed features/bugs list of Milestone 0.6.0

Version 0.5.x NOTE

If you’re on 0.5.x and not ready to upgrade to 0.6.0 yet, and you’re not on the latest version of 0.5.x please do upgrade to the latest 0.5.x as 0.5.x will no longer be receiving feature updates and is considered stable at the latest version. No upgrade necessary, just swap the JAR to the latest version of 0.5.x and everything will work even better.

Regarding Deprecated Versions

Please note that we’re a pretty small team trying to keep up with a wide customer base. If the version you’re on shows deprecated, please note thta it doesn’t mean that we won’t try to offer assistance, just that we may first ask that you swap the jar out to the latest version of 0.5.x before we do a deep dive as many of the issues you may face are already resolved in the later version. Please do upgrade to the latest release as soon as possible.

Apologies for the insanity of the version number – will be better in future

  • Patch for Issue_278
    • Databricks published some corrupted log files. These log files had duplicate column names with upper and lower case references. This was promptly resolved on the Databricks side but the logs were not retroactively created; thus, if you hit the error below using 0506 or earlier, you will need to switch to this JAR for your pipeline to continue.

AnalysisException: Found duplicate column(s) in the data schema: <column_name>

  • Patch for Issue_235
    • Edge cases resulted in nulls for several values in clusterstatefact. - deprecated

  • Feature Feature_223
    • Adds package version to parsed config in pipeline_report
  • Patch fix for Issue_210
  • Patch fix for Issue_214
    • Important fix for Spark Users – this bug resulted in several spark logs not getting ingested
  • Patch fix for Issue_218
    • Potential duplicates for api call “RunNow”
  • Patch fix for Issue_221
    • Multi-workspace enhancements for validations
    • Altered DBU Costs fix
  • Patch fix for Issue_213
    • Reduced plan size for jobRunCostPotentialFact table build
  • Patch fix for Issue_192
    • Some spark overrides in the Overwatch pipeline were not getting applied
  • Patch fix for Issue_206
    • Incorrect default prices for several node types - deprecated

  • Patch fix for Issue_196
  • AZURE - Enhancement - Enable full EH configuration to be passed through the job arguments to the main class using secrets / scopes – Issue_197 - deprecated

BUG FOR NEW DEPLOYMENTS When using for a brand new deployment, a duplicate key was left in a static table causing a couple of gold layer costing tables to error out. If this is your first run, the following is a fix until comes out with the fix.

  • Initialize the Environment – note this is the standard getting started process. The only difference is to stop after Bronze(workspace) and not continue.
    • Execute through “Bronze(workspace)” DO NOT RUN THE PIPELINE (i.e. Don’t use Bronze(workspace).run()), just initialize it.
  • Execute the following command in SQL to delete the single offending row. Remember to replace <overwatch_etl> with your configured ETL database
delete from <overwatch_etl>.instancedetails where API_Name = 'Standard_E4as_v4' and On_Demand_Cost_Hourly = 0.1482
  • Resume standard workflow

Bug Fixes

  • Incremental input sources returning 0 rows when users run Overwatch multiple times in the same day
  • Incremental clusterStateFactGold – addresses orphaned events for long-running states across Overwatch Runs.
  • null driver node types for pooled drivers
  • Improved instance pool lookup logic
  • Mixed instance pools enabled
  • basic refactoring for sparkOverrides – full refactor in 0.5.1
  • Improved logging
  • Costing - node details lookups for edge cases – there was a bug in the join condition for users running Overwatch multiple times per day in the same workspace - deprecated

If upgrading from Overwatch version prior to 0.5.0 please see schema upgrade requirements

  • Hotfix release to resolve Issue 179.
    • clusterstatefact_gold incremental column was start_timestamp instead of end_timestamp. Meant to roll this into but it got missed, sorry for the double release. - deprecated

If upgrading from Overwatch version prior to 0.5.0 please see schema upgrade requirements

  • Hotfix release to resolve Issue 170.
  • Hotfix to resolve laggard DF lookups required to join across pipeline runs.
    • Caused some events to not be joined with their lagging start events in the data model.
  • Hotfix to enable non-json formatted audit logs (AWS) primarily for PVC edge cases

0.5.0 - deprecated

Upgrading and Required Changes

  • SCHEMA UPGRADE REQUIRED - If you are upgrading from 0.4.12+ please use Upgrade.UpgradeTo0420 If upgrading from a schema prior to 0.4.12, please first upgrade to 0.4.12 and then to 0.4.2. The upgrade process will be improving or going away soon, please bear with us while we improve this process.
import com.databricks.labs.overwatch.utils.Upgrade
val upgradeReport = Upgrade.upgradeTo042(<YOUR WORKSPACE OBJECT>)

The schema versions have been tied to the release versions until 0.5.0, this divergence was intentional. A schema version should not == the binary release version as changes to the schema should be much more infrequent than binary releases. Rest assured binary v0.5.0 requires schema version 0.4.2. Please upgrade to 0.4.2 as noted above using the 0.5.0 binary but before the pipeline is executed.

  • Launch Config Change - Note the difference in the Initializer for 0.4.2. The following change is ONLY necessary when/if instantiating Overwatch from a notebook, the main class does not require this change. Sorry for the breaking change we will try to minimize these everywhere possible
// 0.4.1 (OLD)
val workspace = Initializer(Array(args), debugFlag = true)
// 0.4.2+ (NEW)
val workspace = Initializer(args, debugFlag = true)

Major Features & Enhancements

Below are the major feature and enhancements in 0.4.2

  • Getting Started Example Notebooks
  • Kitana
    • Testing framework, currently meant for advanced usage, documentation will roll out asap.
  • Intelligent scaling
  • Audit Log Formats (AWS)
    • For AWS the input format of the audit logs is now configurable to json (default), delta, parquet
  • Contract costs through time
    • Changes to the instanceDetails table now allows for the tracking of all costs through time including compute and DBU. To recalcuate associated costs in the gold layer, the jobRunCostPotentialFact and clusterStateFact table will need to be rolled back as per the documents in Pipeline_Management
  • DBU Contract Costs for DatabricksSQL and JobsLight added
    • Costing for additional SKUs were added to the configuration such that they can be tracked. Note that as of 0.4.2 release, no calculation changes in costing as it relates to sku have yet been incorporated. These recalculations for jobs light and DatabricksSQL are in progress.
  • Enabled Main class execution to execute only a single layer of the pipeline such as bronze / silver / gold. Primarily enabled for future enablement with jobs pipelines and for development / testing purposes.
    • User can now pass 2 arguments to the databricks job where the first is ‘bronze’, ‘silver’, or ‘gold’ and the second is the escaped configuration string and only that pipeline layer will execute.
  • Event Hub Checkpoint - Auto-Recovery (Azure)
    • Previously, if an EH state was to get lost or corrupted, it was very challenging to resume. Overwatch will now automatically identify the latest state loaded and resume.
  • Support non-dbfs file types such as abfss://, s3a://, s3n:// etc. for audit log source paths and output paths. All file types supported on Databricks should now be supported in Overwatch.

Minor Bug Fixes / Enhancements

  • Unsafe SSL allowed Issue 152. All API connections will first be attempted using standard SSL but will fallback on unsafe if there is a SSLHandshakeException. Targeted at specific scenarios.
  • ERD Updates for accuracy
  • Issue resolved where not all cluster logs were being loaded thus several spark log events were missing
  • Various schema errors in edge use cases
  • Docs updates and ehancements

Additional Fixes

  • non-dbfs uris for cluster logs (i.e. s3a://, abfss://)
  • intelligent scaling calculation
  • improved errors for access issues with api calls
  • unsafeSSL fallback optimization and bug fix
  • elementType implicit casting to target schemas within arrays
  • aws - non-json formatted audit logs schema unification
  • api schema scrubber improvements for addtional edge cases

0.4.2 - deprecated

  • Deprecated release - please use 0.5.0
  • The 0.4.2 can be viewed as an RC for 0.5.0. The 0.5.0 release is the 0.4.2 release with several bug fixes

0.4.13 - deprecated

An upgrade to this minor release is only necessary if you’re experience api limits and/or seeing 429 issues. Otherwise, this release can be skipped as the fix will be in 0.4.2+. New users should use this version until the next release is published.

0.4.12 - deprecated


  • Hotfix for Issue 126.
  • Hotfix for Issue 129.
  • Schema upgrade capability enabled.
    • Please follow the upgrade documentation to complete your upgrade
    • Upgrade function name == Upgrade.upgradeTo0412
  • Corrected case sensitivity issue. When failure would occur in spark_events_bronze, there were column references to state tables with mismatched column name case sensitivity causing errors
  • Corrected issue with missing quotes around update statement to track failed files in spark_events_processedFiles

0.4.11 - deprecated

  • Hotfix for Issue 119. Issue was only present in edge cases. Edge cases include workspaces missing data and attempting to run modules for which data didn’t exist.
  • Added additional guard rails to pipeline state checks to help clarify workspace / pipeline state issues for future users.

0.4.1 - deprecated

  • Converted all delta targets from managed tables to external tables
    • Better security and best practice
    • Enabled etl data path prefix to simplify and protect the raw data across workspaces
  • pipeline_report - enabled partitioning by “organization_id”
    • Necessary to guard against write concurrency issues across multiple workspaces
  • orgianization_id - Single Tenant AWS workspaces with DNS would return “0” for organization_id, updated to change organization_id to the workspace prefix.
  • instanceDetails -
    • Converted from append mode to overwrite mode. Allows for multiple workspaces to create the compute pricing lookup if it didn’t already exist for the workspace
    • Moved default table location from consumerDB to ETLDB and created mapped view to table in consumerDB
    • Simplified the instanceDetails cost customization process (docs updated)
    • Added proper filter to ensure ONLY current workspace compute costs are looked up during joins
    • Converted Azure example Memory_GB to double to match data type from AWS
  • Bug fix for JSON to Map that caused certain escaped json strings to break when being pulled from the new Jobs UI
  • Bug fix for Issue 111
  • Bug fix for multi-workspace Azure, filter from audit_raw_land table was incomplete
  • Bug fix to allow for consumerDB to be omitted from DataTarget in config

0.4.0 - deprecated

Initial Public Release