Cockpit Global API

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

The Global API allows you to perform Cockpit visualization actions such as retrieving your dashboard URLs, managing Grafana users, and synchronizing your data through Grafana dashboards. Refer to the Cockpit APIOpen in new context documentation for information about data-related management.

Concepts

Refer to our dedicated concepts pageOpen in new context to learn about the different concepts and terms related to Cockpit.

Quickstart

1. Configure your environment variables.

   Note

   This is an optional step that aims to simplify your usage of the API.

   Code
   export SCW_SECRET_KEY="<API secret key>"
   export SCW_PROJECT_ID="<Scaleway Project ID>"

2. Create a Grafana user with the editor role.

   Code
   curl -X POST \
     -H "X-Auth-Token: $SCW_SECRET_KEY" \
     -H "Content-Type: application/json" \
     -d '{"login":"user-name","role":"editor","project_id":"<Scaleway Project ID>"}' \
     "https://api.scaleway.com/cockpit/v1/grafana/users"

   Note

   It is not possible to create a user with the admin username.

   Your user's password displays in the output. Make sure that you store it securely.

3. Retrieve a list of available dashboards in Grafana for all Scaleway resources integrated with Cockpit.

   Code
   curl -X GET \
     -H "X-Auth-Token: $SCW_SECRET_KEY" \
     "https://api.scaleway.com/cockpit/v1/grafana/product-dashboards?project_id=<Scaleway Project ID>"

   The list of available dashboards displays in the output.

Troubleshooting

Refer to our troubleshooting documentation if your pusher does not support HTTP headersOpen in new context or if you want to reset your Grafana passwordOpen in new context.

Technical limitations

• It is not possible to create an admin Grafana user.
• Available roles for Grafana users are viewer and editor.
• The Scaleway preconfigured dashboards cannot be edited.

Going further

For more information about Cockpit, you can check out the following pages:

• Cockpit documentationOpen in new context
• Scaleway Slack CommunityOpen in new context join the #observability channel
• Contact our Support teamOpen in new context.