docs(cpt): troubleshooting (#4343)

Author: nerda-codes

menu/navigation.json

@@ -3825,6 +3825,10 @@
               },
               {
                 "items": [
+                  {
+                    "label": "No data showing up on Grafana dashboards",
+                    "slug": "synchronize-grafana-data-sources"
+                  },
                   {
                     "label": "Resetting a Grafana password",
                     "slug": "resetting-grafana-password-via-the-api"

pages/cockpit/troubleshooting/assets/scaleway_cpt_grafana_datasources_troubleshooting.webp

@@ -6,7 +6,7 @@ meta:
   paragraph: Reset your Grafana user password using the Scaleway API. Retrieve your Grafana user ID and reset the password with a simple curl command.
 tags: grafana password credentials
 dates:
-  validation: 2024-12-26
+  validation: 2025-02-03
   posted: 2023-04-03
 categories:
   - observability
@@ -18,7 +18,6 @@ This page shows you how to reset your Grafana user's password through the Scalew
 
   - A Scaleway account logged into the [console](https://console.scaleway.com)
   - [Created](/iam/how-to/create-api-keys/) an API key with sufficient [IAM permissions](/iam/reference-content/permission-sets/) to perform the actions described on this page
-  - [Installed](https://curl.se/download.html) curl
 
 
 1. Click **Cockpit** in the Observability section of the [console](https://console.scaleway.com/) side menu. The **Cockpit** overview page displays.

pages/cockpit/troubleshooting/resetting-grafana-password-via-the-api.mdx

@@ -0,0 +1,47 @@
+---
+meta:
+  title: No data showing up on Grafana dashboards
+  description: Fix Grafana data synchronization issues and ensure data appears on Cockpit dashboards with this troubleshooting guide.
+  h1: No data showing up on Grafana dashboards
+  paragraph: Fix Grafana data synchronization issues and ensure data appears on Cockpit dashboards with this troubleshooting guide.
+tags: grafana data-sources synchronization sync no-data dashboard
+dates:
+  validation: 2025-02-06
+  posted: 2025-02-06
+categories:
+  - observability
+---
+
+This page shows you how to visualize your data again when it does not display on your Grafana dashboards, using the `SyncGrafanaDataSources` [endpoint](https://www.scaleway.com/en/developers/api/cockpit/v1/global-api/#path-grafana-synchronize-grafana-data-sources) of the [Cockpit Global API](https://www.scaleway.com/en/developers/api/cockpit/v1/global-api/#path-grafana-synchronize-grafana-data-sources).
+
+<Message type="important">
+ The [Cockpit Global API](https://www.scaleway.com/en/developers/api/cockpit/v1/global-api/#path-grafana-synchronize-grafana-data-sources) contains deprecated information that is being updated, you should  not use it for any other purpose than the one described on this page.
+</Message>
+
+<Macro id="requirements" />
+
+  - A Scaleway account logged into the [console](https://console.scaleway.com)
+  - [Created](/iam/how-to/create-api-keys/) an API key with sufficient [IAM permissions](/iam/reference-content/permission-sets/) to perform the actions described on this page
+  - [Installed](https://curl.se/download.html) curl
+
+
+## Problem
+
+Many Cockpit users often encounter issues with Grafana data sources not synchronizing properly, leading to missing data on dashboards when data should be available.
+
+When users open their Grafana dashboards, they see a `No data` message along with an error banner stating: `Failed to upgrade legacy queries datasource was not found`.
+
+<Lightbox src="scaleway_cpt_grafana_datasources_troubleshooting.webp" alt="Grafana dashboard showing error messages and warning signs of no data found for the user's datasources" />
+
+
+## Solution
+
+Open a terminal and run the following command to trigger the synchronization of your data sources:
+    ```bash
+    curl -X POST \
+    -H "X-Auth-Token: $SCW_SECRET_KEY" \
+    -H "Content-Type: application/json" \
+    -d '{"project_id":"$SCALEWAY_PROJECT_ID"}' \
+    "https://api.scaleway.com/cockpit/v1/grafana/sync-data-sources"
+
+Make sure that you replace `$SCW_SECRET_KEY` with your API secret key and `$SCALEWAY_PROJECT_ID` with the ID of the Scaleway Project affected by the issue.