Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 15 additions & 0 deletions pages/cockpit/concepts.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -60,6 +60,12 @@ Contacts define who gets notified when an alert is triggered or [resolved](#reso

Custom data is any data (metrics, logs or traces) that you may push to Cockpit. It can be data collected from your applications hosted at Scaleway or elsewhere.

## Data exports

Data exports allow you to automatically forward Scaleway metrics and logs from Cockpit to external tools. Only [products integrated into Cockpit](/cockpit/reference-content/cockpit-product-integration) are eligible, and keep in mind that not all products provide logs.
Exports start **from the moment they are created**, meaning data collected beforehand is not included in the export.
Exports are configured **per data source** (per region/Project). To export data from multiple regions or Projects, you must create one export per data source. You can also create multiple exports per data source if you want to send data to different [export destinations](#export-destination).

## Data sources

Data sources are regionalized backends that allow you to store and fetch your metrics, logs, and traces. By default, **Scaleway data sources** are enabled if you are using [Scaleway resources integrated with Cockpit](/cockpit/reference-content/cockpit-limitations/#product-integration-into-cockpit) on your Project.
Expand Down Expand Up @@ -90,6 +96,15 @@ An endpoint is the point of entry in a communication channel when two systems ar
- Sending metrics, logs and traces 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](https://www.scaleway.com/en/pricing/managed-services/#cockpit) for more information.
</Message>

## Export destination

Export destinations are external endpoints or tools where Cockpit sends your metrics and logs. Cockpit supports the following destinations:

- Datadog: requires your Datadog website URL and API key.
- OpenTelemetry endpoints: any OTLP/HTTP-compatible URL. You can add custom headers (tokens, metadata).

You can create several exports per data source to send data to different tools or environments.

## Grafana users

A Grafana user is any individual who can log in to [Grafana](https://grafana.com). Each user is associated with a role. There are two types of roles a user can have:
Expand Down
71 changes: 3 additions & 68 deletions pages/cockpit/faq.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: Cockpit FAQ
description: Discover Scaleway's Cockpit
dates:
validation: 2025-08-28
validation: 2025-11-28
productIcon: CockpitProductIcon
---

Expand Down Expand Up @@ -41,74 +41,9 @@ If you are using Scaleway's preconfigured dashboards in Grafana, make sure you h

## Pricing and billing

### How am I billed for using Cockpit with my Scaleway data?
### How am I billed for using Cockpit and its features?

Scaleway data is collected and available in Cockpit for free.

Retention is also free as long as it stays within the default period: 31 days for metrics and 7 days for logs. Data stored beyond the default period will incur charges based on daily storage volume.
You can [adjust the retention period](/cockpit/how-to/change-data-retention) from 1 day (for logs) or 31 days (for metrics) to 5 years. Refer to the [dedicated documentation](/cockpit/concepts/#retention) for more information on available retention periods.

### How am I billed for using Cockpit with custom data?

Sending custom data to Cockpit incurs ingestion costs.

Retention of custom data is free within the default period: 31 days for custom metrics and 7 days for custom logs and traces. Data stored beyond the default period will incur charges based on daily storage volume. You can [adjust the retention period](/cockpit/how-to/change-data-retention) from 1 day to 5 years.

Ingestion of custom data is billed as follows:

- Custom metrics are billed €0.15 per million samples of metrics ingested
- Custom logs are billed €0.35 per GB ingested
- Custom traces are billed €0.35 per GB ingested

Scaleway applies volume discounts to bill custom metrics. This means that the monthly pricing for custom metrics will be calculated in levels. **Scaleway applies six levels of volume discounts.**

| Levels | Range | Monthly pricing with volume discounts |
|--------------|----------------------------------------------|------------------------------------------|
| Level one | From 0 to 10 billion custom metrics | €0.15 per million samples |
| Level two | From 10 to 25 billion custom metrics | €0.13 per million samples |
| Level three | From 25 to 50 billion custom metrics | €0.12 per million samples |
| Level four | From 50 to 100 billion custom metrics | €0.11 per million samples |
| Level five | From 100 to 200 billion custom metrics | €0.10 per million samples |
| Level six | From 200 billion custom metrics and beyond | €0.08 per million samples |


Here is an example of how you would be billed for **sending 52 billion custom metrics samples per month**:

- 10 billion samples at €0.15 per million samples: €1.500
- 15 billion samples at €0.13 per million samples: €1.950
- 25 billion samples at €0.12 per million samples: €3.000
- 2 billion samples at €0.11 per million samples: €220

**Total:** €6.670 per month with volume discounts instead of €7.800 without volume discounts.

Refer to our [documentation on understanding and managing Cockpit ingestion to reduce costs](/cockpit/reference-content/understanding-cockpit-usage/) for more information on how to reduce extra costs when ingesting custom data.

### How am I billed for increasing data retention period?

All ingested data, whether from Scaleway or custom sources, is retained for free within the default periods:
- Metrics: 31 days
- Logs and traces: 7 days

**Data stored beyond the default period will incur charges based on daily storage volume**:

- Metrics: €0.0002 per 10 million samples/day
- Logs and traces: €0.002 per GB/day

If you delete your data source or reduce its retention period below the default value, data will be deleted and you will no longer be charged for extended retention.

<Accordion>
## See custom retention pricing examples
### For 10 days of retention
If you ingest an average of **2 GB of logs daily** and increase retention to **10 days**. Retention is free for the first **7 days**, so you are only charged for the extra **3 days**:

**Monthly estimated cost:**
`retention_cost` = 2 GB x (10 - 7) x 0.002€ x 30 days = 0.36€/month

### For 90 days of retention
If you extend retention to **90 days**, you are charged for the extra **83 days** beyond the free period:
**Monthly estimated cost:**
`retention_cost` = 2 GB x (90 - 7) x 0.002€ x 30 days = 9.96€/month
</Accordion>
Refer to the dedicated [Cockpit pricing information](/cockpit/reference-content/cockpit-pricing) page for a detailed explanation on Cockpit pricing.

## Usage and management

Expand Down
96 changes: 96 additions & 0 deletions pages/cockpit/how-to/manage-data-exports.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,96 @@
---
title: How to manage data exports
description: Learn how to create, update, and delete Cockpit metrics and logs data exports
dates:
validation: 2025-11-24
posted: 2025-11-24
---
import Requirements from '@macros/iam/requirements.mdx'


This page shows you how to create, update, and delete Cockpit [data exports](/cockpit/concepts/#data-exports) from the Scaleway console.

<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 Project
- Created [Scaleway products integrated into Cockpit](/cockpit/reference-content/cockpit-product-integration/)


<Message type="important">
- Data exports only concern Scaleway metrics and logs, and only for [Scaleway products integrated into Cockpit](/cockpit/reference-content/cockpit-product-integration). Some products export metrics but do not generate logs.
- Data collection begins only once the export is created. Any data collected beforehand will not be included in the export.
</Message>


## How to create a data export

1. Click **Cockpit** in the **Monitoring** section of the [console](https://console.scaleway.com/) side menu. The **Cockpit** overview page displays.
2. In the **Region** drop-down, select the region where your resources are located.
3. Click the **Data sources** tab.
4. Click the **Settings** icon of the Scaleway data source (metrics or logs), from which you want to export data. The data source's **Overview** tab displays.
5. Click **Create** under the **Data exports** section.
<Message type="tip">
If you have already created an export, navigate to your data source's **Settings** tab and click **Create export** in the dedicated section.
</Message>
6. Choose an export destination:

<Tabs>
<TabsTab label="Datadog">
- Enter the URL of your Datadog site in the **URL** field. For example `https://api.datadoghq.eu/` for metrics or `https://http-intake.logs.datadoghq.eu/` for logs.

- Enter your Datadog API key in the **Datadog API Key** field.
</TabsTab>
<TabsTab label="Open Telemetry">
- Enter your Open Telemetry endpoint in the **URL** field.
- Click **+ Add header** to add a header and attach extra information, like credentials or metadata, to your HTTP requests.
- Enter your token in the **Key** field.
- Enter your token value in the **Value** field.
- Optionally, click **+ Add header** to add more headers.
</TabsTab>
</Tabs>
7. In the **Products** drop-down, choose products whose metrics/logs you want to export.
<Message type="note">
- Only products that provide metrics/logs to Cockpit are eligible for export. Find out which products are eligible in the [dedicated documentation](/cockpit/reference-content/cockpit-product-integration).
- Selecting **All current and future products** means that all present Scaleway resources sending metrics/logs to Cockpit, and any future ones you create, will automatically be exported.
</Message>
8. In the **Data export details** section, enter a name for your data export, and optionally add a description.
9. Review your purchase summary and click **Create data export** to confirm.

Your export displays in your data source's **Settings** tab, under the **Data exports** section.

<Message type="note">
- The volume of exported data can vary over time, depending on your infrastructure and workload. For example, creating more Instances increases metrics, and busy Serverless Functions generate more logs.
- Data exports are created at the **data source level**. If you want to export data from several regions or Projects, you must create one export per region/Project.
- You can create multiple exports per data source if needed (e.g., sending data to different external tools).
- During the beta period, export creation may take a few minutes (up to 30 minutes) to complete and start exporting data to your endpoint.
- Scaleway products may send metrics at different intervals (1 or 5 minutes).
</Message>

## How to update a data export

1. Click **Cockpit** in the **Monitoring** section of the [console](https://console.scaleway.com/) side menu. The **Cockpit** overview page displays.
2. Click the **Data sources** tab, then the Scaleway data source you want to edit the export of.
3. Click the **Settings** tab.
4. Click the <Icon name="seeMore" /> icon next to the data export you want to edit, then click **Edit**.
5. Edit your data export as necessary, then click **Edit data export** to confirm.

## How to delete a data export

1. Click **Cockpit** in the **Monitoring** section of the [console](https://console.scaleway.com/) side menu. The **Cockpit** overview page displays.
2. Click the **Data sources** tab, then the data source you want to delete the export of.
3. Click the **Settings** tab.
4. Click the <Icon name="delete" /> icon next to the data export you want to delete. A pop-up appears.
5. Type **DELETE** and click **Delete export** to confirm.

<Message type="important">
- Deleting an export stops forwarding data to the export destination.
- Deletion may take a few minutes before the change becomes fully effective.
</Message>

## How to monitor data exports

You can monitor your data exports in real time from your Cockpit Grafana dashboard.

You are **responsible for how your exported data is used** and for **any changes in resource volume**. Adding resources naturally increases the number of generated metrics and logs, and the exported volume may fluctuate even without manual action (for example, autoscaling creates additional resources, resulting in more data to export).
Find out how data exports are billed in the [dedicated documentation page](/cockpit/reference-content/cockpit-pricing/#billing-information-for-cockpit-data-exports).
8 changes: 8 additions & 0 deletions pages/cockpit/menu.ts
Original file line number Diff line number Diff line change
Expand Up @@ -50,6 +50,10 @@ export const cockpitMenu = {
label: 'Create a custom data source',
slug: 'create-external-data-sources',
},
{
label: 'Manage data exports',
slug: 'manage-data-exports',
},
{
label: 'Change data retention period',
slug: 'change-data-retention',
Expand Down Expand Up @@ -108,6 +112,10 @@ export const cockpitMenu = {
label: 'Cockpit capabilities and limits',
slug: 'cockpit-limitations',
},
{
label: 'Cockpit pricing information',
slug: 'cockpit-pricing',
},
{
label:
'Cockpit supported API endpoints for data source management',
Expand Down
Loading
Loading