Apply suggestions from code review

Co-authored-by: Jessica <[email protected]>
Co-authored-by: Rowena Jones <[email protected]>

Author: 3 people

observability/cockpit/how-to/send-log-from-k8s-to-cockpit.mdx

@@ -13,7 +13,7 @@ dates:
   posted: 2025/01/20
 ---
 
-In this page we will show you how to send application logs from your Kubernetes cluster to your Cockpit using either a Helm chart or deploying a Helm chart with [Terraform](https://www.terraform.io/).
+In this page, we will show you how to send application logs from your Kubernetes cluster to your Cockpit using either a Helm chart or deploying a Helm chart with [Terraform](https://www.terraform.io/).
 
 We will use the [k8s-monitoring](https://artifacthub.io/packages/helm/grafana/k8s-monitoring/1.6.16) Helm Chart, which installs an Alloy Daemon set to export your Kubernetes cluster's logs to your Cockpit.
 
@@ -23,7 +23,7 @@ We will use the [k8s-monitoring](https://artifacthub.io/packages/helm/grafana/k8
  - [Owner](/identity-and-access-management/iam/concepts/#owner) status or [IAM permissions](/identity-and-access-management/iam/concepts/#permission) allowing you to perform actions in the intended Organization
  - [Created](/observability/cockpit/how-to/create-external-data-sources/) a custom external data source of the [logs type](/observability/cockpit/concepts/#data-types)
  - [Created](/observability/cockpit/how-to/create-token/) a Cockpit token in the same region as the logs data source
- - A running Kubernetes cluster containing your application deployed
+ - A running Kubernetes cluster containing your deployed application
  - [Created](/identity-and-access-management/iam/how-to/create-api-keys/) an API key and retrieved your API secret key
 
 <Message type="important">
@@ -45,7 +45,7 @@ destinations:
     protocol: "http"
     logs: 
       enabled: true
-    url: "$COCKPIT_CUSTOM_LOGS_DATASOURCE_URL/loki/api/v1/push" ##You can find your logs URL in the **Data sources** tab of the Scaleway conseole under the "API URL" section of the relevant data source
+    url: "$COCKPIT_CUSTOM_LOGS_DATASOURCE_URL/loki/api/v1/push" ##You can find your logs URL in the **Data sources** tab of the Scaleway console under the "API URL" section of the relevant data source
     tenantId: "$COCKPIT_TOKEN"
 
     metrics: 
@@ -77,20 +77,20 @@ alloy-singleton:
 ```
 
 <Message type="note">
-The template above is for sending logs to your Cockpit. You can also configure it to send metrics to Cockpit using this Helm chart.
-Refer to our dedicated doucumentation to [send metrics from your cluster to Cockpit](/observability/cockpit/how-to/send-metrics-froms-k8s-to-cockpit).
+    The template above is for sending logs to your Cockpit. You can also configure it to send metrics to Cockpit using this Helm chart.
+    Refer to our dedicated documentation to [send metrics from your cluster to Cockpit](/observability/cockpit/how-to/send-metrics-froms-k8s-to-cockpit).
 </Message>
 
 ## Send Kubernetes logs using Helm chart
 
-Once you have configured your `values.yml` file, you can use Helm to deploy the log-forwarding configuration to your Kubernetes cluster. Before you can install the Helm chart, ensure that your `kubectl` tool is properly connected to your Kubernetes cluster. `kubectl` is the command-line tool for interacting with Kubernetes clusters.
+Once you have configured your `values.yml` file, you can use Helm to deploy the log-forwarding configuration to your Kubernetes cluster. Before installing the Helm chart, ensure that your `kubectl` tool is properly connected to your Kubernetes cluster. `kubectl` is the command-line tool for interacting with Kubernetes clusters.
 
 1. [Connect](/containers/kubernetes/how-to/connect-cluster-kubectl/) `kubectl` to your Kubernetes cluster
 2. Run the command below to install the `k8s-monitoring` Helm chart:
   ```
   helm install -f /your-path/to/values.yml name-of-your-choice-for-your-log-ingester k8s-monitoring --version 1.6.16
   ```
-    The `-f` flag specifies the path to your `values.yml` file, which contains the configuration for the Helm chart. Make sure that you replace `/your-path/to/values.yml` with the correct path where your `values.yml` file is stored. Make sure that you also replace `name-of-your-choice-for-your-log-ingester` with a clear name (ex. `alloy-logs-ingester`). In our configuration we are using `alloy-lm-ingester`.
+    The `-f` flag specifies the path to your `values.yml` file, which contains the configuration for the Helm chart. Make sure that you replace `/your-path/to/values.yml` with the correct path where your `values.yml` file is stored. Make sure that you also replace `name-of-your-choice-for-your-log-ingester` with a clear name (ex. `alloy-logs-ingester`). In our configuration, we are using `alloy-lm-ingester`.
 
     Helm installs the `k8s-monitoring` chart, which includes the Alloy DaemonSet configured to collect logs from your Kubernetes cluster.
     The DaemonSet ensures that a pod is running on each node in your cluster, which collects logs and forwards them to the specified Loki endpoint in your Cockpit.
@@ -133,11 +133,11 @@ You can also use Terraform to manage and deploy Helm charts, providing you with
 3. Save your changes.
 4. Run `terraform init` to initialize your Terraform configuration and download any necessary providers.
 5. Run `terraform apply` to apply your configuration.
-5. Type `yes` when prompted to confirm the actions.
+6. Type `yes` when prompted to confirm the actions.
 
 ## Explore your logs in Cockpit
 
-1. Click **Cockpit** in the Observability section of the Scaleway [console](https://console.scaleway.com/) side menu. The **Cockpit** overview page displays.
+1. Click **Cockpit** in the Observability section of the Scaleway [console](https://console.scaleway.com/) side menu. The **Cockpit Overview** page displays.
 2. Click **Open dashboards** to open your managed dashboards in Grafana. You are redirected to the Grafana website.
 3. Log in to Grafana using your [Grafana credentials](/observability/cockpit/how-to/retrieve-grafana-credentials/).
 4. Click the **Home** icon, then click **Explore**.

observability/cockpit/how-to/send-metrics-from-k8s-to-cockpit.mdx

@@ -14,7 +14,7 @@ dates:
 ---
 
 
-In this page we will show you how to send application metrics from your Kubernetes cluster to your Cockpit using either a Helm chart or deploying a Helm chart with [Terraform](https://www.terraform.io/).
+In this page we will show you how to send application metrics from your Kubernetes cluster to your Cockpit, either by using a Helm chart or deploying a Helm chart with [Terraform](https://www.terraform.io/).
 
 We will use the [k8s-monitoring](https://artifacthub.io/packages/helm/grafana/k8s-monitoring/1.6.16) Helm Chart, which installs an Alloy Daemon set to export your Kubernetes cluster's metrics to your Cockpit.
 
@@ -24,7 +24,7 @@ We will use the [k8s-monitoring](https://artifacthub.io/packages/helm/grafana/k8
  - [Owner](/identity-and-access-management/iam/concepts/#owner) status or [IAM permissions](/identity-and-access-management/iam/concepts/#permission) allowing you to perform actions in the intended Organization
  - [Created](/observability/cockpit/how-to/create-external-data-sources/) a custom external data source of the [metrics type](/observability/cockpit/concepts/#data-types)
  - [Created](/observability/cockpit/how-to/create-token/) a Cockpit token in the same region as the metrics data source
- - A running Kubernetes cluster containing your application deployed
+ - A running Kubernetes cluster containing your deployed application
  - [Created](/identity-and-access-management/iam/how-to/create-api-keys/) an API key and retrieved your API secret key
 
 <Message type="important">
@@ -66,13 +66,13 @@ alloy-singleton:
 ```
 
 <Message type="note">
-The template above is for sending metrics to your Cockpit. You can also configure it to send logs to Cockpit using this Helm chart.
-Refer to our dedicated doucumentation to [send logs from your cluster to Cockpit](/observability/cockpit/how-to/send-logs-from-k8s-to-cockpit)
+    The template above is for sending metrics to your Cockpit. You can also configure it to send logs to Cockpit using this Helm chart.
+    Refer to our dedicated documentation to [send logs from your cluster to Cockpit](/observability/cockpit/how-to/send-logs-from-k8s-to-cockpit)
 </Message>
 
 ## Add annotations for auto-discovery
 
-Annotations in Kubernetes provide a way to attach metadata to your resources. For `k8s-monitoring`, these annotations signal which pods should be scraped for metrics, and what port to use. For the sake of this documentation, we are adding annotations to specify we want `k8s-monitoring` to scrape the pods from your deployment. Make sure that you replace `$METRICS_PORT` with the port where your application exposes Prometheus metrics.
+Annotations in Kubernetes provide a way to attach metadata to your resources. For `k8s-monitoring`, these annotations signal which pods should be scraped for metrics, and what port to use. For the sake of this documentation, we are adding annotations to specify we want `k8s-monitoring` to scrape the pods from our deployment. Make sure that you replace `$METRICS_PORT` with the port where your application exposes Prometheus metrics.
 
 ### Kubernetes deployment template
 
@@ -139,18 +139,18 @@ resource "kubernetes_deployment_v1" "your_application_deployment" {
 3. Save your changes.
 4. Run `terraform init` to initialize your Terraform configuration and download any necessary providers.
 5. Run `terraform apply` to apply your configuration.
-5. Type `yes` when prompted to confirm the actions.
+6. Type `yes` when prompted to confirm the actions.
 
 ## Send Kubernetes metrics using Helm chart
 
-Once you have configured your `values.yml` file, you can use Helm to deploy the metric-forwarding configuration to your Kubernetes cluster. Before you can install the Helm chart, ensure that your `kubectl` tool is properly connected to your Kubernetes cluster. `kubectl` is the command-line tool for interacting with Kubernetes clusters.
+Once you have configured your `values.yml` file, you can use Helm to deploy the metric-forwarding configuration to your Kubernetes cluster. Before installing the Helm chart, ensure that your `kubectl` tool is properly connected to your Kubernetes cluster. `kubectl` is the command-line tool for interacting with Kubernetes clusters.
 
 1. [Connect](/containers/kubernetes/how-to/connect-cluster-kubectl/) `kubectl` to your Kubernetes cluster
 2. Run the command below to install the `k8s-monitoring` Helm chart:
   ```
   helm install -f /your-path/to/values.yml name-of-your-choice-for-your-metric-ingester k8s-monitoring --version 1.6.16
   ```
-    The `-f` flag specifies the path to your `values.yml` file, which contains the configuration for the Helm chart. Make sure that you replace `/your-path/to/values.yml` with the correct path where your `values.yml` file is stored. Make sure that you also replace `name-of-your-choice-for-your-metric-ingester` with a clear name (ex. `alloy-metrics-ingester`). In our configuration we are using `alloy-lm-ingester`.
+    The `-f` flag specifies the path to your `values.yml` file, which contains the configuration for the Helm chart. Make sure that you replace `/your-path/to/values.yml` with the correct path where your `values.yml` file is stored. Make sure that you also replace `name-of-your-choice-for-your-metric-ingester` with a clear name (ex. `alloy-metrics-ingester`). In our configuration, we are using `alloy-lm-ingester`.
         
         Helm installs the `k8s-monitoring` chart, which includes the Alloy DaemonSet configured to collect metrics from your Kubernetes cluster.
         The DaemonSet ensures that a pod is running on each node in your cluster, which collects metrics and forwards them to the specified Prometheus endpoint in your Cockpit.
@@ -166,7 +166,7 @@ Once you have configured your `values.yml` file, you can use Helm to deploy the
 
 Now that your metrics are exported to your Cockpit, you can access and query them.
 
-1. Click **Cockpit** in the Observability section of the Scaleway [console](https://console.scaleway.com/) side menu. The **Cockpit** overview page displays.
+1. Click **Cockpit** in the Observability section of the Scaleway [console](https://console.scaleway.com/) side menu. The **Cockpit Overview** page displays.
 2. Click **Open dashboards** to open your managed dashboards in Grafana. You are redirected to the Grafana website.
 3. Log in to Grafana using your [Grafana credentials](/observability/cockpit/how-to/retrieve-grafana-credentials/).
 4. Click the **Home** icon, then click **Explore**.