Update content

How to create a token

Reviewed on 22 March 2023Published on 31 October 2022

This page shows you how to create tokens, to grant other cloud providers’ services and platforms access to your Cockpit.

Security & Identity (IAM):

You may need certain IAM permissions to carry out some actions described on this page. This means:

  • you are the Owner of the Scaleway Organization in which the actions will be carried out, or
  • you are an IAM user of the Organization, with a policy granting you the necessary permission sets
  1. Click Cockpit in the Observability section of the console side menu. The Cockpit overview page displays.

  2. Click the APIs and Tokens tab.

  3. Click Generate token to create a token. A pop-up displays prompting you to create a token.

  4. Choose a name for your token or use the already-generated name.

  5. Select the permissions you wish to apply to your token.


    You must select at least one permission. Permissions include:

    • Push: allows you to send your metrics and logs to your Cockpit.
    • Query: allows you to fetch your metrics and logs from your Cockpit.
    • Rules: allow you to configure alerting and recording rules.
    • Alerts: allow you to set up the alert manager.
  6. Click Generate token to generate your token. A pop-up displays with your secret key.


    Make sure to save your secret key before closing the pop-up.

Your newly-created token displays in the list of your tokens.

  • 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 for more information.
See Also