From 86f416d59786ca26ef9e582748a3b6c57226994a Mon Sep 17 00:00:00 2001 From: Ashwanth Goli Date: Fri, 7 Feb 2025 12:09:13 +0530 Subject: [PATCH] fixup! make corrections to the example configs + update table entries --- .../setup/migrate/migrate-storage-clients/_index.md | 13 +++++-------- 1 file changed, 5 insertions(+), 8 deletions(-) diff --git a/docs/sources/setup/migrate/migrate-storage-clients/_index.md b/docs/sources/setup/migrate/migrate-storage-clients/_index.md index b2b1a1f84c956..1dbb67f6d88da 100644 --- a/docs/sources/setup/migrate/migrate-storage-clients/_index.md +++ b/docs/sources/setup/migrate/migrate-storage-clients/_index.md @@ -8,12 +8,14 @@ weight: Loki release 3.4 introduces new object storage clients based on the [Thanos Object Storage Client Go module](https://github.com/thanos-io/objstore). -One of the reasons for making this change is to have a consistent storage configuration across Grafana Loki, Grafana Mimir and other telemetry databases from Grafana Labs. If you are already using Grafana Mimir or Pyroscope, you can reuse the storage configuration for setting up Loki. +One of the reasons for making this change is to have a consistent storage configuration across Grafana Loki, Mimir and other telemetry databases from Grafana Labs. If you are already using Grafana Mimir or Pyroscope, you can reuse the storage configuration for setting up Loki. This is an opt-in feature with the Loki 3.4 release. In a future release, Thanos will become the default way of configuring storage and the existing storage clients will be deprecated. +{{< admonition type="note" >}} The new storage configuration deviates from the existing format. The following sections describe the changes in detail for each provider. Refer to the [Thanos storage configuration reference](https://grafana.com/docs/loki//configure/#thanos_object_store_config) to view the complete list of supported storage providers and their configuration options. +{{< /admonition >}} ### Enable the new storage clients @@ -50,12 +52,6 @@ Refer to the [Thanos storage configuration reference](https://grafana.com/docs/l gcs: bucket_name: "example-bucket" ``` - -{{< admonition type="note" >}} -Following sections document the steps for migrating the clients. Only some of the commonly used parameters are listed here. -For a complete list of supported parameters, refer to the [Thanos storage configuration reference](https://grafana.com/docs/loki//configure/#thanos_object_store_config) and compare that to what you are using in your setup. -{{< /admonition >}} - ### GCS Storage Migration When migrating from the existing [Google Cloud Storage (GCS)](https://grafana.com/docs/loki//configure/#gcs_storage_config) storage client to the new Thanos-based client, you'll need to update your configuration parameters as follows: @@ -184,6 +180,7 @@ When migrating from the existing [Azure](https://grafana.com/docs/loki/}} If you are using an authentication method other than storage account key or user-assigned managed identity, you'll have to pass the neccessary credetials using environment variables. @@ -191,7 +188,7 @@ For more details, refer to [Azure Identity Client Module for Go](https://pkg.go. ### Filesystem Storage Migration -When migrating from the existing [Filesystem storage](https://grafana.com/docs/loki//configure/#filesystem_object_storage_config) +When migrating from the existing [Filesystem storage](https://grafana.com/docs/loki//configure/#local_storage_config) client to the new Thanos-based client, update or remove parameters as follows: {{< responsive-table >}}