diff --git a/docs/sources/about.md b/docs/sources/about.md index c33d73087408..57468c7f3e24 100644 --- a/docs/sources/about.md +++ b/docs/sources/about.md @@ -33,8 +33,8 @@ Grafana Agent is available in three different variants: [Prometheus]: "/docs/grafana-cloud/ -> /docs/agent//flow/tasks/collect-prometheus-metrics.md" [OTel]: "/docs/agent/ -> /docs/agent//flow/tasks/collect-opentelemetry-data.md" [OTel]: "/docs/grafana-cloud/ -> /docs/agent//flow/tasks/collect-opentelemetry-data.md" -[Loki]: "/docs/agent/ -> /docs/agent//flow/tasks/migrating-from-promtail.md" -[Loki]: "/docs/grafana-cloud/ -> /docs/agent//flow/tasks/migrating-from-promtail.md" +[Loki]: "/docs/agent/ -> /docs/agent//flow/tasks/migrate/from-promtail.md" +[Loki]: "/docs/grafana-cloud/ -> /docs/agent//flow/tasks/migrate/from-promtail.md" [clustering]: "/docs/agent/ -> /docs/agent//flow/concepts/clustering/_index.md" [clustering]: "/docs/grafana-cloud/ -> /docs/agent//flow/concepts/clustering/_index.md" [rules]: "/docs/agent/ -> /docs/agent/latest/flow/reference/components/mimir.rules.kubernetes.md" diff --git a/docs/sources/flow/reference/cli/convert.md b/docs/sources/flow/reference/cli/convert.md index 833341b47752..a9a3810ec3ee 100644 --- a/docs/sources/flow/reference/cli/convert.md +++ b/docs/sources/flow/reference/cli/convert.md @@ -82,7 +82,7 @@ This includes Prometheus features such as and many supported *_sd_configs. Unsupported features in a source configuration result in [errors]. -Refer to [Migrate from Prometheus to {{< param "PRODUCT_NAME" >}}]({{< relref "../../tasks/migrating-from-prometheus/" >}}) for a detailed migration guide. +Refer to [Migrate from Prometheus to {{< param "PRODUCT_NAME" >}}]({{< relref "../../tasks/migrate/from-prometheus/" >}}) for a detailed migration guide. ### Promtail @@ -96,7 +96,7 @@ are supported and can be converted to {{< param "PRODUCT_NAME" >}} configuration If you have unsupported features in a source configuration, you will receive [errors] when you convert to a flow configuration. The converter will also raise warnings for configuration options that may require your attention. -Refer to [Migrate from Promtail to {{< param "PRODUCT_NAME" >}}]({{< relref "../../tasks/migrating-from-promtail/" >}}) for a detailed migration guide. +Refer to [Migrate from Promtail to {{< param "PRODUCT_NAME" >}}]({{< relref "../../tasks/migrate/from-promtail/" >}}) for a detailed migration guide. ### Static @@ -113,4 +113,4 @@ flags with a space between each flag, for example `--extra-args="-enable-feature If you have unsupported features in a Static mode source configuration, you will receive [errors][] when you convert to a Flow mode configuration. The converter will also raise warnings for configuration options that may require your attention. -Refer to [Migrate from Grafana Agent Static to {{< param "PRODUCT_NAME" >}}]({{< relref "../../tasks/migrating-from-static/" >}}) for a detailed migration guide. \ No newline at end of file +Refer to [Migrate from Grafana Agent Static to {{< param "PRODUCT_NAME" >}}]({{< relref "../../tasks/migrate/from-static/" >}}) for a detailed migration guide. \ No newline at end of file diff --git a/docs/sources/flow/tasks/migrate/_index.md b/docs/sources/flow/tasks/migrate/_index.md new file mode 100644 index 000000000000..a0c98966dcb4 --- /dev/null +++ b/docs/sources/flow/tasks/migrate/_index.md @@ -0,0 +1,19 @@ +--- +aliases: +- /docs/grafana-cloud/agent/flow/tasks/migrate/ +- /docs/grafana-cloud/monitor-infrastructure/agent/flow/tasks/migrate/ +- /docs/grafana-cloud/monitor-infrastructure/integrations/agent/flow/tasks/migrate/ +- /docs/grafana-cloud/send-data/agent/flow/tasks/migrate/ +canonical: https://grafana.com/docs/agent/latest/flow/tasks/migrate/ +description: How to migrate to Grafana Agent Flow +menuTitle: Migrate +title: Migrate to Grafana Agent Flow +weight: 100 +--- + +# How to migrate to {{% param "PRODUCT_NAME" %}} + +This section details how to migrate to {{< param "PRODUCT_NAME" >}} from other +common solutions. + +{{< section >}} diff --git a/docs/sources/flow/tasks/migrating-from-operator.md b/docs/sources/flow/tasks/migrate/from-operator.md similarity index 97% rename from docs/sources/flow/tasks/migrating-from-operator.md rename to docs/sources/flow/tasks/migrate/from-operator.md index 375ffec59e51..1e942a2da941 100644 --- a/docs/sources/flow/tasks/migrating-from-operator.md +++ b/docs/sources/flow/tasks/migrate/from-operator.md @@ -1,19 +1,19 @@ --- aliases: -- /docs/grafana-cloud/monitor-infrastructure/agent/flow/tasks/migrating-from-operator/ -- /docs/grafana-cloud/send-data/agent/flow/tasks/migrating-from-operator/ +- /docs/grafana-cloud/monitor-infrastructure/agent/flow/tasks/migrate/from-operator/ +- /docs/grafana-cloud/send-data/agent/flow/tasks/migrate/from-operator/ # Previous page aliases for backwards compatibility: - /docs/grafana-cloud/monitor-infrastructure/agent/flow/getting-started/migrating-from-operator/ - /docs/grafana-cloud/send-data/agent/flow/getting-started/migrating-from-operator/ - ../getting-started/migrating-from-operator/ # /docs/agent/latest/flow/getting-started/migrating-from-operator/ -canonical: https://grafana.com/docs/agent/latest/flow/tasks/migrating-from-operator/ -description: Migrating from Grafana Agent Operator to Grafana Agent Flow +canonical: https://grafana.com/docs/agent/latest/flow/tasks/migrate/from-operator/ +description: Migrate from Grafana Agent Operator to Grafana Agent Flow menuTitle: Migrate from Operator -title: Migrating from Grafana Agent Operator to Grafana Agent Flow +title: Migrate from Grafana Agent Operator to Grafana Agent Flow weight: 320 --- -# Migrating from Grafana Agent Operator to {{% param "PRODUCT_NAME" %}} +# Migrate from Grafana Agent Operator to {{% param "PRODUCT_NAME" %}} With the release of {{< param "PRODUCT_NAME" >}}, Grafana Agent Operator is no longer the recommended way to deploy {{< param "PRODUCT_ROOT_NAME" >}} in Kubernetes. Some of the Operator functionality has moved into {{< param "PRODUCT_NAME" >}} itself, and the Helm Chart has replaced the remaining functionality. diff --git a/docs/sources/flow/tasks/migrating-from-prometheus.md b/docs/sources/flow/tasks/migrate/from-prometheus.md similarity index 98% rename from docs/sources/flow/tasks/migrating-from-prometheus.md rename to docs/sources/flow/tasks/migrate/from-prometheus.md index 837ca9da1e07..74a53f2475c5 100644 --- a/docs/sources/flow/tasks/migrating-from-prometheus.md +++ b/docs/sources/flow/tasks/migrate/from-prometheus.md @@ -1,16 +1,16 @@ --- aliases: -- /docs/grafana-cloud/agent/flow/tasks/migrating-from-prometheus/ -- /docs/grafana-cloud/monitor-infrastructure/agent/flow/tasks/migrating-from-prometheus/ -- /docs/grafana-cloud/monitor-infrastructure/integrations/agent/flow/tasks/migrating-from-prometheus/ -- /docs/grafana-cloud/send-data/agent/flow/tasks/migrating-from-prometheus/ +- /docs/grafana-cloud/agent/flow/tasks/migrate/from-prometheus/ +- /docs/grafana-cloud/monitor-infrastructure/agent/flow/tasks/migrate/from-prometheus/ +- /docs/grafana-cloud/monitor-infrastructure/integrations/agent/flow/tasks/migrate/from-prometheus/ +- /docs/grafana-cloud/send-data/agent/flow/tasks/migrate/from-prometheus/ # Previous page aliases for backwards compatibility: - /docs/grafana-cloud/agent/flow/getting-started/migrating-from-prometheus/ - /docs/grafana-cloud/monitor-infrastructure/agent/flow/getting-started/migrating-from-prometheus/ - /docs/grafana-cloud/monitor-infrastructure/integrations/agent/flow/getting-started/migrating-from-prometheus/ - /docs/grafana-cloud/send-data/agent/flow/getting-started/migrating-from-prometheus/ - ../getting-started/migrating-from-prometheus/ # /docs/agent/latest/flow/getting-started/migrating-from-prometheus/ -canonical: https://grafana.com/docs/agent/latest/flow/tasks/migrating-from-prometheus/ +canonical: https://grafana.com/docs/agent/latest/flow/tasks/migrate/from-prometheus/ description: Learn how to migrate from Prometheus to Grafana Agent Flow menuTitle: Migrate from Prometheus title: Migrate from Prometheus to Grafana Agent Flow diff --git a/docs/sources/flow/tasks/migrating-from-promtail.md b/docs/sources/flow/tasks/migrate/from-promtail.md similarity index 98% rename from docs/sources/flow/tasks/migrating-from-promtail.md rename to docs/sources/flow/tasks/migrate/from-promtail.md index d38e9b904697..89c863f8758f 100644 --- a/docs/sources/flow/tasks/migrating-from-promtail.md +++ b/docs/sources/flow/tasks/migrate/from-promtail.md @@ -1,16 +1,16 @@ --- aliases: -- /docs/grafana-cloud/agent/flow/tasks/migrating-from-promtail/ -- /docs/grafana-cloud/monitor-infrastructure/agent/flow/tasks/migrating-from-promtail/ -- /docs/grafana-cloud/monitor-infrastructure/integrations/agent/flow/tasks/migrating-from-promtail/ -- /docs/grafana-cloud/send-data/agent/flow/tasks/migrating-from-promtail/ +- /docs/grafana-cloud/agent/flow/tasks/migrate/from-promtail/ +- /docs/grafana-cloud/monitor-infrastructure/agent/flow/tasks/migrate/from-promtail/ +- /docs/grafana-cloud/monitor-infrastructure/integrations/agent/flow/tasks/migrate/from-promtail/ +- /docs/grafana-cloud/send-data/agent/flow/tasks/migrate/from-promtail/ # Previous page aliases for backwards compatibility: - /docs/grafana-cloud/agent/flow/getting-started/migrating-from-promtail/ - /docs/grafana-cloud/monitor-infrastructure/agent/flow/getting-started/migrating-from-promtail/ - /docs/grafana-cloud/monitor-infrastructure/integrations/agent/flow/getting-started/migrating-from-promtail/ - /docs/grafana-cloud/send-data/agent/flow/getting-started/migrating-from-promtail/ - ../getting-started/migrating-from-promtail/ # /docs/agent/latest/flow/getting-started/migrating-from-promtail/ -canonical: https://grafana.com/docs/agent/latest/flow/tasks/migrating-from-promtail/ +canonical: https://grafana.com/docs/agent/latest/flow/tasks/migrate/from-promtail/ description: Learn how to migrate from Promtail to Grafana Agent Flow menuTitle: Migrate from Promtail title: Migrate from Promtail to Grafana Agent Flow diff --git a/docs/sources/flow/tasks/migrating-from-static.md b/docs/sources/flow/tasks/migrate/from-static.md similarity index 97% rename from docs/sources/flow/tasks/migrating-from-static.md rename to docs/sources/flow/tasks/migrate/from-static.md index a4033dab096a..bf8532f207d9 100644 --- a/docs/sources/flow/tasks/migrating-from-static.md +++ b/docs/sources/flow/tasks/migrate/from-static.md @@ -1,16 +1,16 @@ --- aliases: -- /docs/grafana-cloud/agent/flow/tasks/migrating-from-static/ -- /docs/grafana-cloud/monitor-infrastructure/agent/flow/tasks/migrating-from-static/ -- /docs/grafana-cloud/monitor-infrastructure/integrations/agent/flow/tasks/migrating-from-static/ -- /docs/grafana-cloud/send-data/agent/flow/tasks/migrating-from-static/ +- /docs/grafana-cloud/agent/flow/tasks/migrate/from-static/ +- /docs/grafana-cloud/monitor-infrastructure/agent/flow/tasks/migrate/from-static/ +- /docs/grafana-cloud/monitor-infrastructure/integrations/agent/flow/tasks/migrate/from-static/ +- /docs/grafana-cloud/send-data/agent/flow/tasks/migrate/from-static/ # Previous page aliases for backwards compatibility: - /docs/grafana-cloud/agent/flow/getting-started/migrating-from-static/ - /docs/grafana-cloud/monitor-infrastructure/agent/flow/getting-started/migrating-from-static/ - /docs/grafana-cloud/monitor-infrastructure/integrations/agent/flow/getting-started/migrating-from-static/ - /docs/grafana-cloud/send-data/agent/flow/getting-started/migrating-from-static/ - ../getting-started/migrating-from-static/ # /docs/agent/latest/flow/getting-started/migrating-from-static/ -canonical: https://grafana.com/docs/agent/latest/flow/tasks/migrating-from-static/ +canonical: https://grafana.com/docs/agent/latest/flow/tasks/migrate/from-static/ description: Learn how to migrate your configuration from Grafana Agent Static to Grafana Agent Flow menuTitle: Migrate from Static to Flow title: Migrate Grafana Agent Static to Grafana Agent Flow @@ -388,10 +388,10 @@ The following list is specific to the convert command and not {{< param "PRODUCT [Agent Management]: "/docs/grafana-cloud/ -> /docs/grafana-cloud/send-data/agent/static/configuration/agent-management.md" [env]: "/docs/agent/ -> /docs/agent//flow/reference/stdlib/env.md" [env]: "/docs/grafana-cloud/ -> /docs/grafana-cloud/send-data/agent/flow/reference/stdlib/env.md" -[Prometheus Limitations]: "/docs/agent/ -> /docs/agent//flow/tasks/migrating-from-prometheus.md#limitations" -[Prometheus Limitations]: "/docs/grafana-cloud/ -> /docs/grafana-cloud/send-data/agent/flow/tasks/migrating-from-prometheus.md#limitations" -[Promtail Limitations]: "/docs/agent/ -> /docs/agent//flow/tasks/migrating-from-promtail.md#limitations" -[Promtail Limitations]: "/docs/grafana-cloud/ -> /docs/grafana-cloud/send-data/agent/flow/tasks/migrating-from-promtail.md#limitations" +[Prometheus Limitations]: "/docs/agent/ -> /docs/agent//flow/tasks/migrate/from-prometheus.md#limitations" +[Prometheus Limitations]: "/docs/grafana-cloud/ -> /docs/grafana-cloud/send-data/agent/flow/tasks/migrate/from-prometheus.md#limitations" +[Promtail Limitations]: "/docs/agent/ -> /docs/agent//flow/tasks/migrate/from-promtail.md#limitations" +[Promtail Limitations]: "/docs/grafana-cloud/ -> /docs/grafana-cloud/send-data/agent/flow/tasks/migrate/from-promtail.md#limitations" [Metrics]: "/docs/agent/ -> /docs/agent//static/configuration/metrics-config.md" [Metrics]: "/docs/grafana-cloud/ -> /docs/grafana-cloud/send-data/agent/static/configuration/metrics-config.md" [Logs]: "/docs/agent/ -> /docs/agent//static/configuration/logs-config.md"