Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 7 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,13 @@
All notable changes to this project will be documented in this file.
See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.

## [1.7.23](https://github.com/cube-js/cube/compare/v1.7.22...v1.7.23) (2026-08-18)

### Performance Improvements

- **postgres-driver:** build user defined types map in linear time ([#11586](https://github.com/cube-js/cube/issues/11586)) ([4e8dd9b](https://github.com/cube-js/cube/commit/4e8dd9bebe70989852044e18887175cc7f56d98f)), closes [#11149](https://github.com/cube-js/cube/issues/11149)
- **postgres-driver:** Skip relation array types when loading user defined types ([#11587](https://github.com/cube-js/cube/issues/11587)) ([4547e08](https://github.com/cube-js/cube/commit/4547e0870b0b997cc4b838ff61da219afddfd508)), closes [#11149](https://github.com/cube-js/cube/issues/11149)

## [1.7.22](https://github.com/cube-js/cube/compare/v1.7.21...v1.7.22) (2026-08-18)

### Bug Fixes
Expand Down
107 changes: 107 additions & 0 deletions docs-mintlify/admin/monitoring/monitoring-integrations/gcs.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,107 @@
---
title: Integration with Google Cloud Storage
sidebarTitle: Google Cloud Storage
description: Google Cloud Storage is a popular object storage system. This guide demonstrates how to set up Cube to export logs to Google Cloud Storage.
---

[Google Cloud Storage](https://cloud.google.com/storage) is a popular object
storage system. This guide demonstrates how to set up Cube to export logs to
Google Cloud Storage.

## Configuration

First, enable [monitoring integrations][ref-monitoring-integrations] in Cube.

### Exporting logs

To export logs to Google Cloud Storage, start by creating a bucket for Cube logs
and a service account that can write to it.

Then, put the service account key in an environment variable under **Settings →
Environment variables**, base64-encoded. The name must start with
`CUBE_CLOUD_MONITORING_` — only variables with that prefix are available to the
Vector agent:

```bash
CUBE_CLOUD_MONITORING_GCS_CREDENTIALS=eyJ0eXBlIjogInNlcnZpY2VfYWNjb3VudCIsIC4uLn0=
```

Finally, configure the [`gcp_cloud_storage`](https://vector.dev/docs/reference/configuration/sinks/gcp_cloud_storage/)
sink in your [`vector.toml` configuration file][ref-monitoring-integrations-conf].

Example configuration:

```toml
[sinks.gcp-cloud-storage]
type = "gcp_cloud_storage"
inputs = [
"cubejs-server",
"refresh-scheduler",
"warmup-job",
"cubestore"
]
bucket = "your-gcs-bucket-name"
compression = "gzip"
credentials_base64 = "$CUBE_CLOUD_MONITORING_GCS_CREDENTIALS"

[sinks.gcp-cloud-storage.encoding]
codec = "json"

[sinks.gcp-cloud-storage.healthcheck]
enabled = false
```

Commit the configuration for Vector, it should take effect in a minute. Then,
navigate to your bucket and watch the logs coming.

### Authentication

Authenticate with the `credentials_base64` option, referencing the environment
variable that holds the base64-encoded service account key, as in the example above.
This is the only supported way to give the sink its credentials.

`credentials_base64` is specific to Cube — it does not appear in [Vector's own sink
reference][vector-docs-sinks-gcs]. Cube decodes the key and provides it to the Vector
agent as a file named after the sink.

<Warning>

The sink name becomes the name of a Kubernetes object that carries the credentials
file, so it must be lowercase alphanumeric characters and dashes only — **no
underscores**. A sink named `query_history_gcs` will not get a credentials file; name
it `query-history-gcs` instead.

</Warning>

### Healthcheck

The example above sets `healthcheck.enabled = false`. Vector's
`gcp_cloud_storage` healthcheck sends a `HEAD` request to the bucket root, which
requires the `storage.objects.list` permission — write access alone, such as
`roles/storage.objectCreator`, does not grant it. Without this, the sink fails to
start with a forbidden-healthcheck error even though it could write objects
successfully.

With the healthcheck disabled, the sink always starts and reports healthy, so check
the bucket itself to confirm that data is arriving.

### Exporting Query History

Add the `query-history` input to the sink to bring [Query History
export][ref-query-history-export] data to the same bucket.

<Warning>

Query History export additionally requires the **Monitoring Integrations Tier** of
your deployment to be set to **Medium (Up to 50 GB/mo)**. On a lower tier it fails
silently — the sink reports healthy and the bucket stays empty, with no error
logged anywhere.

</Warning>


[ref-monitoring-integrations]: /admin/monitoring/monitoring-integrations
[ref-monitoring-integrations-conf]: /admin/monitoring/monitoring-integrations#configuration
[ref-query-history-export]: /admin/monitoring/monitoring-integrations#query-history-export
[vector-docs-sinks-gcs]:
https://vector.dev/docs/reference/configuration/sinks/gcp_cloud_storage/
20 changes: 19 additions & 1 deletion docs-mintlify/admin/monitoring/monitoring-integrations/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -54,6 +54,9 @@ following guides and configuration examples to get tool-specific instructions:
<Card title="Datadog" href="/admin/monitoring/monitoring-integrations/datadog">
Export logs and metrics to Datadog.
</Card>
<Card title="Google Cloud Storage" href="/admin/monitoring/monitoring-integrations/gcs">
Archive logs to a Google Cloud Storage bucket.
</Card>
<Card title="Grafana Cloud" href="/admin/monitoring/monitoring-integrations/grafana-cloud">
Export logs and metrics to Grafana Cloud.
</Card>
Expand Down Expand Up @@ -291,6 +294,20 @@ available on the [Enterprise plan](https://cube.dev/pricing).

</Note>

<Warning>

Query History export also requires the **Monitoring Integrations Tier** of your
deployment to be set to **Medium (Up to 50 GB/mo)**. You can find it under
**Settings → Monitoring Integrations**; deployments default to **X-Small (Up to 10
GB/mo)**.

On **X-Small** or **Small**, Query History export fails silently: no events reach
any sink, including a `console` sink, and no error is logged. If the tier is not
available in your deployment settings, ask your Cube contact or the [Cube support
team][ref-support] to set it.

</Warning>

<iframe
width="100%"
height="400"
Expand Down Expand Up @@ -375,4 +392,5 @@ Query History export.
[ref-apis]: /reference
[ref-security-context]: /docs/data-modeling/access-control/context
[ref-cache-type]: /docs/pre-aggregations#cache-type
[ref-query-history-export-recipe]: /admin/monitoring/query-history-export
[ref-query-history-export-recipe]: /admin/monitoring/query-history-export
[ref-support]: /admin/account-billing/support
9 changes: 9 additions & 0 deletions docs-mintlify/admin/monitoring/query-history-export.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,15 @@ analysis.
In this recipe, we will show you how to export Query History data to Amazon S3, and then
analyze it using Cube by reading the data from S3 using DuckDB.

<Warning>

Before you start, check that the **Monitoring Integrations Tier** of your deployment is
set to **Medium (Up to 50 GB/mo)**. On a lower tier, [Query History
export][ref-query-history-export] fails silently — no events reach any sink and no error
is logged.

</Warning>

<iframe
width="100%"
height="400"
Expand Down
1 change: 1 addition & 0 deletions docs-mintlify/docs.json
Original file line number Diff line number Diff line change
Expand Up @@ -379,6 +379,7 @@
"admin/monitoring/monitoring-integrations/cloudwatch",
"admin/monitoring/monitoring-integrations/s3",
"admin/monitoring/monitoring-integrations/datadog",
"admin/monitoring/monitoring-integrations/gcs",
"admin/monitoring/monitoring-integrations/grafana-cloud",
"admin/monitoring/monitoring-integrations/new-relic"
]
Expand Down
2 changes: 1 addition & 1 deletion lerna.json
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
{
"version": "1.7.22",
"version": "1.7.23",
"npmClient": "yarn",
"command": {
"bootstrap": {
Expand Down
4 changes: 4 additions & 0 deletions packages/cubejs-api-gateway/CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,10 @@
All notable changes to this project will be documented in this file.
See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.

## [1.7.23](https://github.com/cube-js/cube/compare/v1.7.22...v1.7.23) (2026-08-18)

**Note:** Version bump only for package @cubejs-backend/api-gateway

## [1.7.22](https://github.com/cube-js/cube/compare/v1.7.21...v1.7.22) (2026-08-18)

**Note:** Version bump only for package @cubejs-backend/api-gateway
Expand Down
10 changes: 5 additions & 5 deletions packages/cubejs-api-gateway/package.json
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
"name": "@cubejs-backend/api-gateway",
"description": "Cube API Gateway",
"author": "Cube Dev, Inc.",
"version": "1.7.22",
"version": "1.7.23",
"repository": {
"type": "git",
"url": "https://github.com/cube-js/cube.git",
Expand All @@ -27,9 +27,9 @@
"dist/src/*"
],
"dependencies": {
"@cubejs-backend/native": "1.7.22",
"@cubejs-backend/query-orchestrator": "1.7.22",
"@cubejs-backend/shared": "1.7.22",
"@cubejs-backend/native": "1.7.23",
"@cubejs-backend/query-orchestrator": "1.7.23",
"@cubejs-backend/shared": "1.7.23",
"@ungap/structured-clone": "^0.3.4",
"assert-never": "^1.4.0",
"body-parser": "^1.19.0",
Expand All @@ -53,7 +53,7 @@
"zod": "^4.1.13"
},
"devDependencies": {
"@cubejs-backend/linter": "1.7.22",
"@cubejs-backend/linter": "1.7.23",
"@types/express": "^4.17.21",
"@types/jest": "^29",
"@types/jsonwebtoken": "^9.0.2",
Expand Down
4 changes: 4 additions & 0 deletions packages/cubejs-athena-driver/CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,10 @@
All notable changes to this project will be documented in this file.
See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.

## [1.7.23](https://github.com/cube-js/cube/compare/v1.7.22...v1.7.23) (2026-08-18)

**Note:** Version bump only for package @cubejs-backend/athena-driver

## [1.7.22](https://github.com/cube-js/cube/compare/v1.7.21...v1.7.22) (2026-08-18)

**Note:** Version bump only for package @cubejs-backend/athena-driver
Expand Down
10 changes: 5 additions & 5 deletions packages/cubejs-athena-driver/package.json
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
"name": "@cubejs-backend/athena-driver",
"description": "Cube.js Athena database driver",
"author": "Cube Dev, Inc.",
"version": "1.7.22",
"version": "1.7.23",
"repository": {
"type": "git",
"url": "https://github.com/cube-js/cube.git",
Expand Down Expand Up @@ -31,12 +31,12 @@
"dependencies": {
"@aws-sdk/client-athena": "^3.22.0",
"@aws-sdk/credential-providers": "^3.22.0",
"@cubejs-backend/base-driver": "1.7.22",
"@cubejs-backend/shared": "1.7.22"
"@cubejs-backend/base-driver": "1.7.23",
"@cubejs-backend/shared": "1.7.23"
},
"devDependencies": {
"@cubejs-backend/linter": "1.7.22",
"@cubejs-backend/testing-shared": "1.7.22",
"@cubejs-backend/linter": "1.7.23",
"@cubejs-backend/testing-shared": "1.7.23",
"@types/ramda": "^0.27.40",
"typescript": "~5.2.2"
},
Expand Down
4 changes: 4 additions & 0 deletions packages/cubejs-backend-cloud/CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,10 @@
All notable changes to this project will be documented in this file.
See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.

## [1.7.23](https://github.com/cube-js/cube/compare/v1.7.22...v1.7.23) (2026-08-18)

**Note:** Version bump only for package @cubejs-backend/cloud

## [1.7.22](https://github.com/cube-js/cube/compare/v1.7.21...v1.7.22) (2026-08-18)

**Note:** Version bump only for package @cubejs-backend/cloud
Expand Down
6 changes: 3 additions & 3 deletions packages/cubejs-backend-cloud/package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "@cubejs-backend/cloud",
"version": "1.7.22",
"version": "1.7.23",
"description": "Cube Cloud package",
"main": "dist/src/index.js",
"typings": "dist/src/index.d.ts",
Expand Down Expand Up @@ -30,15 +30,15 @@
"devDependencies": {
"@babel/core": "^7.24.5",
"@babel/preset-env": "^7.24.5",
"@cubejs-backend/linter": "1.7.22",
"@cubejs-backend/linter": "1.7.23",
"@types/fs-extra": "^9.0.8",
"@types/jest": "^29",
"jest": "^29",
"typescript": "~5.2.2"
},
"dependencies": {
"@cubejs-backend/dotenv": "^9.0.2",
"@cubejs-backend/shared": "1.7.22",
"@cubejs-backend/shared": "1.7.23",
"chokidar": "^3.5.1",
"env-var": "^6.3.0",
"form-data": "^4.0.0",
Expand Down
4 changes: 4 additions & 0 deletions packages/cubejs-backend-maven/CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,10 @@
All notable changes to this project will be documented in this file.
See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.

## [1.7.23](https://github.com/cube-js/cube/compare/v1.7.22...v1.7.23) (2026-08-18)

**Note:** Version bump only for package @cubejs-backend/maven

## [1.7.22](https://github.com/cube-js/cube/compare/v1.7.21...v1.7.22) (2026-08-18)

**Note:** Version bump only for package @cubejs-backend/maven
Expand Down
6 changes: 3 additions & 3 deletions packages/cubejs-backend-maven/package.json
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
"name": "@cubejs-backend/maven",
"description": "Cube.js Maven Wrapper for java dependencies downloading",
"author": "Cube Dev, Inc.",
"version": "1.7.22",
"version": "1.7.23",
"license": "Apache-2.0",
"repository": {
"type": "git",
Expand Down Expand Up @@ -31,12 +31,12 @@
"dist/src/*"
],
"dependencies": {
"@cubejs-backend/shared": "1.7.22",
"@cubejs-backend/shared": "1.7.23",
"source-map-support": "^0.5.19",
"xmlbuilder2": "^2.4.0"
},
"devDependencies": {
"@cubejs-backend/linter": "1.7.22",
"@cubejs-backend/linter": "1.7.23",
"@types/jest": "^29",
"@types/node": "^22",
"jest": "^29",
Expand Down
4 changes: 4 additions & 0 deletions packages/cubejs-backend-native/CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,10 @@
All notable changes to this project will be documented in this file.
See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.

## [1.7.23](https://github.com/cube-js/cube/compare/v1.7.22...v1.7.23) (2026-08-18)

**Note:** Version bump only for package @cubejs-backend/native

## [1.7.22](https://github.com/cube-js/cube/compare/v1.7.21...v1.7.22) (2026-08-18)

### Bug Fixes
Expand Down
8 changes: 4 additions & 4 deletions packages/cubejs-backend-native/package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "@cubejs-backend/native",
"version": "1.7.22",
"version": "1.7.23",
"author": "Cube Dev, Inc.",
"description": "Native module for Cube.js (binding to Rust codebase)",
"main": "dist/js/index.js",
Expand Down Expand Up @@ -39,7 +39,7 @@
"dist/js"
],
"devDependencies": {
"@cubejs-backend/linter": "1.7.22",
"@cubejs-backend/linter": "1.7.23",
"@types/jest": "^29",
"@types/node": "^22",
"cargo-cp-artifact": "^0.1.9",
Expand All @@ -50,8 +50,8 @@
"uuid": "^11.1.1"
},
"dependencies": {
"@cubejs-backend/cubesql": "1.7.22",
"@cubejs-backend/shared": "1.7.22",
"@cubejs-backend/cubesql": "1.7.23",
"@cubejs-backend/shared": "1.7.23",
"@cubejs-infra/post-installer": "^0.1.2"
},
"resources": {
Expand Down
4 changes: 4 additions & 0 deletions packages/cubejs-backend-shared/CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,10 @@
All notable changes to this project will be documented in this file.
See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.

## [1.7.23](https://github.com/cube-js/cube/compare/v1.7.22...v1.7.23) (2026-08-18)

**Note:** Version bump only for package @cubejs-backend/shared

## [1.7.22](https://github.com/cube-js/cube/compare/v1.7.21...v1.7.22) (2026-08-18)

**Note:** Version bump only for package @cubejs-backend/shared
Expand Down
Loading
Loading