> For the complete documentation index, see [llms.txt](https://docs.groundcover.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.groundcover.com/getting-started/migrations.md).

# Migrations

### Overview

When switching to a new observability platform, there is the concern of high effort of switch due to the many assets already created in the previous platform.

groundcover's migration flow discovers, translates, and installs your observability setup into groundcover.

### Getting Started

Navigate to the [migrations page](https://app.groundcover.com/migrations) to get started. Note that Admin role is required to access this page.

Select the relevant platform to migrate from and get started.

### How it works

1. **Fetch & discover:** Provide API keys. groundcover pulls your monitors, dashboards, and data sources.
2. **Automatic translation:** All the pulled assets are automatically being converted to groundcover assets within the migration page.
3. **Migrate assets:** Review and migrate missing data sources, monitors and dashboards with one click.

API keys are not stored.

### What we migrate

#### Monitors

Includes alert conditions, thresholds, and evaluation windows.

#### Dashboards

Complete dashboard migration with preserved layouts:

* All widget types groundcover supports
* Query translations
* Time ranges and filters
* Visual settings and arrangements

#### Data Sources

Based on the metrics in use, we detect which data sources are missing and help you set it up in groundcover.

#### Data & Mapping

We don't just copy configurations - we ensure the data flows:

* **Automatic metric mapping:** metric names translated to groundcover equivalents
* **Label translation:** Tags become labels with intelligent mapping
* **Query conversion:** query syntax of the source platform converted to groundcover
* **Data validation:** We verify all referenced metrics and data sources exist

### Supported providers

#### Datadog

Full migration support available now.

[Migrate from Datadog →](/getting-started/migrations/migrate-from-datadog.md)

#### Other providers

Additional vendors coming soon.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.groundcover.com/getting-started/migrations.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.