--- title: Starburst Galaxy description: Collect cluster performance metrics from Starburst Galaxy breadcrumbs: Docs > Integrations > Starburst Galaxy --- # Starburst Galaxy Supported OS Integration version1.0.0 Full DashboardQuery ExecutionQuery OutcomesQuery PerformanceResource Utilization ## Overview{% #overview %} Starburst Galaxy is a fully-managed data lakehouse platform built on Trino that lets you query data across 50+ sources without moving or copying it. The platform delivers 6x faster SQL execution and 10x cost savings compared to traditional data warehouses, with built-in governance and support for Apache Iceberg, Delta Lake, and other open table formats. The Starburst Galaxy integration with Datadog enables you to monitor and visualize your Starburst Galaxy cluster metrics directly in your Datadog account. With this integration you can monitor cluster health, query performance, and resource utilization in real time. ## Setup{% #setup %} 1. In the Starburst Galaxy navigation menu, go to **Partner Connect > Observability**. 1. Find **Datadog** in the list of integrations and select the Datadog card. 1. Enter your Datadog **API key** and **Site**. - The API key is tied to your Datadog organization. To create an API key, see the [API and Application Keys documentation](https://docs.datadoghq.com/account_management/api-app-keys/). - The Datadog site corresponds to your Datadog site URL. For more information, see [Getting Started with Datadog Sites](https://docs.datadoghq.com/getting_started/site/). 1. Click **Validate** to test the connection. Starburst Galaxy verifies that the API key is valid and the selected Datadog site is accessible. 1. After validation succeeds, click **Connect**. Metrics appear in your Datadog account within a few minutes. After you enable the integration, the integration status shows as **Connected** in the Datadog panel on Starburst Galaxy's **Partner Connect** page. If you encounter setup issues, contact Starburst support. ### Update Configuration{% #update-configuration %} To rotate API keys or update the integration configuration: 1. In the Datadog panel on the **Partner Connect** page, click the configured integration. 1. Click **Edit connection**. 1. Update the **API key** and **Datadog Site** fields as needed. 1. Click **Validate** to test the new configuration. 1. Click **Update** to save your changes and redeploy the integration. ## Data Collected{% #data-collected %} ### Metrics{% #metrics %} | | | | | **starburst\_galaxy.io\_starburst\_galaxy\_name\_GalaxyMetrics\_AbandonedQueries**(count) | Total number of queries that were abandoned*Shown as unit* | | **starburst\_galaxy.io\_starburst\_galaxy\_name\_GalaxyMetrics\_CanceledQueries**(count) | Total number of queries that were canceled*Shown as unit* | | **starburst\_galaxy.io\_starburst\_galaxy\_name\_GalaxyMetrics\_CompletedQueries**(count) | Total number of queries that have completed successfully*Shown as unit* | | **starburst\_galaxy.io\_starburst\_galaxy\_name\_GalaxyMetrics\_ExecutionTime.count**(gauge) | Number of query execution time samples collected*Shown as unit* | | **starburst\_galaxy.io\_starburst\_galaxy\_name\_GalaxyMetrics\_ExecutionTime.quantile**(gauge) | Query execution time at specified quantile*Shown as millisecond* | | **starburst\_galaxy.io\_starburst\_galaxy\_name\_GalaxyMetrics\_ExecutionTime.sum**(gauge) | Total sum of all query execution times*Shown as millisecond* | | **starburst\_galaxy.io\_starburst\_galaxy\_name\_GalaxyMetrics\_ExecutionTimeOneMinute.count**(gauge) | Number of query execution time samples in the last minute*Shown as unit* | | **starburst\_galaxy.io\_starburst\_galaxy\_name\_GalaxyMetrics\_ExecutionTimeOneMinute.quantile**(gauge) | Query execution time at specified quantile for the last minute*Shown as millisecond* | | **starburst\_galaxy.io\_starburst\_galaxy\_name\_GalaxyMetrics\_ExecutionTimeOneMinute.sum**(gauge) | Total sum of query execution times in the last minute*Shown as millisecond* | | **starburst\_galaxy.io\_starburst\_galaxy\_name\_GalaxyMetrics\_FailedQueries**(count) | Total number of queries that have failed*Shown as unit* | | **starburst\_galaxy.io\_starburst\_galaxy\_name\_GalaxyMetrics\_FreeDistributedBytes**(gauge) | Free distributed memory available across all cluster nodes*Shown as byte* | | **starburst\_galaxy.io\_starburst\_galaxy\_name\_GalaxyMetrics\_InternalFailures**(count) | Total number of internal system failures*Shown as unit* | | **starburst\_galaxy.io\_starburst\_galaxy\_name\_GalaxyMetrics\_QueuedQueries**(gauge) | Number of queries currently queued waiting for execution*Shown as unit* | | **starburst\_galaxy.io\_starburst\_galaxy\_name\_GalaxyMetrics\_QueuedTime.count**(gauge) | Number of query queue time samples collected*Shown as unit* | | **starburst\_galaxy.io\_starburst\_galaxy\_name\_GalaxyMetrics\_QueuedTime.quantile**(gauge) | Query queue time at specified quantile*Shown as millisecond* | | **starburst\_galaxy.io\_starburst\_galaxy\_name\_GalaxyMetrics\_QueuedTime.sum**(gauge) | Total sum of all query queue times*Shown as millisecond* | | **starburst\_galaxy.io\_starburst\_galaxy\_name\_GalaxyMetrics\_QueuedTimeOneMinute.count**(gauge) | Number of query queue time samples in the last minute*Shown as unit* | | **starburst\_galaxy.io\_starburst\_galaxy\_name\_GalaxyMetrics\_QueuedTimeOneMinute.quantile**(gauge) | Query queue time at specified quantile for the last minute*Shown as millisecond* | | **starburst\_galaxy.io\_starburst\_galaxy\_name\_GalaxyMetrics\_QueuedTimeOneMinute.sum**(gauge) | Total sum of query queue times in the last minute*Shown as millisecond* | | **starburst\_galaxy.io\_starburst\_galaxy\_name\_GalaxyMetrics\_RunningQueries**(gauge) | Number of queries currently running on the cluster*Shown as unit* | | **starburst\_galaxy.io\_starburst\_galaxy\_name\_GalaxyMetrics\_TotalDistributedBytes**(gauge) | Total distributed memory available across all cluster nodes*Shown as byte* | | **starburst\_galaxy.io\_starburst\_galaxy\_name\_GalaxyMetrics\_UserErrorFailures**(count) | Total number of failures due to user errors*Shown as unit* | | **starburst\_galaxy.io\_starburst\_galaxy\_name\_GalaxyMetrics\_ActiveNodeCount**(gauge) | Number of nodes currently active and processing queries*Shown as unit* | | **starburst\_galaxy.io\_starburst\_galaxy\_name\_GalaxyMetrics\_InactiveNodeCount**(gauge) | Number of nodes currently inactive*Shown as unit* | | **starburst\_galaxy.io\_starburst\_galaxy\_name\_GalaxyMetrics\_DrainingNodeCount**(gauge) | Number of nodes currently draining and will not accept new queries*Shown as unit* | | **starburst\_galaxy.io\_starburst\_galaxy\_name\_GalaxyMetrics\_DrainedNodeCount**(gauge) | Number of nodes that have been drained and are no longer processing queries*Shown as unit* | | **starburst\_galaxy.io\_starburst\_galaxy\_name\_GalaxyMetrics\_ShuttingDownNodeCount**(gauge) | Number of nodes currently shutting down*Shown as unit* | | **starburst\_galaxy.io\_starburst\_galaxy\_name\_StreamingIngest\_RecordsLagMax**(gauge) | Maximum lag in records for streaming ingest operations*Shown as unit* | | **starburst\_galaxy.io\_starburst\_galaxy\_name\_StreamingIngest\_UncompressedReceivedBytesTotal**(gauge) | Total uncompressed bytes received through streaming ingest*Shown as byte* | ## Uninstallation{% #uninstallation %} ### In Starburst Galaxy{% #in-starburst-galaxy %} 1. In the Datadog panel on the **Partner Connect** page, click on the configured integration. 1. Click **Delete connection**. 1. Confirm the deletion when prompted. When deactivated, the integration status in the panel shows as **Inactive**. ### In Datadog{% #in-datadog %} 1. Navigate to the Starburst Galaxy integration tile. 1. Click **Uninstall** to remove the included dashboard. ## Support{% #support %} Need help? Contact [Starburst Support](https://www.starburst.io/learn/support/).