Merge branch 'latest' into prometheus-update

timescale · Jan 21, 2025 · 9e4de39 · 9e4de39
2 parents d8c0412 + 3ad0945
commit 9e4de39
Show file tree

Hide file tree

Showing 47 changed files with 502 additions and 278 deletions.
diff --git a/.github/styles/templates/integration.md b/.github/styles/templates/integration.md
@@ -0,0 +1,72 @@
+---
+title: Integrate <third-party tool name> with Timescale Cloud 
+excerpt: SEO friendly explanation of why the user will do it
+keywords: [<third-party tool name>]
+---
+
+import IntegrationPrereqs from "versionContent/_partials/_integration-prereqs.mdx";
+
+# Integrate <third-party tool name> with $CLOUD_LONG
+
+// Explain what the third-party tool is and what it does in their own words, link to product docs. 
+
+// Provide context for the integration steps, for example, if an additional connector is used.
+
+// See https://docs.timescale.com/use-timescale/latest/integrations/grafana/ for an example. 
+
+## Prerequisites
+
+<IntegrationPrereqs />
+
+- Install <third-party tool name> // Mention both server and cloud versions, if present. Link to installation pages.
+
+## Connect your $SERVICE_LONG
+
+To connect to $CLOUD_LONG:
+
+<Procedure>
+
+1. **Log in to <third-party tool name>**
+
+    // Sub-steps, code, screenshots if necessary.
+
+1. **Configure the connection**
+
+   // Sub-steps, code, screenshots if necessary. Link to [Find your connection details][connection-info].
+
+   ...
+
+1. **Test the connection**
+
+   // Sub-steps, code, screenshots if necessary.
+
+</Procedure>
+
+## Test the integration with $CLOUD_LONG
+
+// Add only if there is a simple way to illustrate how the two solutions work together. 
+
+Take the following steps to <whatever the tool must do in conjunction with Timescale Cloud>:
+
+<Procedure>
+
+// Steps to test out the integration using a defined dataset. 
+
+</Procedure>
+
+You have successfully integrated <third-party tool> with $CLOUD_LONG.
+
+[connection-info]: /use-timescale/:currentVersion:/integrations/find-connection-details/
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/_partials/_cloud-connect.md b/_partials/_cloud-connect.md
@@ -50,8 +50,8 @@ Quick recap. You:
 [portal-data-mode]: https://console.cloud.timescale.com/dashboard/services?popsql
 [account-portal]: https://console.cloud.timescale.com/dashboard/account
 [services-portal]: https://console.cloud.timescale.com/dashboard/services
-[install-psql]: /use-timescale/:currentVersion:/integrations/query-admin/psql/
+[install-psql]: /use-timescale/:currentVersion:/integrations/psql/
 [popsql]: /getting-started/:currentVersion:/run-queries-from-console/#data-mode
 [run-sqleditor]: /getting-started/:currentVersion:/run-queries-from-console/#sql-editor
-[install-psql]: /use-timescale/:currentVersion:/integrations/query-admin/psql/
+[install-psql]: /use-timescale/:currentVersion:/integrations/psql/
 [hypertables]: /use-timescale/:currentVersion:/hypertables/about-hypertables/#hypertable-partitioning
diff --git a/_partials/_cloud-create-connect-tutorials.md b/_partials/_cloud-create-connect-tutorials.md
@@ -39,4 +39,4 @@ command-line utility. If you've used PostgreSQL before, you might already have
 </Procedure>
 
 [timescale-portal]: https://console.cloud.timescale.com/
-[install-psql]: /use-timescale/:currentVersion:/integrations/query-admin/psql/
+[install-psql]: /use-timescale/:currentVersion:/integrations/psql/
diff --git a/_partials/_create-hypertable.md b/_partials/_create-hypertable.md
@@ -40,8 +40,8 @@ To create a hypertable:
 </Procedure>
 
 [services-portal]: https://console.cloud.timescale.com/dashboard/services
-[install-psql]: /use-timescale/:currentVersion:/integrations/query-admin/psql/
+[install-psql]: /use-timescale/:currentVersion:/integrations/psql/
 [popsql]: /getting-started/:currentVersion:/run-queries-from-console/#data-mode
 [run-sqleditor]: /getting-started/:currentVersion:/run-queries-from-console/#sql-editor
-[install-psql]: /use-timescale/:currentVersion:/integrations/query-admin/psql/
+[install-psql]: /use-timescale/:currentVersion:/integrations/psql/
 [hypertables]: /use-timescale/:currentVersion:/hypertables/about-hypertables/#hypertable-partitioning
diff --git a/_partials/_grafana-connect.md b/_partials/_grafana-connect.md
@@ -6,7 +6,7 @@ import IntegrationPrereqs from "versionContent/_partials/_integration-prereqs.md
 
 * Install [self-managed Grafana][grafana-self-managed] or sign up for [Grafana Cloud][grafana-cloud].
 
-## Add your $SERVICE_SHORT or database as a data source 
+## Add your $SERVICE_SHORT as a data source 
 
 To connect the data in your $SERVICE_SHORT to Grafana:
 
@@ -37,4 +37,4 @@ To connect the data in your $SERVICE_SHORT to Grafana:
 [grafana-cloud]: https://grafana.com/get/
 [cloud-login]: https://console.cloud.timescale.com/
 [create-service]: /getting-started/:currentVersion:/services/
-[connection-info]: /use-timescale/:currentVersion:/integrations/query-admin/find-connection-details/
+[connection-info]: /use-timescale/:currentVersion:/integrations/find-connection-details/
diff --git a/_partials/_integration-prereqs.md b/_partials/_integration-prereqs.md
@@ -6,4 +6,4 @@ Before integrating:
 
 [create-service]: /getting-started/:currentVersion:/services/
 [enable-timescaledb]: /self-hosted/:currentVersion:/install/
-[connection-info]: /use-timescale/:currentVersion:/integrations/query-admin/find-connection-details/
+[connection-info]: /use-timescale/:currentVersion:/integrations/find-connection-details/
diff --git a/_partials/_usage-based-storage-intro.md b/_partials/_usage-based-storage-intro.md
@@ -1,4 +1,4 @@
-Timescale charges are based on how much storage you use. You don't pay for a 
+$CLOUD_LONG charges are based on the amount of storage you use. You don't pay for 
 fixed storage size, and you don't need to worry about scaling disk size as your 
 data grows; We handle it all for you. To reduce your data costs further, 
 use [compression][compression], a [data retention policy][data-retention], and

diff --git a/_troubleshooting/cloud-jdbc-authentication-support.md b/_troubleshooting/cloud-jdbc-authentication-support.md
@@ -2,7 +2,7 @@
 title: JDBC authentication type is not supported
 section: troubleshooting
 products: [cloud]
-topics: [integrations/query admin]
+topics: [integrations]
 errors:
   - language: text
     message: |-

diff --git a/getting-started/run-queries-from-console.md b/getting-started/run-queries-from-console.md
@@ -229,11 +229,11 @@ To use SQL editor with Timescale:
 [readreplica]: /use-timescale/:currentVersion:/ha-replicas/read-scaling/
 [run-popsql]: /getting-started/:currentVersion:/run-queries-from-console/#data-mode
 [run-sqleditor]: /getting-started/:currentVersion:/run-queries-from-console/#sql-editor
-[integrations]: /use-timescale/:currentVersion:/integrations/query-admin/
+[integrations]: /use-timescale/:currentVersion:/integrations/
 [timescale-console]: https://console.cloud.timescale.com/
 [portal-ops-mode]: https://console.cloud.timescale.com/dashboard/services
 [pricing-plan-features]: https://www.timescale.com/pricing#features
-[install-psql]: /use-timescale/:currentVersion:/integrations/query-admin/psql/
+[install-psql]: /use-timescale/:currentVersion:/integrations/psql/
 [create-cloud-account]: /getting-started/:currentVersion:/services/#create-a-timescale-cloud-account
 [portal-data-mode]: https://console.cloud.timescale.com/dashboard/services?popsql
 [services-portal]: https://console.cloud.timescale.com/dashboard/services

diff --git a/getting-started/services.md b/getting-started/services.md
@@ -67,7 +67,7 @@ And that is it, you are up and running. Enjoy developing with $COMPANY.
 
 [tsc-portal]: https://console.cloud.timescale.com/
 [services-how-to]: /use-timescale/:currentVersion:/services/
-[install-psql]: /use-timescale/:currentVersion:/integrations/query-admin/psql/
+[install-psql]: /use-timescale/:currentVersion:/integrations/psql/
 [create-an-account]: /getting-started/:currentVersion:/services/#create-a-timescale-cloud-account
 [create-a-service]: /getting-started/:currentVersion:/services/#create-a-timescale-cloud-service
 [connect-to-your-service]: /getting-started/:currentVersion:/services/#connect-to-your-service

diff --git a/lambda/redirects.js b/lambda/redirects.js
@@ -564,7 +564,7 @@ module.exports = [
   },
   {
     from: "/tutorials/latest/grafana/",
-    to: "https://docs.timescale.com/use-timescale/latest/integrations/observability-alerting/grafana/",
+    to: "https://docs.timescale.com/use-timescale/latest/integrations/grafana/",
   },
   {
     from: "/tutorials/latest/howto-monitor-django-prometheus",
@@ -605,27 +605,27 @@ module.exports = [
   { from: "/tutorials", to: "https://docs.timescale.com/tutorials/latest/" },
   {
     from: "/use-timescale/latest/connecting/",
-    to: "https://docs.timescale.com/use-timescale/latest/integrations/query-admin/",
+    to: "https://docs.timescale.com/use-timescale/latest/integrations/",
   },
   {
     from: "/use-timescale/latest/connecting/about-connecting",
-    to: "https://docs.timescale.com/use-timescale/latest/integrations/query-admin/about-connecting/",
+    to: "https://docs.timescale.com/use-timescale/latest/integrations/find-connection-details/",
   },
   {
     from: "/use-timescale/latest/connecting/about-psql/",
-    to: "https://docs.timescale.com/use-timescale/latest/integrations/query-admin/about-psql/",
+    to: "https://docs.timescale.com/use-timescale/latest/integrations/psql/",
   },
   {
     from: "/use-timescale/latest/connecting/dbeaver/",
-    to: "https://docs.timescale.com/use-timescale/latest/integrations/query-admin/dbeaver/",
+    to: "https://docs.timescale.com/use-timescale/latest/integrations/dbeaver/",
   },
   {
     from: "/use-timescale/latest/connecting/pgadmin/",
-    to: "https://docs.timescale.com/use-timescale/latest/integrations/query-admin/",
+    to: "https://docs.timescale.com/use-timescale/latest/integrations/pgadmin/",
   },
   {
     from: "/use-timescale/latest/connecting/psql/",
-    to: "https://docs.timescale.com/use-timescale/latest/integrations/query-admin/about-psql/",
+    to: "https://docs.timescale.com/use-timescale/latest/integrations/psql/",
   },
   {
     from: "/use-timescale/latest/data-tiering/move-data/",
@@ -721,7 +721,7 @@ module.exports = [
   },
   {
     from: "/using-timescaledb/visualizing-data",
-    to: "https://docs.timescale.com/use-timescale/latest/integrations/observability-alerting/grafana/",
+    to: "https://docs.timescale.com/use-timescale/latest/integrations/grafana/",
   },
   {
     from: "/use-timescale/latest/account-management/",
@@ -759,15 +759,15 @@ module.exports = [
   },
   {
     from: "/timescaledb/latest/tutorials/grafana/visualizations/pie-chart/",
-    to: "https://docs.timescale.com/use-timescale/latest/integrations/observability-alerting/grafana/",
+    to: "https://docs.timescale.com/use-timescale/latest/integrations/grafana/",
   },
   {
     from: "/promscale/latest/about-promscale/#promscale-schema-for-metric-data",
     to: "https://docs.timescale.com/",
   },
   {
     from: "/promscale/latest/visualize-data/grafana",
-    to: "https://docs.timescale.com/use-timescale/latest/integrations/observability-alerting/grafana/",
+    to: "https://docs.timescale.com/use-timescale/latest/integrations/grafana/",
   },
   {
     from: "/install/latest/self-hosted/installation-redhat/#where-to-next",
@@ -783,7 +783,7 @@ module.exports = [
   },
   {
     from: "/timescaledb/latest/tutorials/grafana/grafana-variables/",
-    to: "https://docs.timescale.com/use-timescale/latest/integrations/observability-alerting/grafana/",
+    to: "https://docs.timescale.com/use-timescale/latest/integrations/grafana/",
   },
   {
     from: "/clustering/using-timescaledb/update-db",
@@ -821,4 +821,52 @@ module.exports = [
     from: "/use-timescale/latest/compression/backfill-historical-data/",
     to: "https://github.com/timescale/timescaledb-extras/blob/master/backfill.sql",
   },
+  {
+    from: '/use-timescale/latest/integrations/observability-alerting/grafana/installation/',
+    to: 'https://docs.timescale.com/use-timescale/latest/integrations/grafana/',
+  },
+  {
+    from: '/use-timescale/latest/integrations/observability-alerting/grafana/geospatial-dashboards/',
+    to: 'https://docs.timescale.com/use-timescale/latest/integrations/grafana/',
+  },
+  {
+    from: '/use-timescale/latest/integrations/observability-alerting/grafana/create-dashboard-and-panel/',
+    to: 'https://docs.timescale.com/use-timescale/latest/integrations/grafana/',
+  },
+  {
+    from: '/use-timescale/latest/integrations/query-admin/about-psql/',
+    to: 'https://docs.timescale.com/use-timescale/latest/integrations/psql/',
+  },
+    {
+      from: '/use-timescale/latest/integrations/query-admin/psql/',
+      to: 'https://docs.timescale.com/use-timescale/latest/integrations/psql/',
+    },
+  {
+    from: '/use-timescale/latest/integrations/query-admin/about-connecting/',
+    to: 'https://docs.timescale.com/use-timescale/latest/integrations/find-connection-details/',
+  },
+  {
+    from: '/use-timescale/latest/integrations/query-admin/azure-data-studio/',
+    to: 'https://docs.timescale.com/use-timescale/latest/integrations/azure-data-studio/',
+  },
+  {
+    from: '/use-timescale/latest/integrations/query-admin/dbeaver/',
+    to: 'https://docs.timescale.com/use-timescale/latest/integrations/dbeaver/',
+  },
+  {
+    from: '/use-timescale/latest/integrations/query-admin/pgadmin/',
+    to: 'https://docs.timescale.com/use-timescale/latest/integrations/pgadmin/',
+  },
+  {
+    from: '/use-timescale/latest/integrations/query-admin/qstudio/',
+    to: 'https://docs.timescale.com/use-timescale/latest/integrations/qstudio/',
+  },
+  {
+    from: '/use-timescale/latest/integrations/config-deploy/terraform/',
+    to: 'https://docs.timescale.com/use-timescale/latest/integrations/terraform/',
+  },
+  {
+    from: '/use-timescale/latest/integrations/observability-alerting/tableau/',
+    to: 'https://docs.timescale.com/use-timescale/latest/integrations/tableau/',
+  },
 ];
diff --git a/mst/installation-mst.md b/mst/installation-mst.md
@@ -122,7 +122,7 @@ You can always [contact us][contact] if you need help working something out, or
 if you want to have a chat.
 
 [contact]: https://www.timescale.com/contact
-[install-psql]: /use-timescale/:currentVersion:/integrations/query-admin/psql/
+[install-psql]: /use-timescale/:currentVersion:/integrations/psql/
 [mst-docs]: /mst/:currentVersion:/
 [tutorials]: /tutorials/:currentVersion:/
 [mst-signup]: https://www.timescale.com/mst-signup

diff --git a/mst/migrate-to-mst.md b/mst/migrate-to-mst.md
@@ -129,7 +129,7 @@ them. The migration still occurs successfully.
 [install-mst]: /mst/:currentVersion:/installation-mst/#create-your-first-service
 [pg_dump]: https://www.postgresql.org/docs/current/app-pgdump.html
 [pg_restore]: https://www.postgresql.org/docs/current/app-pgrestore.html
-[psql]: /use-timescale/:currentVersion:/integrations/query-admin/psql/
+[psql]: /use-timescale/:currentVersion:/integrations/psql/
 [upgrading-postgresql]: https://kb-managed.timescale.com/en/articles/5368016-perform-a-postgresql-major-version-upgrade
 [upgrading-postgresql-self-hosted]: /self-hosted/:currentVersion:/upgrades/upgrade-pg/
 [upgrading-timescaledb]: /self-hosted/:currentVersion:/upgrades/major-upgrade/
diff --git a/quick-start/ruby.md b/quick-start/ruby.md
@@ -720,7 +720,7 @@ page by page, or all pages together, and group by path or not:
 [add-performance]: #add-performance-and-path-attributes-to-pageload
 [explore]: #explore-aggregation-functions
 [install]: /getting-started/latest/
-[psql-install]: /use-timescale/:currentVersion:/integrations/query-admin/psql/
+[psql-install]: /use-timescale/:currentVersion:/integrations/psql/
 [rails-guide]: https://guides.rubyonrails.org/getting_started.html
 [ab]: https://httpd.apache.org/docs/2.4/programs/ab.html
 [active-record-query]: https://guides.rubyonrails.org/active_record_querying.html

diff --git a/self-hosted/install/installation-macos.md b/self-hosted/install/installation-macos.md
@@ -80,7 +80,7 @@ And that is it! You have TimescaleDB running on a database on a self-hosted inst
 For the latest functionality, install MacOS 14 Sanoma. The oldest supported version is macOS 10.15 Catalina
 
 [homebrew]: https://docs.brew.sh/Installation
-[install-psql]: /use-timescale/:currentVersion:/integrations/query-admin/psql/
+[install-psql]: /use-timescale/:currentVersion:/integrations/psql/
 [macports]: https://guide.macports.org/#installing.macports
 [install-from-source]: /self-hosted/:currentVersion:/install/installation-source/
 [install-postgresql]: https://www.postgresql.org/download/macosx/
diff --git a/self-hosted/install/installation-source.md b/self-hosted/install/installation-source.md
@@ -73,7 +73,7 @@ And that is it! You have TimescaleDB running on a database on a self-hosted inst
 
 <WhereTo />
 
-[install-psql]: /use-timescale/:currentVersion:/integrations/query-admin/psql/
+[install-psql]: /use-timescale/:currentVersion:/integrations/psql/
 [config]: /self-hosted/:currentVersion:/configuration/
 [postgres-download]: https://www.postgresql.org/download/
 [cmake-download]: https://cmake.org/download/

diff --git a/self-hosted/migration/entire-database.md b/self-hosted/migration/entire-database.md
@@ -118,7 +118,7 @@ information about compression and decompression, see [Compression][compression].
 [migrate-separately]: /self-hosted/:currentVersion:/migration/schema-then-data/
 [pg_dump]: https://www.postgresql.org/docs/current/app-pgdump.html
 [pg_restore]: https://www.postgresql.org/docs/current/app-pgrestore.html
-[psql]: /use-timescale/:currentVersion:/integrations/query-admin/psql/
+[psql]: /use-timescale/:currentVersion:/integrations/psql/
 [timescaledb_pre_restore]: /api/:currentVersion:/administration/#timescaledb_pre_restore
 [timescaledb_post_restore]: /api/:currentVersion:/administration/#timescaledb_post_restore
 [upgrading-postgresql-self-hosted]: /self-hosted/:currentVersion:/upgrades/upgrade-pg/

diff --git a/self-hosted/migration/schema-then-data.md b/self-hosted/migration/schema-then-data.md
@@ -210,7 +210,7 @@ the [compression section](https://docs.timescale.com/use-timescale/latest/compre
 [install-selfhosted]: /self-hosted/:currentVersion:/install/
 [pg_dump]: https://www.postgresql.org/docs/current/app-pgdump.html
 [pg_restore]: https://www.postgresql.org/docs/current/app-pgrestore.html
-[psql]: /use-timescale/:currentVersion:/integrations/query-admin/psql/
+[psql]: /use-timescale/:currentVersion:/integrations/psql/
 [timescaledb-parallel-copy]: https://github.com/timescale/timescaledb-parallel-copy
 [upgrading-postgresql]: https://kb-managed.timescale.com/en/articles/5368016-perform-a-postgresql-major-version-upgrade
 [upgrading-postgresql-self-hosted]: /self-hosted/:currentVersion:/upgrades/upgrade-pg/

diff --git a/self-hosted/upgrades/upgrade-pg.md b/self-hosted/upgrades/upgrade-pg.md
@@ -16,7 +16,20 @@ TimescaleDB is a PostgreSQL extension. Ensure that you upgrade to compatible ver
 <ConsiderCloud />
 
 
-## Prerequisites
+||PostgreSQL&nbsp;17|PostgreSQL&nbsp;16|PostgreSQL&nbsp;15|PostgreSQL&nbsp;14|PostgreSQL&nbsp;13|PostgreSQL&nbsp;12|PostgreSQL&nbsp;11|PostgreSQL&nbsp;10|PostgreSQL&nbsp;9.6|
+|-|-|-|-|-|-|-|-|-|
+|TimescaleDB&nbsp;2.17 and higher|&#9989;|&#9989;|&#9989;|&#9989;|&#10060;|&#10060;|&#10060;|&#10060;|&#10060;|
+|TimescaleDB&nbsp;2.16 and higher|&#10060;|&#9989;|&#9989;|&#9989;|&#10060;|&#10060;|&#10060;|&#10060;|&#10060;|&#10060;|
+|TimescaleDB&nbsp;2.15 and higher|&#10060;|&#9989;|&#9989;|&#9989;|&#9989;|&#10060;|&#10060;|&#10060;|&#10060;|&#10060;|
+|TimescaleDB&nbsp;2.14 and higher|&#10060;|&#9989;|&#9989;|&#9989;|&#9989;|&#10060;|&#10060;|&#10060;|&#10060;|&#10060;|
+|TimescaleDB&nbsp;2.13 and higher|&#10060;|&#9989;|&#9989;|&#9989;|&#9989;|&#10060;|&#10060;|&#10060;|&#10060;|
+|TimescaleDB&nbsp;2.12 and higher|&#10060;|&#10060;|&#9989;|&#9989;|&#9989;|&#10060;|&#10060;|&#10060;|&#10060;|
+|TimescaleDB&nbsp;2.10 and higher|&#10060;|&#10060;|&#9989;|&#9989;|&#9989;|&#9989;|&#10060;|&#10060;|&#10060;|
+|TimescaleDB&nbsp;2.5 to 2.9|&#10060;|&#10060;|&#10060;|&#9989;|&#9989;|&#9989;|&#10060;|&#10060;|&#10060;|
+|TimescaleDB&nbsp;2.4|&#10060;|&#10060;|&#10060;|&#10060;|&#9989;|&#9989;|&#10060;|&#10060;|&#10060;|
+|TimescaleDB&nbsp;2.1 to 2.3|&#10060;|&#10060;|&#10060;|&#10060;|&#9989;|&#9989;|&#9989;|&#10060;|&#10060;|
+|TimescaleDB&nbsp;2.0|&#10060;|&#10060;|&#10060;|&#10060;|&#10060;|&#9989;|&#9989;|&#10060;|&#10060;
+|TimescaleDB&nbsp;1.7|&#10060;|&#10060;|&#10060;|&#10060;|&#10060;|&#9989;|&#9989;|&#9989;|&#9989;|
 
 <PlanUpgrade />
 

diff --git a/tutorials/OLD-financial-candlestick-tick-data/index.md b/tutorials/OLD-financial-candlestick-tick-data/index.md
@@ -73,4 +73,4 @@ Follow this tutorial and see how to set up your TimescaleDB database to consume
 [create]: /tutorials/:currentVersion:/financial-candlestick-tick-data/create-candlestick-aggregates
 [query]: /tutorials/:currentVersion:/financial-candlestick-tick-data/query-candlestick-views
 [manage]: /tutorials/:currentVersion:/financial-candlestick-tick-data/advanced-data-management
-[psql]: /use-timescale/:currentVersion:/integrations/query-admin/psql/
+[psql]: /use-timescale/:currentVersion:/integrations/psql/
diff --git a/tutorials/OLD_analyze-bitcoin-blockchain/index.md b/tutorials/OLD_analyze-bitcoin-blockchain/index.md
@@ -47,4 +47,4 @@ this tutorial is to
 </Highlight>
 
 [install-timescale]: /getting-started/latest/
-[psql-install]: /use-timescale/:currentVersion:/integrations/query-admin/about-psql
+[psql-install]: /use-timescale/:currentVersion:/integrations/psql/