The easy-to-use open source Business Intelligence and Embedded Analytics tool that lets everyone work with data :bar_chart:
TypeScript analyticsbibusiness-intelligencebusinessintelligenceclojuredashboarddatadata-analysisdata-visualizationdatabasemetabasemysqlpostgrespostgresqlreportingslacksql-editorvisualization
Auto-update documentation for master (#74191)
github-automation-metabase00cceb55c658
diff --git a/docs/configuring-metabase/environment-variables.md b/docs/configuring-metabase/environment-variables.mdindex 3813aaf49f6..069b128d619 100644--- a/docs/configuring-metabase/environment-variables.md+++ b/docs/configuring-metabase/environment-variables.md@@ -2281,6 +2281,26 @@ Use [MB_SESSION_COOKIES](#mb_session_cookies) to also expire sessions, when browAlso see the [Changing session expiration](../people-and-groups/changing-session-expiration.md) documentation page.+### `MB_APPLICATION_DB_IDLE_CONNECTION_TEST_PERIOD_SECONDS`++Type: integer<br>+Default: `60`<br>+Since: v62.0++How often, in seconds, to test idle connections in the application database pool. Set to `0` to disable idle connection testing.++### `MB_APPLICATION_DB_MAX_CONNECTION_AGE_SECONDS`++Type: integer<br>+Default: `3600`<br>+Since: v62.0++Maximum lifetime, in seconds, of a connection in the application database pool. After this duration the connection is closed and a new one is opened. Set to `0` to keep connections until the database closes them.++The default of one hour is set primarily to limit memory growth (especially on PostgreSQL).++If you are connecting with a short-lived credential (e.g. an AWS RDS IAM auth token) baked into the URL or password at startup, setting this to `0` is a partial workaround — eventual reconnects from the database or the network will still fail. Prefer [MB_DB_AWS_IAM](#mb_db_aws_iam) (AWS RDS / Aurora) or [MB_DB_AZURE_MANAGED_IDENTITY_CLIENT_ID](#mb_db_azure_managed_identity_client_id) (Azure).+### `MB_APPLICATION_DB_MAX_CONNECTION_POOL_SIZE`Type: integer<br>@@ -2295,6 +2315,30 @@ To see how many connections are being used, check the Metabase logs and look forSee [MB_JDBC_DATA_WAREHOUSE_MAX_CONNECTION_POOL_SIZE](#mb_jdbc_data_warehouse_max_connection_pool_size) for setting maximum connections to the databases connected to Metabase.+### `MB_APPLICATION_DB_MAX_IDLE_TIME_EXCESS_CONNECTIONS_SECONDS`++Type: integer<br>+Default: `600`<br>+Since: v62.0++How long, in seconds, an idle connection beyond the minimum pool size may stay open before being culled. Set to `0` to never cull excess idle connections.++### `MB_APPLICATION_DB_TEST_CONNECTION_ON_CHECKOUT`++Type: boolean<br>+Default: `false`<br>+Since: v62.0++When `true`, each connection is validated when checked out of the pool. Adds latency to every checkout. Useful when credentials may invalidate connections behind the pool's back.++### `MB_APPLICATION_DB_UNRETURNED_CONNECTION_TIMEOUT_SECONDS`++Type: integer<br>+Default: `3600`<br>+Since: v62.0++How long, in seconds, before a checked-out but unreturned connection is forcibly reclaimed. The legacy name `MB_APPLICATION_DB_UNRETURNED_CONNECTION_TIMEOUT` continues to work; the suffixed form is preferred.+### `MB_ASYNC_QUERY_THREAD_POOL_SIZE`Type: integer<br>@@ -2324,6 +2368,28 @@ Default: `true`When set to `false`, Metabase will print migrations needed to be done in the application database and exit. Those migrations need to be applied manually. When `true`, Metabase will automatically make changes to the application database. This is not related to migrating away from H2.+### `MB_DB_AWS_IAM`++Type: boolean<br>+Default: `false`<br>+Since: v0.58.0++When `true`, authenticate to the application database (PostgreSQL or MySQL/MariaDB on AWS RDS or Aurora) using AWS IAM instead of a password. Omit [MB_DB_PASS](#mb_db_pass). Auth tokens are refreshed automatically.++Requires that AWS credentials are available via the standard credential chain (e.g. EKS IRSA, EC2 instance profile, ECS task role, or `AWS_ACCESS_KEY_ID` / `AWS_SECRET_ACCESS_KEY`), that the credentials hold the `rds-db:connect` permission for your database user, and that the DB user is set up for IAM authentication.++For MySQL/MariaDB, also set [MB_DB_SSL_CERT](#mb_db_ssl_cert), or pass the SSL parameters in [MB_DB_CONNECTION_URI](#mb_db_connection_uri).++### `MB_DB_AZURE_MANAGED_IDENTITY_CLIENT_ID`++Type: string<br>+Default: `null`<br>+Since: v0.51.0++Authenticate to a PostgreSQL or MySQL application database using an Azure Managed Identity instead of a password. Set this to the client ID of a user-assigned Managed Identity attached to your compute resource. Omit [MB_DB_PASS](#mb_db_pass). Access tokens are refreshed automatically.++Requires the Database authentication providers Pro/Enterprise feature.+### `MB_DB_CONNECTION_URI`Type: string<br>@@ -2387,6 +2453,17 @@ Default: `null`The port for [MB_DB_HOST](#mb_db_host).+### `MB_DB_SSL_CERT`++Type: string<br>+Default: `null`<br>+Since: v0.58.0++SSL configuration for the application database. Used with [MB_DB_AWS_IAM](#mb_db_aws_iam) on MySQL/MariaDB, where SSL is required.++- `"trust"` — trust the server certificate without validation.+- A filesystem path to a PEM file — validate against the supplied CA certificate.+### `MB_DB_TYPE`Type: string (`"h2"`, `"postgres"`, `"mysql"`)<br>diff --git a/docs/usage-and-performance-tools/usage-analytics-reference.md b/docs/usage-and-performance-tools/usage-analytics-reference.mdindex 5e1dd329b48..b781172da65 100644--- a/docs/usage-and-performance-tools/usage-analytics-reference.md+++ b/docs/usage-and-performance-tools/usage-analytics-reference.md@@ -193,6 +193,8 @@ Columns:- IP Address- Tenant ID- Request ID+- Cache Creation Tokens+- Cache Read Tokens### Alerts