Skip to content
This repository was archived by the owner on Apr 20, 2026. It is now read-only.
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
101 changes: 49 additions & 52 deletions _partials/_aws-features.md

Large diffs are not rendered by default.

95 changes: 46 additions & 49 deletions _partials/_azure-features.md

Large diffs are not rendered by default.

2 changes: 1 addition & 1 deletion _partials/_billing-for-inactive-services.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<Highlight type="important">

You are charged for all active $SERVICE_SHORTs in your account, even if you are not actively using them. To reduce costs, pause or delete your unused $SERVICE_SHORTs.
You are charged for all active standard $SERVICE_SHORTs in your account, even if you are not actively using them. To reduce costs, pause or delete your unused $SERVICE_SHORTs.

</Highlight>
4 changes: 0 additions & 4 deletions _partials/_cloud-connect-service.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,3 @@
import NotAvailableFreePlan from "versionContent/_partials/_not-available-in-free-plan.mdx";

<Procedure>

1. **Check your $SERVICE_SHORT is running correctly**
Expand All @@ -16,8 +14,6 @@ import NotAvailableFreePlan from "versionContent/_partials/_not-available-in-fre

<Tab title="Data view in Console" label="data-mode">

<NotAvailableFreePlan />

<Procedure>

1. In $CONSOLE, toggle `Data view`.
Expand Down
10 changes: 4 additions & 6 deletions _partials/_cloud-free-trial.md
Original file line number Diff line number Diff line change
@@ -1,13 +1,11 @@
import FreeBeta from "versionContent/_partials/_free-plan-beta.mdx";

Are you just starting out with $CLOUD_LONG? On our Free pricing plan, you can create up to 2 zero-cost $SERVICE_SHORTs with [limited resources][plan-features]. When a free $SERVICE_SHORT reaches the resource limit, it converts to a read-only state.

<FreeBeta />

Ready to try a more feature-rich paid plan? Activate a 30-day free trial of our $PERFORMANCE (no credit card required) or $SCALE plan. After your trial ends, we may remove your data unless you’ve added a payment method.
Are you just starting out with $CLOUD_LONG? Activate a 30-day free trial of our $PERFORMANCE (no credit card required) or $SCALE plan. After your trial ends, we may remove your data unless you’ve added a payment method.

After you have completed your 30-day trial period, choose the
[$PRICING_PLAN][plan-features] that suits your business and engineering needs. And even when you upgrade from the Free pricing plan, you can still have up to 2 zero-cost $SERVICE_SHORTs—or convert the ones you already have into standard ones, to have more resources.
[$PRICING_PLAN][plan-features] that suits your business and engineering needs. And even when you upgrade from the trial, you can still have up to 2 free $SERVICE_SHORTs.

<FreeBeta />

If you want to try out features in a higher $PRICING_PLAN before upgrading, contact us.

Expand Down
15 changes: 7 additions & 8 deletions _partials/_devops-cli-get-started.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
import RESTPrereqs from "versionContent/_partials/_prereqs-cloud-account-only.mdx";
import CLIINSTALL from "versionContent/_partials/_devops-cli-install.mdx";
import CLIREF from "versionContent/_partials/_devops-cli-reference.mdx";
import FreeBeta from "versionContent/_partials/_free-plan-beta.mdx";

$CLI_LONG is a command-line interface that you use to manage $CLOUD_LONG resources
including VPCs, services, read replicas, and related infrastructure. $CLI_LONG calls $REST_LONG to communicate with
Expand Down Expand Up @@ -31,19 +32,17 @@ Create a new $SERVICE_LONG using $CLI_LONG:

1. **Submit a $SERVICE_SHORT creation request**

By default, $CLI_LONG creates a $SERVICE_SHORT for you that matches your [$PRICING_PLAN][pricing-plans]:
* **$FREE**: shared CPU/memory and the `time-series` and `ai` capabilities (only available in `us-east-1` region)
* **Paid $PRICING_PLAN**: 0.5 CPU and 2 GB memory with the `time-series` capability
By default, $CLI_LONG creates a $SERVICE_SHORT with 0.5 CPU and 2 GB memory with the `time-series` capability

```shell
tiger service create
```
To control the $SERVICE_SHORT configuration, use the [`service create` flags][cli-create-custom-service]. For
example, to create a free service if you are in a paid $PRICING_PLAN, call
`tiger service create --memory shared --cpu shared`.
example, to create a free service, call `tiger service create --memory shared --cpu shared`.

<FreeBeta />

<Highlight type="note">
Free services with shared CPU/memory are only available in the `us-east-1` region. Paid services can be created in any available AWS or Azure region using the `--region` flag.
</Highlight>
Free services with shared CPU/memory are only available in the `us-east-1` region. Standard services can be created in any available AWS or Azure region using the `--region` flag.

$CLOUD_LONG creates a Development environment for you. That is, no delete protection, high-availability, spooling or
read replication. You see something like:
Expand Down
2 changes: 1 addition & 1 deletion _partials/_free-plan-beta.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<Highlight type="note">

The Free pricing plan and services are currently in beta.
Free services are currently in beta.

</Highlight>
5 changes: 0 additions & 5 deletions _partials/_not-available-in-free-plan.md

This file was deleted.

9 changes: 5 additions & 4 deletions _partials/_services-intro.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,12 +8,10 @@ extensions.

Each $SERVICE_SHORT is associated with a project in $CLOUD_LONG. Each project can have multiple $SERVICE_SHORTs. Each user is a [member of one or more projects][projects].

You create free and standard $SERVICE_SHORTs in $CONSOLE_LONG, depending on your [$PRICING_PLAN][pricing-plans]. A free $SERVICE_SHORT comes at zero cost and gives you limited resources to get to know $CLOUD_LONG. Once you are ready to try out more advanced features, you can switch to a paid plan and convert your free $SERVICE_SHORT to a standard one.
You create free and standard $SERVICE_SHORTs in $CONSOLE_LONG. A standard $SERVICE_SHORT comes with the full range of features according to your $PRICING_PLAN. A free $SERVICE_SHORT comes at zero cost and gives you limited features and resources.

![$CLOUD_LONG pricing plans][cloud_long-pricing-plans]

<FreeBeta />

To the $PG you know and love, $CLOUD_LONG adds the following capabilities:

- **Standard $SERVICE_SHORTs**:
Expand All @@ -33,13 +31,16 @@ To the $PG you know and love, $CLOUD_LONG adds the following capabilities:

_$PG with $TIMESCALE_DB and vector extensions_

Free $SERVICE_SHORTs offer limited resources and a basic feature scope, perfect to get to know $CLOUD_LONG in a development environment.
Free $SERVICE_SHORTs come with pre-configured CPU and memory, are hosted in `us-east-1` region, and offer limited resources with a basic feature scope. This excludes connection pooling, replication, data tiering, exporters, metrics, VPC, and other features. Free $SERVICE_SHORTs are perfect for schema explorations, syntax validations, and other small-scale testing. Once you reach the storage limit, a free $SERVICE_SHORT enters a read-only state. You can [convert your free $SERVICE_SHORT][convert-to-free] to a standard one at any time.

<FreeBeta />

You can [manage, pause, or delete][service-management] your $SERVICE_SHORT at any time from $CONSOLE.

[automatic-backups]: /use-timescale/:currentVersion:/backup-restore/
[cloud_long-pricing-plans]: https://assets.timescale.com/docs/images/tiger-cloud-console/tiger-pricing.svg
[connection-pooling]: /use-timescale/:currentVersion:/services/connection-pooling
[convert-to-free]: /use-timescale/:currentVersion:/services/service-management/#convert-a-free-service-to-a-standard-one
[data-tiering]: /use-timescale/:currentVersion:/data-tiering/
[high-availability]: /use-timescale/:currentVersion:/ha-replicas/high-availability/
[how-plans-work]: /about/:currentVersion:/pricing-and-account-management/#how-your-bill-is-calculated
Expand Down
8 changes: 2 additions & 6 deletions _partials/_upgrade-plan-monitor-usage.md
Original file line number Diff line number Diff line change
@@ -1,11 +1,7 @@
import BillingForInactiveServices from "versionContent/_partials/_billing-for-inactive-services.mdx";

You can upgrade or downgrade between the Free, $PERFORMANCE, and $SCALE plans
whenever you want using [$CONSOLE][cloud-login]. To downgrade to the Free plan, you must only have free services running in your project.

If you switch your $PRICING_PLAN mid-month,
your prices are prorated to when you switch. Your $SERVICE_SHORTs are not interrupted when you switch, so
you can keep working without any hassle. To move to $ENTERPRISE, [get in touch with $COMPANY][contact-company].
You can upgrade or downgrade between the $PERFORMANCE and $SCALE plans
whenever you want using [$CONSOLE][cloud-login]. To move to $ENTERPRISE, [get in touch with $COMPANY][contact-company]. If you switch your $PRICING_PLAN mid-month, your prices are prorated to when you switch. Your $SERVICE_SHORTs are not interrupted when you switch, so you can keep working without any hassle.

## Monitor usage and costs

Expand Down
1 change: 0 additions & 1 deletion about/pricing-and-account-management.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,6 @@ import SupportPlans from "versionContent/_partials/_support-plans.mdx";
import BillingExample from "versionContent/_partials/_billing-example.mdx";
import ManagePricing from "versionContent/_partials/_manage-pricing-plan.mdx";
import BillingForInactiveServices from "versionContent/_partials/_billing-for-inactive-services.mdx";
import FreeBeta from "versionContent/_partials/_free-plan-beta.mdx";
import DisaggregatedComputeStorage from "versionContent/_partials/_disaggregated-compute-storage.mdx";
import DisaggregatedComputeStorageAzure from "versionContent/_partials/_disaggregated-compute-storage-azure.mdx";
import AwsFeatures from "versionContent/_partials/_aws-features.mdx";
Expand Down
2 changes: 1 addition & 1 deletion api/glossary.md
Original file line number Diff line number Diff line change
Expand Up @@ -191,7 +191,7 @@ This glossary defines technical terms, concepts, and terminology used in $COMPAN

<a id="free-tiger-service" href=""></a>

**Free $SERVICE_SHORT**: a free instance of $CLOUD_LONG with limited resources. You can create up to two free $SERVICE_SHORTs under any $PRICING_PLAN. When a free $SERVICE_SHORT reaches the resource limit, it converts to the read-only state. You can convert a free $SERVICE_SHORT to a [standard one][standard-tiger-service-link] under paid $PRICING_PLANs.
**Free $SERVICE_SHORT**: a free instance of $CLOUD_LONG with limited resources. You can create up to two free $SERVICE_SHORTs under any $PRICING_PLAN. When a free $SERVICE_SHORT reaches the resource limit, it converts to the read-only state. You can convert a free $SERVICE_SHORT to a [standard one][standard-tiger-service-link].

**FTP (File Transfer Protocol)**: a standard network protocol used for transferring files between a client and server on a computer network.

Expand Down
3 changes: 0 additions & 3 deletions getting-started/run-queries-from-console.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,6 @@ content_group: Getting started
---

import WhereNext from "versionContent/_partials/_where-to-next.mdx";
import NotAvailableFreePlan from "versionContent/_partials/_not-available-in-free-plan.mdx";

# Run your queries from $CONSOLE

Expand All @@ -31,8 +30,6 @@ You use $DATA_MODE in $CONSOLE to write queries, visualize data, and share your

![$CONSOLE $DATA_MODE][console-data_mode]

<NotAvailableFreePlan />

To start using $DATA_MODE, open $CONSOLE and toggle `Data view`. This includes the following tabs:

- **Files**: browse all your personal and shared queries, dashboards, notebooks, and folders.
Expand Down
5 changes: 1 addition & 4 deletions getting-started/try-key-features-timescale-products.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,6 @@ import HASetup from 'versionContent/_partials/_high-availability-setup.mdx';
import IntegrationPrereqs from "versionContent/_partials/_integration-prereqs.mdx";
import HypercoreIntroShort from "versionContent/_partials/_hypercore-intro-short.mdx";
import HypercoreDirectCompress from "versionContent/_partials/_hypercore-direct-compress.mdx";
import NotAvailableFreePlan from "versionContent/_partials/_not-available-in-free-plan.mdx";
import CreateHypertablePolicyNote from "versionContent/_partials/_create-hypertable-columnstore-policy-note.mdx";

import SupportPlans from "versionContent/_partials/_support-plans.mdx";
Expand Down Expand Up @@ -166,7 +165,7 @@ relational and time-series data from external files.

You query $HYPERTABLEs in exactly the same way as you would a relational $PG table.
Use one of the following SQL editors to run a query and see the data you uploaded:
- **$DATA_MODE**: write queries, visualize data, and share your results in [$CONSOLE][portal-data-mode] for all your $SERVICE_LONGs. <NotAvailableFreePlan />
- **$DATA_MODE**: write queries, visualize data, and share your results in [$CONSOLE][portal-data-mode] for all your $SERVICE_LONGs.
- **$SQL_EDITOR**: write, fix, and organize SQL faster and more accurately in [$CONSOLE][portal-ops-mode] for a $SERVICE_LONG.
- **psql**: easily run queries on your $SERVICE_LONGs or self-hosted $TIMESCALE_DB deployment from Terminal.

Expand Down Expand Up @@ -201,8 +200,6 @@ $CONSOLE. You can also do this using psql.

<Tab title="Data view" label="data-mode">

<NotAvailableFreePlan />

<Procedure>

1. **In $CONSOLE, toggle `Data view` at the top right**
Expand Down
3 changes: 0 additions & 3 deletions migrate/upload-file-using-console.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,6 @@ keywords: [import]

import ImportPrerequisitesCloudNoConnection from "versionContent/_partials/_prereqs-cloud-no-connection.mdx";
import EarlyAccessGeneral from "versionContent/_partials/_early_access.mdx";
import NotAvailableFreePlan from "versionContent/_partials/_not-available-in-free-plan.mdx";
import NotSupportedAzure from "versionContent/_partials/_not-supported-for-azure.mdx";

# Upload a file into your $SERVICE_SHORT using $CONSOLE_LONG
Expand Down Expand Up @@ -119,8 +118,6 @@ To upload a TXT or MD file to your $SERVICE_SHORT:

$CONSOLE_LONG enables you to upload CSV and Parquet files, including archives compressed using GZIP and ZIP, by connecting to an S3 bucket.

<NotAvailableFreePlan />

## Prerequisites

<ImportPrerequisitesCloudNoConnection />
Expand Down
2 changes: 0 additions & 2 deletions use-timescale/metrics-logging/monitoring.md
Original file line number Diff line number Diff line change
Expand Up @@ -39,8 +39,6 @@ The following metrics are represented by graphs:
- Storage I/O, in ops/sec
- Storage bandwidth, in MiB/sec

The [$FREE $PRICING_PLAN][pricing-plan-features] only includes storage metrics.

When you hit the limits:

- **For CPU and memory**: provision more for your $SERVICE_SHORT in `Operations` > `Compute and storage`.
Expand Down
13 changes: 9 additions & 4 deletions use-timescale/services/change-resources.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,16 +21,18 @@ $SERVICE_LONGs at any time, with a short downtime.

## Update compute resources for a $SERVICE_SHORT

You can change the CPU and memory allocation for your $SERVICE_SHORT at any time with
You can change the CPU and memory allocation for your standard $SERVICE_SHORT at any time with
minimal downtime, usually less than a minute. The new resources become available as soon as
the $SERVICE_SHORT restarts. You can change the CPU and memory allocation up or down, as frequently as required.
the $SERVICE_SHORT restarts. You can change the CPU and memory allocation up or down, as frequently as required.

![Change resources][change-resources]

To change the resources of a free $SERVICE_SHORT, first [convert it to a standard one][convert-to-standard].

Note that:

- For the 48 CPU / 192 GiB option, 6 CPU / 14 GiB is reserved for platform operations.
- For the 64 CPU / 256 GiB option, 6 CPU / 16 GiB is reserved for platform operations.
- For the 64 CPU / 256 GiB option, 6 CPU / 16 GiB is reserved for platform operations.

There is momentary downtime while the new compute settings are applied. In most cases, this is
less than a minute. However, before making changes to your $SERVICE_SHORT, best practice
Expand Down Expand Up @@ -67,7 +69,7 @@ settings are applied during an appropriate service window.

## Out of memory errors

If you run intensive queries on your $SERVICE_SHORTs, you might
If you run intensive queries on your standard $SERVICE_SHORTs, you might
encounter out of memory (OOM) errors. This occurs if your query consumes more
memory than is available.

Expand Down Expand Up @@ -97,8 +99,11 @@ operate normally.
```yml
2022-02-03 17:12:04 UTC [2253150]:TimescaleDB: tsdbadmin@tsdb,app=psql [53200] ERROR: out of memory
```

If you encounter OOM errors on a free $SERVICE_SHORT, [convert it to a standard $SERVICE_SHORT][convert-to-standard], then increase its CPU and memory allocation as needed to resolve the memory pressure.

[change-resources]: https://assets.timescale.com/docs/images/tiger-on-azure/tiger-console-update-cpu-manually.png
[cloud-login]: https://console.cloud.timescale.com/
[convert-to-standard]: /use-timescale/:currentVersion:/services/service-management/#convert-a-free-service-to-a-standard-one
[high-availability]: /use-timescale/:currentVersion:/ha-replicas/high-availability/
[services-portal]: https://console.cloud.timescale.com/dashboard/services
12 changes: 12 additions & 0 deletions use-timescale/services/service-management.md
Original file line number Diff line number Diff line change
Expand Up @@ -109,6 +109,17 @@ To change the environment of an existing $SERVICE_SHORT:

</Procedure>

## Convert a free $SERVICE_SHORT to a standard one

You can convert a free $SERVICE_SHORT to a standard one, to increase its resources. Note that it is only available if you haven't reached the quota on the number of standard services [according to your pricing plan][pricing].

<Procedure>

1. In [$CONSOLE][services-portal], select the $SERVICE_SHORT to update.
1. Click `Operations` > `Environment` > `Convert service to standard` > `Yes, convert to standard`.

</Procedure>

## Pause a $SERVICE_SHORT

You can pause a $SERVICE_SHORT if you want to stop it running temporarily. When you
Expand All @@ -124,3 +135,4 @@ $SERVICE_SHORT.

[maintenance-upgrades]: /use-timescale/:currentVersion:/upgrades/#minor-software-upgrades
[services-portal]: https://console.cloud.timescale.com/dashboard/services
[pricing]: /about/:currentVersion:/pricing-and-account-management#features-included-in-each-pricing-plan
2 changes: 1 addition & 1 deletion use-timescale/upgrades.md
Original file line number Diff line number Diff line change
Expand Up @@ -86,7 +86,7 @@ $TIMESCALE_DB manually:
1. **Upgrade $TIMESCALE_DB**

Either:
- Click `SQL Editor` at the bottom, then run `ALTEREXTENSION timescaledb UPDATE`.
- Click `SQL Editor` at the bottom, then run `ALTER EXTENSION timescaledb UPDATE`.
- Click `⋮`, then `Pause` and `Resume` the service.

</Procedure>
Expand Down
Loading