feat(k8s): add macro & cards

Author: bene2k1

macros/kubernetes/kubernetes-cockpit-intro.mdx

@@ -0,0 +1,19 @@
+---
+macro: kubernetes-cockpit-intro
+---
+
+Scaleway’s [Cockpit](/cockpit/quickstart/) provides a centralized solution for monitoring and logging in of your Kubernetes applications, helping you gain insights into cluster activity, performance, and security.
+
+With Cockpit, you can:
+
+- **Monitor your Kubernetes cluster**: Gain real-time visibility into the control plane, nodes, managed resources, and system applications.
+- **Analyze logs**: View logs from all your Kubernetes containers in one place to enhance observability and simplify troubleshooting.
+- **Track activity**: Audit logs provide detailed records of user actions, application API calls, and control plane operations, helping with compliance and security.
+
+Cockpit integrates with **Grafana** for rich data visualization and provides **automated monitoring** without the need to configuure additional infrastructure.
+
+<Message type="note">  
+  **Cost considerations**: Sending logs to Cockpit incurs costs based on ingestion volume. See the [Cockpit FAQ](/faq/cockpit/#how-am-i-billed-for-using-cockpit-with-custom-data) for pricing details and best practices.
+
+  **Security & compliance**: Monitoring Kubernetes API activity is critical for security and may be required for certain certifications. Audit logs are enabled by default for clusters with dedicated control planes. Learn more in the [audit logs documentation](/kubernetes/how-to/access-audit-logs/).
+</Message>

pages/kubernetes/how-to/access-audit-logs.mdx

@@ -13,9 +13,7 @@ categories:
   - kubernetes
 ---
 
-Kubernetes Kapsule and Kosmos control plane metrics and logs are integrated into Cockpit, providing you with a centralized hub for monitoring the control plane, nodes, managed resources, and cluster system applications.
-
-While this initial integration empowers you with the autonomy to troubleshoot issues promptly, we have taken the next step by extending the functionality, now Kubernetes audit records are also exported into Cockpit.
+<Macro id="kubernetes-cockpit-intro" />
 
 Kubernetes audit logs provide detailed insights into user-generated activities, actions initiated by applications using the Kubernetes API, and operations performed by the control plane.
 
@@ -102,3 +100,16 @@ The Kubernetes audit policy defines the selection of log entries exported by the
 You can examine the [Kubernetes audit policy](https://github.com/scaleway/kubernetes-gists/blob/main/audit/policy.yaml) file, which contains a list of rules, giving you complete visibility into our API server configuration and the chosen request treatments or exclusions.
 
 
+## Related documentation
+<Grid>
+  <DefaultCard
+    title="How to monitor your Kubernetes Kapsule cluster with Cockpit"
+    description="You can view the cluster metrics in a hosted Grafana without any configuration on your part."
+    url="/kubernetes/how-to/monitor-cluster/"
+    label="Learn more" />
+  <DefaultCard
+  title="How to monitor your Kubernetes Kapsule cluster with Cockpit using Promtail"
+  description="Learn how to install and configure Promtail to monitor your Kubernetes applications in Cockpit."
+  url="/kubernetes/how-to/monitor-data-plane-with-cockpit/"
+  label="Learn more" />
+</Grid>

pages/kubernetes/how-to/monitor-cluster.mdx

@@ -13,20 +13,13 @@ categories:
   - kubernetes
 ---
 
-Scaleway's observability Cockpit provides automated monitoring of your Kubernetes cluster. As Kubernetes environments grow in complexity, monitoring becomes crucial for optimal performance. Visualization of the clusters' metrics is available in a hosted Grafana.
 
-Grafana's rich visualizations and ease of use make it an ideal choice. Cockpit offers a hassle-free solution, providing real-time insights without extra infrastructure.
-
-[Cockpit](/cockpit/quickstart/) empowers you to monitor the clusters' control plane, nodes, managed resources and the cluster system applications.
-
-* Detect incidents and diagnose failures in the earliest stages
-* Get new insights on control plane and worker nodes usage such as CPU and memory to optimize your resource allocation
-* Achieve a better understanding of your infrastructure by analyzing data on your API server, system applications and up/down scaling behavior
+<Macro id="kubernetes-cockpit-intro" />
 
 <Message type="important">
   **Control plane monitoring**: Scaleway Kapsule natively provides monitoring for the control plane, free of charge. Additionally, monitoring of the data plane is possible. To monitor the data plane, refer to [How to monitor your Kubernetes Kapsule data plane with Cockpit](/kubernetes/how-to/monitor-data-plane-with-cockpit/). For detailed observability, refer to the [documentation on how to send logs from your Kubernetes cluster to your Cockpit](/cockpit/how-to/send-logs-from-k8s-to-cockpit/).
 
-  **Control plane vs. data plane**: The control plane is responsible for managing the Kubernetes cluster’s state and orchestrating workloads, while the data plane consists of the nodes that execute the workloads.
+  **Control plane vs. data plane**: The control plane is responsible for managing the Kubernetes cluster’s state and orchestrating workloads, while the data plane (your Kubernetes application) consists of the nodes that execute the workloads.
 
   **Security and compliance**: For enhanced security and compliance, Kapsule provides audit logs natively within Cockpit. Learn more in the [audit logs documentation](/kubernetes/how-to/access-audit-logs/).
 </Message>
@@ -78,3 +71,16 @@ For scenarios where you require consistent and predictable performance, along wi
     </Message>
 
 
+## Related documentation
+<Grid>
+  <DefaultCard
+    title="How to access the Kubernetes audit logs"
+    description="Learn how you can visualize the audit logs of your Kubernetes Cluster in Grafana using Scaleway's Cockpit."
+    url="/kubernetes/how-to/access-audit-logs/"
+    label="Learn more" />
+  <DefaultCard
+  title="How to monitor your Kubernetes Kapsule cluster with Cockpit using Promtail"
+  description="Learn how to install and configure Promtail to monitor your Kubernetes applications in Cockpit."
+  url="/kubernetes/how-to/monitor-data-plane-with-cockpit/"
+  label="Learn more" />
+</Grid>

pages/kubernetes/how-to/monitor-data-plane-with-cockpit.mdx

@@ -13,16 +13,7 @@ dates:
   posted: 2025-01-17
 ---
 
-You can now send **data plane** logs from your [Kapsule](https://www.scaleway.com/en/kubernetes-kapsule/) or [Kosmos](https://www.scaleway.com/en/kubernetes-kosmos/) clusters to [Cockpit](https://www.scaleway.com/en/cockpit/), providing centralized, real-time access to application and system logs. Reduce complexity and manual work thanks to this integration, powered by a **Promtail** deployment via [Easy Deploy](/kubernetes/how-to/enable-easy-deploy/).
-
-This feature allows you to:
-
-- **Enhance observability**: View logs from all your Kubernetes containers in one place.
-- **Simplify troubleshooting**: Quickly drill down into specific pods or containers without needing to configure a separate logging stack.
-
-<Message type="important">
-    This feature does incur costs based on the volume of logs ingested. Refer to [Cockpit FAQ](/faq/cockpit/#how-am-i-billed-for-using-cockpit-with-custom-data) for more details and best practices to avoid unexpected bills.
-</Message>
+<Macro id="kubernetes-cockpit-intro" />
 
 <Macro id="requirements" />
 
@@ -178,3 +169,17 @@ Key points include:
 - [Send metrics from your Kubernetes cluster to your Cockpit (How-To)](/cockpit/how-to/send-metrics-from-k8s-to-cockpit/)
 - [Promtail Documentation](https://grafana.com/docs/loki/latest/clients/promtail/)
 - [Scaleway Kubernetes Kapsule and Kosmos Documentation](/kubernetes/quickstart/)
+
+## Related documentation
+<Grid>
+  <DefaultCard
+    title="How to access the Kubernetes audit logs"
+    description="Learn how you can visualize the audit logs of your Kubernetes Cluster in Grafana using Scaleway's Cockpit."
+    url="/kubernetes/how-to/access-audit-logs/"
+    label="Learn more" />
+  <DefaultCard
+    title="How to monitor your Kubernetes Kapsule cluster with Cockpit"
+    description="You can view the cluster metrics in a hosted Grafana without any configuration on your part."
+    url="/kubernetes/how-to/monitor-cluster/"
+    label="Learn more" />
+</Grid>