Grafana Alloy (Platform) Installation

Grafana Alloy (Platform) is a Metrics/Logs Gathering from Kubernetes Cluster and its Workloads

---

Grafana Alloy (Platform) will be installed on 🟢 Management 🟦 Non-Production Workload 🟥 Production Workload

Pre-Installation

Grafana Alloy (Platform) Preparation

1. Set Common Configuration across Kubernetes Clusters

   Set Feeding Endpoints for Metrics/Logs

   Ensure GRAFANA_MIMIR_DOMAIN, GRAFANA_LOKI_DOMAIN are defined as per the Shell Variables guide.

   export ALLOY_COLLECT_TENANT_ID="opstella-platform"  ## Tenant ID when pushing metrics/logs

2. Create Helm Values Configuration, create for 🟢 Management Kubernetes Cluster

   export CLUSTER_NAME="management"

   export GRAFANA_ALLOY_CLUSTER_NAME="k8s-cluster-${CLUSTER_NAME}"

   cat <<EOF > $HOME/opstella-installation/helm-values/grafana-alloy-platform-management-full-values.yaml
   cluster:
     # -- The name for this cluster.
     # @section -- Cluster
     name: "${GRAFANA_ALLOY_CLUSTER_NAME}"
     ## CHART_NOTE: Given from v1 to v2 Migration Tool
     ##  - kubernetesAPIService is not used in the new chart.
   
   ######################################################################################################################
   
   #
   # Destinations
   #
   
   # -- The list of destinations where telemetry data will be sent.
   # See the [destinations documentation](https://github.com/grafana/k8s-monitoring-helm/blob/main/charts/k8s-monitoring/docs/destinations/README.md) for more information.
   # @section -- Destinations
   destinations:
     ## OPSTELLA_CUSTOMIZE: Destination to Mimir and Loki
     - name: metricsService
       type: prometheus
       url: https://${GRAFANA_MIMIR_DOMAIN}/api/v1/push
       tenantId: "${ALLOY_COLLECT_TENANT_ID}"
     - name: logsService
       type: loki
       url: https://${GRAFANA_LOKI_DOMAIN}/loki/api/v1/push
       tenantId: "${ALLOY_COLLECT_TENANT_ID}"
   
   ######################################################################################################################
   
   #
   # Features
   #
   
   #########------------------------------------------------------------------------------------------###################
   ## Metrics
   
   # -- Cluster Monitoring enables observability and monitoring for your Kubernetes Cluster itself.
   # Requires a destination that supports metrics.
   # To see the valid options, please see the [Cluster Monitoring feature documentation](https://github.com/grafana/k8s-monitoring-helm/tree/main/charts/k8s-monitoring/charts/feature-cluster-metrics).
   # @default -- Disabled
   # @section -- Features - Cluster Metrics
   clusterMetrics:
     ## OPSTELLA_CUSTOMIZE: Enable Kubernetes Cluster Metrics
     enabled: true
     ### Scraping Metrics Series ###
     kubelet:
       metricsTuning:
         useDefaultAllowList: true
         includeMetrics:
           - kubelet_volume_stats_available_bytes
           - kubelet_volume_stats_capacity_bytes
     cadvisor:
       metricsTuning:
         useDefaultAllowList: true
         includeMetrics:
           - container_spec_memory_reservation_limit_bytes
           - container_cpu_usage_seconds_total
           - container_cpu_cfs_throttled_periods_total
           - container_cpu_cfs_periods_total
           - container_memory_usage_bytes
     apiServer:
       metricsTuning:
         useDefaultAllowList: true
     kube-state-metrics:
       deploy: false ## HELM: Sub-Chart Condition // Prometheus Kube-State-Metrics // Explicitly Deploy
       enabled: false
       metricsTuning:
         useDefaultAllowList: true
         includeMetrics:
           - kube_deployment_created
           - kube_pod_status_ready
           - kube_pod_container_status_terminated
           - kube_pod_container_status_waiting
           - kube_pod_container_resource_requests_cpu_cores
           - kube_pod_container_resource_requests_memory_bytes
           - kube_persistentvolumeclaim_info
           - kube_persistentvolume_status_phase
           - kube_pod_container_status_restarts_total
           - kube_pod_container_status_ready
           - kube_pod_info
           - kube_persistentvolumeclaim_access_mode
           - kube_persistentvolumeclaim_status_phase
     node-exporter:
       deploy: true ## HELM: Sub-Chart Condition // Prometheus Node-Exporter // Explicitly Deploy
       enabled: true
       ### --- ###
       nameOverride: "prometheus-node-exporter"  ## OPSTELLA_CUSTOMIZE: Distinguish that is NOT under Grafana
       fullnameOverride: "prometheus-node-exporter" ## OPSTELLA_CUSTOMIZE: Distinguish that is NOT under Grafana
       metricsTuning:
         useDefaultAllowList: true
     windows-exporter:
       deploy: false ## HELM/OPSTELLA_CUSTOMIZE: Sub-Chart Condition // Prometheus Windows-Exporter // Opstella doesn't (yet) support Windows Containers
   
   ## CHART_NOTE: Given from v1 to v2 Migration Tool
   ##
   # -- Annotation Autodiscovery enables gathering metrics from Kubernetes Pods and Services discovered by special annotations.
   # Requires a destination that supports metrics.
   # To see the valid options, please see the [Annotation Autodiscovery feature documentation](https://github.com/grafana/k8s-monitoring-helm/tree/main/charts/k8s-monitoring/charts/feature-annotation-autodiscovery).
   # @default -- Disabled
   # @section -- Features - Annotation Autodiscovery
   annotationAutodiscovery:
     enabled: true
   
   ## CHART_NOTE: Given from v1 to v2 Migration Tool
   ##
   # -- Prometheus Operator Objects enables the gathering of metrics from objects like Probes, PodMonitors, and
   # ServiceMonitors. Requires a destination that supports metrics.
   # To see the valid options, please see the [Prometheus Operator Objects feature documentation](https://github.com/grafana/k8s-monitoring-helm/tree/main/charts/k8s-monitoring/charts/feature-prometheus-operator-objects).
   # @default -- Disabled
   # @section -- Features - Prometheus Operator Objects
   prometheusOperatorObjects:
     enabled: true
     crds:
       deploy: true
   
   ## CHART_NOTE: Given from v1 to v2 Migration Tool
   ##
   #
   # Collectors (Alloy instances)
   #
   
   # An Alloy instance for collecting metrics.
   # To see additional valid options, please see the [Alloy Helm chart documentation](https://github.com/grafana/alloy/tree/main/operations/helm/charts/alloy).
   alloy-metrics:
     enabled: true
   
   ## CHART_NOTE: Given from v1 to v2 Migration Tool
   ##
   # -- Service Integrations enables gathering telemetry data for common services and applications deployed to Kubernetes.
   # To see the valid options, please see the [Service Integrations documentation](https://github.com/grafana/k8s-monitoring-helm/tree/main/charts/k8s-monitoring/charts/feature-integrations).
   # @default -- No integrations enabled
   # @section -- Features - Service Integrations
   integrations:
     alloy:
       instances:
         - name: alloy
           labelSelectors:
             app.kubernetes.io/name:
               - alloy-metrics
           metrics:
             tuning:
               useDefaultAllowList: false
               includeMetrics:
                 - alloy_build_info
   
   #########------------------------------------------------------------------------------------------###################
   ## OPSTELLA_ASSUME Logs (Small Scale) - Kubernetes Cluster Events, etc.
   ## That's why using Alloy as single instance deployment (alloy-singleton)
   
   ## CHART_NOTE: Given from v1 to v2 Migration Tool
   ##
   # -- Cluster events.
   # Requires a destination that supports logs.
   # To see the valid options, please see the [Cluster Events feature documentation](https://github.com/grafana/k8s-monitoring-helm/tree/main/charts/k8s-monitoring/charts/feature-cluster-events).
   # @default -- Disabled
   # @section -- Features - Cluster Events
   clusterEvents:
     enabled: true
   
   #
   # Collectors (Alloy instances)
   #
   ## CHART_NOTE: Given from v1 to v2 Migration Tool
   ##
   # An Alloy instance for data sources required to be deployed on a single replica.
   # To see additional valid options, please see the [Alloy Helm chart documentation](https://github.com/grafana/alloy/tree/main/operations/helm/charts/alloy).
   alloy-singleton:
     enabled: true
   
   #########------------------------------------------------------------------------------------------###################
   ## OPSTELLA_ASSUME Logs (Large Scale) - Pod Logs, etc.
   
   ## CHART_NOTE: Given from v1 to v2 Migration Tool
   ##
   # -- Pod logs.
   # Requires a destination that supports logs.
   # To see the valid options, please see the [Pod Logs feature documentation](https://github.com/grafana/k8s-monitoring-helm/tree/main/charts/k8s-monitoring/charts/feature-pod-logs).
   # @default -- Disabled
   # @section -- Features - Pod Logs
   podLogs:
     enabled: true
   
   #
   # Collectors (Alloy instances)
   #
   ## CHART_NOTE: Given from v1 to v2 Migration Tool
   ##
   # An Alloy instance for collecting log data.
   # To see additional valid options, please see the [Alloy Helm chart documentation](https://github.com/grafana/alloy/tree/main/operations/helm/charts/alloy).
   alloy-logs:
     enabled: true
   
   ######################################################################################################################
   
   EOF

3. Create Helm Values Configuration, create for 🟦 Non-Production Workload Kubernetes Cluster

   export CLUSTER_NAME="nonprod"

   export GRAFANA_ALLOY_CLUSTER_NAME="k8s-cluster-${CLUSTER_NAME}"

   cat <<EOF > $HOME/opstella-installation/helm-values/grafana-alloy-platform-nonprod-full-values.yaml
   cluster:
     # -- The name for this cluster.
     # @section -- Cluster
     name: "${GRAFANA_ALLOY_CLUSTER_NAME}"
     ## CHART_NOTE: Given from v1 to v2 Migration Tool
     ##  - kubernetesAPIService is not used in the new chart.
   
   ######################################################################################################################
   
   #
   # Destinations
   #
   
   # -- The list of destinations where telemetry data will be sent.
   # See the [destinations documentation](https://github.com/grafana/k8s-monitoring-helm/blob/main/charts/k8s-monitoring/docs/destinations/README.md) for more information.
   # @section -- Destinations
   destinations:
     ## OPSTELLA_CUSTOMIZE: Destination to Mimir and Loki
     - name: metricsService
       type: prometheus
       url: https://${GRAFANA_MIMIR_DOMAIN}/api/v1/push
       tenantId: "${ALLOY_COLLECT_TENANT_ID}"
     - name: logsService
       type: loki
       url: https://${GRAFANA_LOKI_DOMAIN}/loki/api/v1/push
       tenantId: "${ALLOY_COLLECT_TENANT_ID}"
   
   ######################################################################################################################
   
   #
   # Features
   #
   
   #########------------------------------------------------------------------------------------------###################
   ## Metrics
   
   # -- Cluster Monitoring enables observability and monitoring for your Kubernetes Cluster itself.
   # Requires a destination that supports metrics.
   # To see the valid options, please see the [Cluster Monitoring feature documentation](https://github.com/grafana/k8s-monitoring-helm/tree/main/charts/k8s-monitoring/charts/feature-cluster-metrics).
   # @default -- Disabled
   # @section -- Features - Cluster Metrics
   clusterMetrics:
     ## OPSTELLA_CUSTOMIZE: Enable Kubernetes Cluster Metrics
     enabled: true
     ### Scraping Metrics Series ###
     kubelet:
       metricsTuning:
         useDefaultAllowList: true
         includeMetrics:
           - kubelet_volume_stats_available_bytes
           - kubelet_volume_stats_capacity_bytes
     cadvisor:
       metricsTuning:
         useDefaultAllowList: true
         includeMetrics:
           - container_spec_memory_reservation_limit_bytes
           - container_cpu_usage_seconds_total
           - container_cpu_cfs_throttled_periods_total
           - container_cpu_cfs_periods_total
           - container_memory_usage_bytes
     apiServer:
       metricsTuning:
         useDefaultAllowList: true
     kube-state-metrics:
       deploy: false ## HELM: Sub-Chart Condition // Prometheus Kube-State-Metrics // Explicitly Deploy
       enabled: false
       metricsTuning:
         useDefaultAllowList: true
         includeMetrics:
           - kube_deployment_created
           - kube_pod_status_ready
           - kube_pod_container_status_terminated
           - kube_pod_container_status_waiting
           - kube_pod_container_resource_requests_cpu_cores
           - kube_pod_container_resource_requests_memory_bytes
           - kube_persistentvolumeclaim_info
           - kube_persistentvolume_status_phase
           - kube_pod_container_status_restarts_total
           - kube_pod_container_status_ready
           - kube_pod_info
           - kube_persistentvolumeclaim_access_mode
           - kube_persistentvolumeclaim_status_phase
     node-exporter:
       deploy: true ## HELM: Sub-Chart Condition // Prometheus Node-Exporter // Explicitly Deploy
       enabled: true
       ### --- ###
       nameOverride: "prometheus-node-exporter"  ## OPSTELLA_CUSTOMIZE: Distinguish that is NOT under Grafana
       fullnameOverride: "prometheus-node-exporter" ## OPSTELLA_CUSTOMIZE: Distinguish that is NOT under Grafana
       metricsTuning:
         useDefaultAllowList: true
     windows-exporter:
       deploy: false ## HELM/OPSTELLA_CUSTOMIZE: Sub-Chart Condition // Prometheus Windows-Exporter // Opstella doesn't (yet) support Windows Containers
   
   ## CHART_NOTE: Given from v1 to v2 Migration Tool
   ##
   # -- Annotation Autodiscovery enables gathering metrics from Kubernetes Pods and Services discovered by special annotations.
   # Requires a destination that supports metrics.
   # To see the valid options, please see the [Annotation Autodiscovery feature documentation](https://github.com/grafana/k8s-monitoring-helm/tree/main/charts/k8s-monitoring/charts/feature-annotation-autodiscovery).
   # @default -- Disabled
   # @section -- Features - Annotation Autodiscovery
   annotationAutodiscovery:
     enabled: true
   
   ## CHART_NOTE: Given from v1 to v2 Migration Tool
   ##
   # -- Prometheus Operator Objects enables the gathering of metrics from objects like Probes, PodMonitors, and
   # ServiceMonitors. Requires a destination that supports metrics.
   # To see the valid options, please see the [Prometheus Operator Objects feature documentation](https://github.com/grafana/k8s-monitoring-helm/tree/main/charts/k8s-monitoring/charts/feature-prometheus-operator-objects).
   # @default -- Disabled
   # @section -- Features - Prometheus Operator Objects
   prometheusOperatorObjects:
     enabled: true
     crds:
       deploy: true
   
   ## CHART_NOTE: Given from v1 to v2 Migration Tool
   ##
   #
   # Collectors (Alloy instances)
   #
   
   # An Alloy instance for collecting metrics.
   # To see additional valid options, please see the [Alloy Helm chart documentation](https://github.com/grafana/alloy/tree/main/operations/helm/charts/alloy).
   alloy-metrics:
     enabled: true
   
   ## CHART_NOTE: Given from v1 to v2 Migration Tool
   ##
   # -- Service Integrations enables gathering telemetry data for common services and applications deployed to Kubernetes.
   # To see the valid options, please see the [Service Integrations documentation](https://github.com/grafana/k8s-monitoring-helm/tree/main/charts/k8s-monitoring/charts/feature-integrations).
   # @default -- No integrations enabled
   # @section -- Features - Service Integrations
   integrations:
     alloy:
       instances:
         - name: alloy
           labelSelectors:
             app.kubernetes.io/name:
               - alloy-metrics
           metrics:
             tuning:
               useDefaultAllowList: false
               includeMetrics:
                 - alloy_build_info
   
   #########------------------------------------------------------------------------------------------###################
   ## OPSTELLA_ASSUME Logs (Small Scale) - Kubernetes Cluster Events, etc.
   ## That's why using Alloy as single instance deployment (alloy-singleton)
   
   ## CHART_NOTE: Given from v1 to v2 Migration Tool
   ##
   # -- Cluster events.
   # Requires a destination that supports logs.
   # To see the valid options, please see the [Cluster Events feature documentation](https://github.com/grafana/k8s-monitoring-helm/tree/main/charts/k8s-monitoring/charts/feature-cluster-events).
   # @default -- Disabled
   # @section -- Features - Cluster Events
   clusterEvents:
     enabled: true
   
   #
   # Collectors (Alloy instances)
   #
   ## CHART_NOTE: Given from v1 to v2 Migration Tool
   ##
   # An Alloy instance for data sources required to be deployed on a single replica.
   # To see additional valid options, please see the [Alloy Helm chart documentation](https://github.com/grafana/alloy/tree/main/operations/helm/charts/alloy).
   alloy-singleton:
     enabled: true
   
   #########------------------------------------------------------------------------------------------###################
   ## OPSTELLA_ASSUME Logs (Large Scale) - Pod Logs, etc.
   
   ## CHART_NOTE: Given from v1 to v2 Migration Tool
   ##
   # -- Pod logs.
   # Requires a destination that supports logs.
   # To see the valid options, please see the [Pod Logs feature documentation](https://github.com/grafana/k8s-monitoring-helm/tree/main/charts/k8s-monitoring/charts/feature-pod-logs).
   # @default -- Disabled
   # @section -- Features - Pod Logs
   podLogs:
     enabled: true
   
   #
   # Collectors (Alloy instances)
   #
   ## CHART_NOTE: Given from v1 to v2 Migration Tool
   ##
   # An Alloy instance for collecting log data.
   # To see additional valid options, please see the [Alloy Helm chart documentation](https://github.com/grafana/alloy/tree/main/operations/helm/charts/alloy).
   alloy-logs:
     enabled: true
   
   ######################################################################################################################
   
   EOF

4. Create Helm Values Configuration, create for 🟥 Production Workload Kubernetes Cluster

   export CLUSTER_NAME="prod"

   export GRAFANA_ALLOY_CLUSTER_NAME="k8s-cluster-${CLUSTER_NAME}"

   cat <<EOF > $HOME/opstella-installation/helm-values/grafana-alloy-platform-prod-full-values.yaml
   cluster:
     # -- The name for this cluster.
     # @section -- Cluster
     name: "${GRAFANA_ALLOY_CLUSTER_NAME}"
     ## CHART_NOTE: Given from v1 to v2 Migration Tool
     ##  - kubernetesAPIService is not used in the new chart.
   
   ######################################################################################################################
   
   #
   # Destinations
   #
   
   # -- The list of destinations where telemetry data will be sent.
   # See the [destinations documentation](https://github.com/grafana/k8s-monitoring-helm/blob/main/charts/k8s-monitoring/docs/destinations/README.md) for more information.
   # @section -- Destinations
   destinations:
     ## OPSTELLA_CUSTOMIZE: Destination to Mimir and Loki
     - name: metricsService
       type: prometheus
       url: https://${GRAFANA_MIMIR_DOMAIN}/api/v1/push
       tenantId: "${ALLOY_COLLECT_TENANT_ID}"
     - name: logsService
       type: loki
       url: https://${GRAFANA_LOKI_DOMAIN}/loki/api/v1/push
       tenantId: "${ALLOY_COLLECT_TENANT_ID}"
   
   ######################################################################################################################
   
   #
   # Features
   #
   
   #########------------------------------------------------------------------------------------------###################
   ## Metrics
   
   # -- Cluster Monitoring enables observability and monitoring for your Kubernetes Cluster itself.
   # Requires a destination that supports metrics.
   # To see the valid options, please see the [Cluster Monitoring feature documentation](https://github.com/grafana/k8s-monitoring-helm/tree/main/charts/k8s-monitoring/charts/feature-cluster-metrics).
   # @default -- Disabled
   # @section -- Features - Cluster Metrics
   clusterMetrics:
     ## OPSTELLA_CUSTOMIZE: Enable Kubernetes Cluster Metrics
     enabled: true
     ### Scraping Metrics Series ###
     kubelet:
       metricsTuning:
         useDefaultAllowList: true
         includeMetrics:
           - kubelet_volume_stats_available_bytes
           - kubelet_volume_stats_capacity_bytes
     cadvisor:
       metricsTuning:
         useDefaultAllowList: true
         includeMetrics:
           - container_spec_memory_reservation_limit_bytes
           - container_cpu_usage_seconds_total
           - container_cpu_cfs_throttled_periods_total
           - container_cpu_cfs_periods_total
           - container_memory_usage_bytes
     apiServer:
       metricsTuning:
         useDefaultAllowList: true
     kube-state-metrics:
       deploy: false ## HELM: Sub-Chart Condition // Prometheus Kube-State-Metrics // Explicitly Deploy
       enabled: false
       metricsTuning:
         useDefaultAllowList: true
         includeMetrics:
           - kube_deployment_created
           - kube_pod_status_ready
           - kube_pod_container_status_terminated
           - kube_pod_container_status_waiting
           - kube_pod_container_resource_requests_cpu_cores
           - kube_pod_container_resource_requests_memory_bytes
           - kube_persistentvolumeclaim_info
           - kube_persistentvolume_status_phase
           - kube_pod_container_status_restarts_total
           - kube_pod_container_status_ready
           - kube_pod_info
           - kube_persistentvolumeclaim_access_mode
           - kube_persistentvolumeclaim_status_phase
     node-exporter:
       deploy: true ## HELM: Sub-Chart Condition // Prometheus Node-Exporter // Explicitly Deploy
       enabled: true
       ### --- ###
       nameOverride: "prometheus-node-exporter"  ## OPSTELLA_CUSTOMIZE: Distinguish that is NOT under Grafana
       fullnameOverride: "prometheus-node-exporter" ## OPSTELLA_CUSTOMIZE: Distinguish that is NOT under Grafana
       metricsTuning:
         useDefaultAllowList: true
     windows-exporter:
       deploy: false ## HELM/OPSTELLA_CUSTOMIZE: Sub-Chart Condition // Prometheus Windows-Exporter // Opstella doesn't (yet) support Windows Containers
   
   ## CHART_NOTE: Given from v1 to v2 Migration Tool
   ##
   # -- Annotation Autodiscovery enables gathering metrics from Kubernetes Pods and Services discovered by special annotations.
   # Requires a destination that supports metrics.
   # To see the valid options, please see the [Annotation Autodiscovery feature documentation](https://github.com/grafana/k8s-monitoring-helm/tree/main/charts/k8s-monitoring/charts/feature-annotation-autodiscovery).
   # @default -- Disabled
   # @section -- Features - Annotation Autodiscovery
   annotationAutodiscovery:
     enabled: true
   
   ## CHART_NOTE: Given from v1 to v2 Migration Tool
   ##
   # -- Prometheus Operator Objects enables the gathering of metrics from objects like Probes, PodMonitors, and
   # ServiceMonitors. Requires a destination that supports metrics.
   # To see the valid options, please see the [Prometheus Operator Objects feature documentation](https://github.com/grafana/k8s-monitoring-helm/tree/main/charts/k8s-monitoring/charts/feature-prometheus-operator-objects).
   # @default -- Disabled
   # @section -- Features - Prometheus Operator Objects
   prometheusOperatorObjects:
     enabled: true
     crds:
       deploy: true
   
   ## CHART_NOTE: Given from v1 to v2 Migration Tool
   ##
   #
   # Collectors (Alloy instances)
   #
   
   # An Alloy instance for collecting metrics.
   # To see additional valid options, please see the [Alloy Helm chart documentation](https://github.com/grafana/alloy/tree/main/operations/helm/charts/alloy).
   alloy-metrics:
     enabled: true
   
   ## CHART_NOTE: Given from v1 to v2 Migration Tool
   ##
   # -- Service Integrations enables gathering telemetry data for common services and applications deployed to Kubernetes.
   # To see the valid options, please see the [Service Integrations documentation](https://github.com/grafana/k8s-monitoring-helm/tree/main/charts/k8s-monitoring/charts/feature-integrations).
   # @default -- No integrations enabled
   # @section -- Features - Service Integrations
   integrations:
     alloy:
       instances:
         - name: alloy
           labelSelectors:
             app.kubernetes.io/name:
               - alloy-metrics
           metrics:
             tuning:
               useDefaultAllowList: false
               includeMetrics:
                 - alloy_build_info
   
   #########------------------------------------------------------------------------------------------###################
   ## OPSTELLA_ASSUME Logs (Small Scale) - Kubernetes Cluster Events, etc.
   ## That's why using Alloy as single instance deployment (alloy-singleton)
   
   ## CHART_NOTE: Given from v1 to v2 Migration Tool
   ##
   # -- Cluster events.
   # Requires a destination that supports logs.
   # To see the valid options, please see the [Cluster Events feature documentation](https://github.com/grafana/k8s-monitoring-helm/tree/main/charts/k8s-monitoring/charts/feature-cluster-events).
   # @default -- Disabled
   # @section -- Features - Cluster Events
   clusterEvents:
     enabled: true
   
   #
   # Collectors (Alloy instances)
   #
   ## CHART_NOTE: Given from v1 to v2 Migration Tool
   ##
   # An Alloy instance for data sources required to be deployed on a single replica.
   # To see additional valid options, please see the [Alloy Helm chart documentation](https://github.com/grafana/alloy/tree/main/operations/helm/charts/alloy).
   alloy-singleton:
     enabled: true
   
   #########------------------------------------------------------------------------------------------###################
   ## OPSTELLA_ASSUME Logs (Large Scale) - Pod Logs, etc.
   
   ## CHART_NOTE: Given from v1 to v2 Migration Tool
   ##
   # -- Pod logs.
   # Requires a destination that supports logs.
   # To see the valid options, please see the [Pod Logs feature documentation](https://github.com/grafana/k8s-monitoring-helm/tree/main/charts/k8s-monitoring/charts/feature-pod-logs).
   # @default -- Disabled
   # @section -- Features - Pod Logs
   podLogs:
     enabled: true
   
   #
   # Collectors (Alloy instances)
   #
   ## CHART_NOTE: Given from v1 to v2 Migration Tool
   ##
   # An Alloy instance for collecting log data.
   # To see additional valid options, please see the [Alloy Helm chart documentation](https://github.com/grafana/alloy/tree/main/operations/helm/charts/alloy).
   alloy-logs:
     enabled: true
   
   ######################################################################################################################
   
   EOF

Helm Chart Preparation

1. Add Grafana Helm Repository

   helm repo add grafana https://grafana.github.io/helm-charts
   helm repo update

Installation

Caution

If you have been following Grafana Alloy (Platform) Preparation section, you’ve just created,

• grafana-alloy-platform-management-full-values.yaml
• grafana-alloy-platform-nonprod-full-values.yaml
• grafana-alloy-platform-prod-full-values.yaml

Which are FULL Helm Values that’s everything you need to install Grafana Alloy (Platform) for each of Kubernetes Cluster(s).

Load observability variables

source $HOME/opstella-installation/shell-values/tools/observability.vars.sh

🟢 Management Kubernetes Cluster

Prepare Shell Variables

Ensure you have defined and loaded your Global Shell Variables as described in Shell Variables.

1. Install Grafana Alloy (Platform) on 🟢 Management Kubernetes Cluster

   Ensure you have defined and loaded your Global Shell Variables as described in Shell Variables.

   source $HOME/opstella-installation/shell-values/kubernetes/management_cluster.vars.sh

   export KUBECONFIG="$HOME/opstella-installation/kubeconfigs/management_cluster.yaml"

2. Install Grafana Alloy (Platform) on 🟢 Management Kubernetes Cluster

   helm upgrade --install grafana-alloy-platform grafana/k8s-monitoring \
       --version 2.0.16 \
       --namespace observability-agents \
       -f $HOME/opstella-installation/helm-values/grafana-alloy-platform-management-full-values.yaml

🟦 Non-Production Kubernetes Cluster

1. Connect to 🟦 Non-Production Kubernetes Cluster ; i.e w/ Kubeconfig File

   Ensure you have defined and loaded your Global Shell Variables as described in Shell Variables.

   source $HOME/opstella-installation/shell-values/kubernetes/nonprod_cluster.vars.sh

   export KUBECONFIG="$HOME/opstella-installation/kubeconfigs/nonprod_cluster.yaml"

2. Install Grafana Alloy (Platform) on 🟦 Non-Production Kubernetes Cluster

   helm upgrade --install grafana-alloy-platform grafana/k8s-monitoring \
       --version 2.0.16 \
       --namespace observability-agents \
       -f $HOME/opstella-installation/helm-values/grafana-alloy-platform-nonprod-full-values.yaml

🟥 Production Kubernetes Cluster

1. Connect to 🟥 Production Kubernetes Cluster ; i.e w/ Kubeconfig File

   Ensure you have defined and loaded your Global Shell Variables as described in Shell Variables.

   source $HOME/opstella-installation/shell-values/kubernetes/prod_cluster.vars.sh

   export KUBECONFIG="$HOME/opstella-installation/kubeconfigs/prod_cluster.yaml"

2. Install Grafana Alloy (Platform) on 🟥 Production Kubernetes Cluster

   helm upgrade --install grafana-alloy-platform grafana/k8s-monitoring \
       --version 2.0.16 \
       --namespace observability-agents \
       -f $HOME/opstella-installation/helm-values/grafana-alloy-platform-prod-full-values.yaml

Post-Installation

Caution

instructions providing here are steps for ONE Kubernetes Cluster.

It is meant for you to repeat the steps for each of Kubernetes Cluster(s). Please change the Kubernetes Cluster accordingly.

Grafana Alloy (Platform) Testing

1. Get Pods Status

   kubectl get pods -n observability-agents

   💡 Grafana Alloy and all of sub-components should be Running

   NAME                                                    READY   STATUS    RESTARTS  AGE
   ... (deducted)
   grafana-alloy-platform-alloy-logs-XXXXXXX-YYYYY         1/1     Running   0         Xd
   grafana-alloy-platform-alloy-logs-XXXXXXX-YYYYY         1/1     Running   0         Xd
   grafana-alloy-platform-alloy-logs-XXXXXXX-YYYYY         1/1     Running   0         Xd
   grafana-alloy-platform-alloy-logs-XXXXXXX-YYYYY         1/1     Running   0         Xd
   grafana-alloy-platform-alloy-logs-XXXXXXX-YYYYY         1/1     Running   0         Xd
   grafana-alloy-platform-alloy-metrics-0                  1/1     Running   0         Xd
   grafana-alloy-platform-alloy-singleton-XXXXXXX-YYYYY    1/1     Running   0         Xd
   prometheus-node-exporter-YYYYY                          1/1     Running   0         Xd
   prometheus-node-exporter-YYYYY                          1/1     Running   0         Xd
   prometheus-node-exporter-YYYYY                          1/1     Running   0         Xd
   prometheus-node-exporter-YYYYY                          1/1     Running   0         Xd
   prometheus-node-exporter-YYYYY                          1/1     Running   0         Xd