---
title: How to create a token
description: Learn how to create tokens to grant services and platforms access to your Scaleway Cockpit. Follow the steps to choose a region, select token permissions, and save the token's secret key.
tags: cockpit observability token
dates:
  validation: 2025-07-22
  posted: 2022-10-31
---
import Requirements from '@macros/iam/requirements.mdx'


This page shows you how to create [tokens](/cockpit/concepts/#cockpit-tokens), to grant other cloud providers’ services and platforms access to your [Cockpit](/cockpit/concepts/#cockpit).

<Requirements />

- A Scaleway account logged into the [console](https://console.scaleway.com)
- [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization

1. Click **Cockpit** in the **Monitoring** section of the [console](https://console.scaleway.com/) side menu. The **Cockpit** overview page displays.
2. Click the **Tokens** tab.
3. Click **+ Create token**. A pop-up displays.
4. Choose a region to create the token in.
    <Message type="important">
     Make sure that you create your token in the same region as the [data sources](/cockpit/concepts/#data-sources) you want to use it for.
    </Message>
5. Choose a name for your token or use the already-generated name.
6. Select the permissions you wish to apply to your token.
    <Message type="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.
    </Message>
7. Click **Create token** to confirm. A pop-up displays with your token's secret key. Make sure that you save the secret key before closing the pop-up.


<Message type="important">
 - Having the default configuration on your agents might lead to more of your resources' metrics being sent, a high consumption, and a high bill at the end of the month.
 - Sending metrics and logs for Scaleway resources or personal data using an external path is a billable feature. In addition, any data that you push yourself is billed, even if you send data from Scaleway products. Refer to the [product pricing page](https://www.scaleway.com/en/pricing/managed-services/#cockpit) for more information.
</Message>