Skip to content

Commit cda99a9

Browse files
nerda-codesnerda-codes
committed
docs(add): add banner and new page about deprecation
1 parent 7b2aaa3 commit cda99a9

File tree

6 files changed

+110
-20
lines changed

6 files changed

+110
-20
lines changed

‎macros/cockpit/grafana-users-deprecation.mdx‎

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
---
2+
macro: grafana-users-deprecation
3+
---
4+
5+
<Message type="iam">
6+
**Cockpit Grafana integration with IAM** <br /><br />
7+
From October 1st, 2025, you will be able to log in to Grafana using your Scaleway credentials. Legacy Grafana credentials will be deprecated by January 20th, 2026.
8+
Learn more about the transition in the [dedicated documentation](/cockpit/reference-content/grafana-authentication-with-iam/)
9+
</Message>

‎macros/cockpit/plan-deprecation.mdx‎

Lines changed: 0 additions & 19 deletions
This file was deleted.

‎pages/cockpit/concepts.mdx‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,7 @@ categories:
99
---
1010
import image from './assets/scaleway-traces-concept.webp'
1111

12+
import GrafanaUsersDeprecation from '@macros/cockpit/grafana-users-deprecation.mdx'
1213

1314
## Agent
1415

@@ -101,6 +102,8 @@ A Grafana user is any individual who can log in to [Grafana](https://grafana.com
101102
- The `admin` user is not yet available for creation.
102103
</Message>
103104

105+
<GrafanaUsersDeprecation />
106+
104107
## Loki
105108

106109
Loki is the log aggregation system used by [Grafana](https://grafana.com/docs/grafana/latest/introduction/) to store and query your logs.

‎pages/cockpit/how-to/access-grafana-and-managed-dashboards.mdx‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ dates:
77
posted: 2022-10-31
88
---
99
import Requirements from '@macros/iam/requirements.mdx'
10-
10+
import GrafanaUsersDeprecation from '@macros/cockpit/grafana-users-deprecation.mdx'
1111

1212
Scaleway provides you with preconfigured dashboards you can access in Grafana, for [Scaleway resources integrated with Cockpit](/cockpit/reference-content/cockpit-limitations/#product-integration-into-cockpit).
1313

@@ -19,6 +19,7 @@ This page shows you how to access [preconfigured dashboards](/cockpit/concepts/#
1919
- [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization
2020
- [Retrieved your Grafana credentials](/cockpit/how-to/retrieve-grafana-credentials/)
2121

22+
<GrafanaUsersDeprecation />
2223

2324
1. Click **Cockpit** in the **Monitoring** section of the [console](https://console.scaleway.com/) side menu. The **Cockpit** overview page displays.
2425
2. Click **Open dashboards** to open your preconfigured dashboards in Grafana. You are redirected to the Grafana website.

‎pages/cockpit/how-to/retrieve-grafana-credentials.mdx‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,7 @@ dates:
77
posted: 2022-10-31
88
---
99
import Requirements from '@macros/iam/requirements.mdx'
10+
import GrafanaUsersDeprecation from '@macros/cockpit/grafana-users-deprecation.mdx'
1011

1112

1213
This page shows you how to retrieve your Grafana credentials to access your preconfigured [dashboards](/cockpit/concepts/#preconfigured-dashboards) using the [Scaleway console](https://console.scaleway.com/).
@@ -16,6 +17,7 @@ This page shows you how to retrieve your Grafana credentials to access your prec
1617
- A Scaleway account logged into the [console](https://console.scaleway.com)
1718
- [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization
1819

20+
<GrafanaUsersDeprecation />
1921

2022
1. Click **Cockpit** in the **Monitoring** section of the [console](https://console.scaleway.com/) side menu. The **Cockpit** overview page displays.
2123
2. Click the **Grafana users** tab.

‎pages/cockpit/reference-content/grafana-authentication-with-iam.mdx‎

Lines changed: 94 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,94 @@
1+
---
2+
title: Authenticating to Cockpit's Grafana using IAM
3+
description: Learn how to create a custom data source and its data type using the Scaleway console. Follow the steps to choose a data type, select a region, and finalize the creation process.
4+
dates:
5+
validation: 2025-08-20
6+
posted: 2025-08-20
7+
---
8+
9+
Starting **October 1st, 2025**, Cockpit will be integrated with **Scaleway IAM**, enabling you to authenticate to your Cockpit's Grafana using your **Scaleway credentials** rather than Grafana credentials.
10+
11+
This page explains how to prepare for the transition.
12+
13+
14+
## Reasons for the change
15+
16+
We are simplifying authentication and improving security by:
17+
18+
- Removing the need to manage Grafana-specific users and passwords.
19+
- Enabling login using your existing **Scaleway credentials**.
20+
- Allowing central IAM-based access management.
21+
- Supporting **Multi-Factor Authentication (MFA)**.
22+
23+
## Transition timeline
24+
25+
| Event | Date |
26+
|------|------|
27+
| IAM authentication becomes available | **October 1st, 2025** |
28+
| Creating new Grafana users disabled | **October 1st, 2025** |
29+
| Legacy Grafana user login deprecation | **January 20th, 2026** |
30+
31+
32+
## What is changing?
33+
34+
### New login method
35+
36+
From **October 1st**, you will be able to log in using your Scaleway credentials via the Scaleway console or saved links.
37+
38+
### New dashboard URLs
39+
40+
To support both login methods during the transition, Grafana dashboards will have **new URLs**:
41+
42+
- **Old URL:**
43+
`https://<project_id>.dashboard.obs.fr-par.scw.cloud`
44+
45+
- **New URL (IAM-authenticated):**
46+
`https://<project_id>.dashboard.cockpit.scaleway.com`
47+
or
48+
`https://<project_id>.dashboard.cockpit.scw.cloud`
49+
50+
Both links will be functional until **January 20th, 2026**, after which only the new IAM-based URLs will remain valid.
51+
52+
## Who can access your Cockpit's Grafana?
53+
54+
Users must:
55+
56+
- Be **members** of your Scaleway Organization
57+
- Have access to the Scaleway Project where the Cockpit is located
58+
- Have been granted either the `ObservabilityReadOnly` or the `ObservabilityFullAccess` IAM permission set
59+
60+
You can manage members and permission sets in the [IAM section of the Scaleway console](https://console.scaleway.com/iam/members).
61+
62+
63+
## How to access your Cockpit's Grafana?
64+
65+
### From the Scaleway console
66+
67+
Access to Grafana using the Scaleway console remains the same as before.
68+
69+
1. Click **Cockpit** in the **Monitoring** section of the [console](https://console.scaleway.com/) side menu. The **Cockpit** overview page displays.
70+
2. Click **Open dashboards** to open your preconfigured dashboards in Grafana. You will be automatically logged in using your Scaleway account.
71+
72+
### From a saved/shared link
73+
74+
You can also access your Cockpit's Grafana using bookmarked links, alerts, or runbooks.
75+
76+
1. Open the new IAM-compatible URL. The Scaleway login page displays.
77+
2. Log in using your Scaleway credentials. Your Grafana dashboard displays.
78+
79+
## What will happen to existing Grafana users?
80+
81+
Grafana users not linked to Scaleway IAM will be deprecated. refer to the table below to find out until when you can perform which actions.
82+
83+
| Action | Available until |
84+
|--------|-----------------|
85+
| Log in using Grafana credentials | **January 20th, 2026** |
86+
| Generate passwords for existing Grafana users | **January 20th, 2026** |
87+
| Create new Grafana users | **Disabled after October 1st, 2025** |
88+
89+
## How to prepare for this transition?
90+
91+
If you have users who are not in your Scaleway Organization, we recommend the following:
92+
93+
- **Invite them as Members** to your Organization
94+
- Assign the `ObservabilityReadOnly` or the `ObservabilityFullAccess` permission sets only to the Projects they need to access

0 commit comments

Comments
 (0)