Cockpit - Quickstart

Reviewed on January 23, 2026

Scaleway's Observability Cockpit allows you to monitor your applications and their infrastructure by giving you insights and context into their behavior. With Cockpit, you can visualize your resources' and applications' metrics, logs, and traces in Grafana dashboards. Cockpit is automatically activated when you are using Scaleway resources that are integrated into it.

The Observability Cockpit provides you with endpoints to push metrics, logs, and traces.

Learn how to reduce extra costs and understand Cockpit pricing.

In this documentation, we show you how to create a push token to send metrics and logs to your Cockpit. We include tips to go further at the end of this Quickstart, to show you how you can configure the Grafana Alloy agent to push your metrics, logs, and traces to Cockpit and visualize your data in Grafana.

Console overview

Discover the Cockpit interface on the Scaleway console.

Before you start

To complete the actions presented below, you must have:

• A Scaleway account logged into the console
• Owner status or IAM permissions allowing you to perform actions in the intended Organization

How to create a Cockpit token to push your metrics and logs

1. Click Cockpit in the Monitoring section of the console side menu. The Cockpit overview page displays.
2. Click the Tokens tab.
3. Click Create token. A pop-up displays prompting you to create a token.
4. Choose the region to create the token in.
   Important

   Make sure that you create your token in the same region as the data sources you want to use it for.

5. Choose a name for your token or use the already-generated name.
6. Select the permissions you wish to apply to your token.
   Important

   You must select at least one permission. Permissions include:

   • Push: allows you to send your metrics, logs and traces to your Cockpit.
   • Query: allows you to fetch your metrics, logs and traces from your Cockpit.
   • Rules: allow you to configure alerting and recording rules.
   • Alerts: allow you to set up the alert manager.
7. Click Create token to confirm. A pop-up displays with your secret key. Make sure that you save the secret key before closing the pop-up.

How to configure the alert manager

Enabling Scaleway's regionalized alert manager allows you configure preconfigured alerts for your Scaleway resources.

1. Click Cockpit in the Monitoring section of the console side menu. The Cockpit overview page displays.
2. Click the Alerts tab.
3. Click the Region drop-down and select the desired region.
   Important

   Make sure that you select the same region as the data sources you want to be alerted for.

4. Click Enable alert manager under the Alert manager section. A pop-up displays prompting you to configure alert notifications.
   Tip

   Configuring alert notifications consists of two steps:

   • Enabling the alert manager, and
   • Adding contacts This allows the contacts to receive notifications whenever alerts you have configured are triggered.
5. Click Enable alert manager to confirm. The step for adding contacts displays.
6. Enter an email address, then click + Add email and Add contacts. Your email address displays in the Contacts section, and by default, the Resolved notifications box is ticked. This means that you will receive notifications for resolved alerts.
7. Optionally, click Skip for now if you do not want to add contacts yet.
   Note

   You are prompted to create contacts when enabling the alert manager for the first time, or when re-enabling it after disabling. However, you can also add or manage them independently from the alert manager configuration at any time.

How to add contacts

You are prompted to create contacts when enabling the alert manager for the first time, or when re-enabling it after disabling. However, you can also perform this step independently from the alert manager configuration at any time.

1. Click Cockpit in the Monitoring section of the console side menu. The Cockpit overview page displays.
2. Click the Alerts tab.
3. Click the Region drop-down and select the desired region.
   Important

   Make sure that you select the same region as the data sources you want your contacts to be alerted for.

4. Click Add email in the Contacts section. A pop-up displays.
5. Enter an email address, then click + Add email. Your email address displays and by default, the Resolved notifications checkbox is ticked. This means that you will receive notifications for resolved alerts.
6. Optionally, enter another email and click + Add email to add another contact.
7. Click Add contacts to confirm. The email addresses appears in the list of your contacts.