Install Promscale on Kubernetes

You can install Promscale on Kubernetes using Helm or using a manifest file.

note

Before installing Promscale, refer to:

  • Promscale Resource recommendation guide to understand the resource requirements.
  • Promscale Configuration recommendation guide to understand configuration requirements.

Before you begin

Install the Promscale using Helm chart

Promscale needs to access your TimescaleDB database. You can provide the database URI, or specify connection parameters.

Installing the Promscale using Helm chart

  1. Add the TimescaleDB Helm chart repository:

1. helm repo add timescale 'https://charts.timescale.com' 2. Check that the repository is up to date:

1. helm repo update 3. Install the Promscale Helm chart. Replace RELEASE_NAME with the name of your choice and TS_CLOUD_DB_URI with the Service URL that you made note of when you created the TimescaleDB service:

1. helm install <RELEASE_NAME> timescale/promscale --set connection.uri=<TS_CLOUD_DB_URI>

Install Promscale with a manifest file

You can install the Promscale Connector using a manifest file.

Installing the Promscale Connector with a manifest

  1. Download the template manifest file:

1. curl https://raw.githubusercontent.com/timescale/promscale/0.14.0/deploy/static/deploy.yaml --output promscale-connector.yaml 2. Edit the manifest and configure the TimescaleDB database details. Add the <PROMSCALE_DB_URI> parameter in promscale secret, and remove the other <PROMSCALE_DB_*> parameters. These are not required, because Promscale Connector integrates with Timescale Cloud directly. 3. Deploy the manifest:

1. kubectl apply -f promscale-connector.yaml

When you have installed Promscale, you can ingest data in a few different ways:

  • Migrate existing Prometheus data with Prom-migrator.
  • Ingest incoming data. For more information, see the send data section.