Skip to content

feat(k8s): add macro & cards #4623

New issue

Have a question about this project? # for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “#”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? # to your account

Draft
wants to merge 2 commits into
base: main
Choose a base branch
from
Draft
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
19 changes: 19 additions & 0 deletions macros/kubernetes/kubernetes-cockpit-intro.mdx
Original file line number Diff line number Diff line change
@@ -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 # 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>
13 changes: 13 additions & 0 deletions pages/kubernetes/how-to/access-audit-logs.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -102,3 +102,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>
14 changes: 14 additions & 0 deletions pages/kubernetes/how-to/monitor-cluster.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,7 @@ 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.
Expand Down Expand Up @@ -78,3 +79,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>
14 changes: 14 additions & 0 deletions pages/kubernetes/how-to/monitor-data-plane-with-cockpit.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -178,3 +178,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>