Install Promscale Connector using a Docker image with Timescale Cloud

You can install Promscale Connector from a Docker container using Timescale Cloud. This is useful for developing a proof of concept, or for testing purposes. Do not use this method in a production environment.

warning

Running Promscale from a Docker container is not suitable for production environments. This can be useful for testing purposes and is provided here as an example only.

Before you begin

  1. Install Docker on your local system. For packages and instructions, see the Docker installation documentation.
  2. Create a TimescaleDB service on Timescale Cloud.

Installing Promscale using Docker

  1. Run the Promscale Connector container on a network named promscale. Set the port forwards to port 9201 on your local system. Replace TS_CLOUD_DB_URI with the Service URL that you made note of when you created the TimescaleDB service:

    1. docker run --name promscale -d -p 9201:9201 \
    3. -db.uri=<TS_CLOUD_DB_URI>

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.

For upgrading Promscale Connector, see the upgrade section.