fix(tem): cockpit (#4578)

Author: ldecarvalho-doc

pages/transactional-email/how-to/monitor-databases-cockpit.mdx

@@ -0,0 +1,82 @@
+---
+meta:
+  title: How to monitor your Transactional Email with Scaleway Cockpit
+  description: Learn how to effectively monitor your Transactional Email using Scaleway Cockpit for optimal deliverability and performance.
+content:
+  h1: How to monitor your Transactional Email with Scaleway Cockpit
+  paragraph: Learn how to effectively monitor your Transactional Email using Scaleway Cockpit for optimal deliverability and performance.
+tags: transactional-email email-deliverability cockpit observability dashboard metrics logs alerts
+dates:
+  validation: 2025-03-05
+  posted: 2025-03-05
+categories:
+  - transactional-email
+---
+
+You can use Scaleway Cockpit to track TEM metrics and monitor email activity, detect potential deliverability issues, and check key indicators to track your domain's reputation.
+
+This page explains how to get started with Scaleway Cockpit for viewing your Transactional Email metrics and logs.
+
+<Macro id="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
+- [Configured your domain(s) with Transactional Email](/transactional-email/how-to/configure-domain-with-transactional-email/)
+- Added [SPF, DKIM](/transactional-email/how-to/add-spf-dkim-records-to-your-domain/), [MX](/transactional-email/how-to/add-mx-record-to-your-domain/) and [DMARC](/transactional-email/how-to/add-dmarc-record/) records to your domain(s)
+
+## How to activate your Cockpit
+
+Scaleway Cockpit is activated by default if you have created any [Scaleway resources integrated with Cockpit](/cockpit/reference-content/cockpit-limitations/#product-integration-into-cockpit).
+
+## How to access the Grafana dashboard
+
+To view your TEM metrics, use the Grafana dashboard which is accessible from the Scaleway console:
+  - First, you must create a user and their associated credentials (a username and password) for Grafana
+  - Then, you can use these credentials to access the Grafana dashboard for all your Scaleway products, via the Scaleway console.
+
+1. Create a Grafana user and retrieve their username and password by [following this procedure](/cockpit/how-to/retrieve-grafana-credentials/).
+
+2. From the Scaleway console [Cockpit overview page](https://console.scaleway.com/cockpit/overview), click **Open dashboards** in the top right corner.
+
+3. Enter your Grafana username and password to log in.
+
+    You are directed to the Scaleway Cockpit dashboards homepage.
+
+## How to view and understand your TEM metrics
+
+1. Click **Open dashboards** on the top right from the Scaleway Cockpit dashboards homepage.
+2. Click either **TEM Overview** or **TEM Overview**, depending on your engine of choice, on the left side menu.
+
+    You are directed to the TEM Overview dashboard.
+
+    <Lightbox src="scaleway-grafana-tem.webp" alt="" />
+
+Metrics are refreshed every minute, and report on the following data:
+
+### List of Metrics
+
+| Category | Metric | Description |
+| --- | --- | --- |
+| Reputation | Current Reputation Score | Current reputation score of the domain. |
+| Reputation | Reputation Score Evolution | Historical and evolution of the reputation score. |
+| Email Activity | Global Email Traffic Distribution by IP Kind | Distribution of email traffic between dedicated and shared IPs. |
+| Email Activity | Global Email Traffic by IP Kind | Total volume of emails sent, segmented by IP type. |
+| Email Activity | Email Activity - All IP | Total number of emails delivered and rejected across all IPs. |
+| Email Activity | General Activity - All IP | Overview of email traffic. |
+| Email Activity | Email Rejected Distribution - All IP | Distribution of rejected emails by rejection type. |
+| Errors | Errors Activity - All IP | Main recipient domains of sent emails. |
+| Destinations and Rejections | Top Recipient Destination - All IP | Main recipient domains of sent emails. |
+| Destinations and Rejections | Top Bounce Recipient - All IP | List of recipients with the most bounces. |
+| Destinations and Rejections | Top Fail Recipient - All IP | List of recipients for whom emails consistently failed. |
+
+<Message type="important">
+  Metrics on dedicated IPs are only accessible to users that subscribe to the Scale offer.
+</Message>
+
+### Choosing metric parameters
+
+At the top of the dashboard, you can configure the following parameters, that control which metrics are displayed:
+
+- **Resource name** - Select a specific Database Instance to monitor.
+- **Node** - Choose a specific node (main, replica, or Read Replica). In a High Availability (HA) cluster, both nodes might switch from main to replica and vice versa. So you might see two versions of the same node, as main and as replica. If you select main for a specific node, you will only see the node's activity when it was the main, and vice-versa.
+- **Timeframe** - Get metrics from the last five minutes up to 31 days (free plan) and 365 days (premium plan).