NavigationContentFooter
Jump toSuggest an edit

Cockpit - Quickstart

Reviewed on 19 June 2024Published on 31 October 2022

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 retrieve your Grafana credentials to access your Grafana, and 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.

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

How to retrieve your Grafana credentials

  1. Click Cockpit in the Observability section of the console side menu. The Cockpit overview page displays.
  2. Click the Grafana users tab.
  3. Click Add user.
  4. Enter a username.
  5. Select a role for the user.
  6. Click Add a user. Your automatically generated password to log in to Grafana displays. Make sure to copy and save it before closing the pop-up.

How to create a token to push your metrics and logs

  1. Click Cockpit in the Observability 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.

Going further

If you have not set up an agent yet, check out our documentation to find out how to configure Grafana Alloy, push your metrics, and visualize them in Grafana. You must have created resources to monitor to push your data to Cockpit.

API DocsScaleway consoleDedibox consoleScaleway LearningScaleway.comPricingBlogCareers
© 2023-2024 – Scaleway