Merge branch 'suse-observability' into suse-observability-staging

Author: dmbarrasuse

.gitbook/assets/otel/open-telemetry-kubernetes-operator.png

@@ -96,7 +96,8 @@
 * [Overview](setup/otel/overview.md)
 * [Getting started](setup/otel/getting-started/README.md)
   * [Concepts](setup/otel/concepts.md)
-  * [Rancher & Kubernetes](setup/otel/getting-started/getting-started-k8s.md)
+  * [Kubernetes](setup/otel/getting-started/getting-started-k8s.md)
+  * [Kubernetes Operator](setup/otel/getting-started/getting-started-k8s-operator.md)
   * [Linux](setup/otel/getting-started/getting-started-linux.md)
   * [AWS Lambda](setup/otel/getting-started/getting-started-lambda.md)
 * [Open telemetry collector](setup/otel/collector.md)
@@ -119,6 +120,7 @@
   * [Kubernetes / OpenShift](setup/install-stackstate/kubernetes_openshift/README.md)
     * [Kubernetes install](setup/install-stackstate/kubernetes_openshift/kubernetes_install.md)
     * [OpenShift install](setup/install-stackstate/kubernetes_openshift/openshift_install.md)
+    * [Alibaba Cloud ACK install](setup/install-stackstate/kubernetes_openshift/ack.md)
     * [Required Permissions](setup/install-stackstate/kubernetes_openshift/required_permissions.md)  
     * [Override default configuration](setup/install-stackstate/kubernetes_openshift/customize_config.md)
     * [Configure storage](setup/install-stackstate/kubernetes_openshift/storage.md)
@@ -131,6 +133,8 @@
   * [Slack notifications](setup/configure-stackstate/slack-notifications.md)
   * [E-mail notifications](setup/configure-stackstate/email-notifications.md)
   * [Stackpacks](stackpacks/about-stackpacks.md)
+  * [Advanced](advanced/index.md)
+    * [Analytics](advanced/analytics.md)
 * [Release Notes](setup/release-notes/README.md)
   * [v2.0.0 - 11/Sep/2024](setup/release-notes/v2.0.0.md)
   * [v2.0.1 - 18/Sep/2024](setup/release-notes/v2.0.1.md)
@@ -140,6 +144,7 @@
   * [v2.2.1 - 10/Dec/2024](setup/release-notes/v2.2.1.md)
   * [v2.3.0 - 30/Jan/2025](setup/release-notes/v2.3.0.md)
   * [v2.3.1 - 17/Mar/2025](setup/release-notes/v2.3.1.md)
+  * [v2.3.2 - 22/Apr/2025](setup/release-notes/v2.3.2.md)
 * [Upgrade SUSE Observability](setup/upgrade-stackstate/README.md)
   * [Migration from StackState](setup/upgrade-stackstate/migrate-from-6.md)
   * [Steps to upgrade](setup/upgrade-stackstate/steps-to-upgrade.md)

SUMMARY.md

@@ -0,0 +1,19 @@
+---
+description: SUSE Observability Self-hosted 
+---
+
+# Analytics page
+
+Analytics page provides a powerful and flexible interface to query and analyze your observability data using [STQL queries](../develop/reference/k8sTs-stql_reference.md). 
+This interactive environment empowers you to go beyond pre-built dashboards and gain deeper insights into the health, performance, and dependencies of your dynamic environment.
+
+{% hint style="warning" %}
+**The Analytics page is deprecated, but you can still enable it by configuring specific permissions. However, we strongly recommend leveraging StackPacks for enhanced observability and analysis, as they provide a more robust and actively supported alternative.**
+
+Two permissions are required to enable Analytics Page:
+- `access-analytics`
+- `execute-scripts`
+
+More details: [Permissions management](../setup/security/rbac/rbac_permissions.md)
+
+{% endhint %}

advanced/analytics.md

@@ -0,0 +1,6 @@
+---
+description: SUSE Observability Self-hosted
+---
+
+# Advanced configuration
+

advanced/index.md

@@ -1,7 +1,7 @@
 #!/bin/bash
 
 # Namespace to collect information
-NAMESPACE="suse-observability"
+NAMESPACE=${1:-suse-observability}
 
 # Check if kubectl is installed or not
 if ! command -v kubectl &>/dev/null; then

scripts/suse-observability_logs_collector.sh

@@ -0,0 +1,63 @@
+---
+description: SUSE Observability Self-hosted
+---
+
+# Alibaba Cloud Container Service for Kubernetes (ACK) installation notes
+
+## Minimum volume size
+
+Alibaba Cloud's Container Service for Kubernetes (ACK) enforces a minimum volume size of **20 GiB** for disk-based PersistentVolumeClaims (PVCs). When deploying on ACK, Persistent Volume Claims (pvc) have to request **at least 20Gi** of storage. Failure to meet the 20Gi minimum may result in volume provisioning and failures during Helm deployment.
+
+We provide a dedicated set of Helm values that adjusts all volume sizes to meet this requirement. If you're installing on ACK, use this file during installation:
+
+```yaml
+# ack-values.yaml
+zookeeper:
+  persistence:
+    size: 20Gi
+stackstate:
+  components:
+    checks:
+      tmpToPVC:
+        volumeSize: 20Gi
+    healthSync:
+      tmpToPVC:
+        volumeSize: 20Gi
+      localpvc:
+        size: 20Gi
+    state:
+      tmpToPVC:
+        volumeSize: 20Gi
+    sync:
+      tmpToPVC:
+        volumeSize: 20Gi
+    vmagent:
+      persistence:
+        size: 20Gi
+  experimental:
+    storeTransactionLogsToPVC:
+      volumeSize: 20Gi
+  stackpacks:
+    localpvc:
+      size: 20Gi
+    pvc:
+      size: 20Gi
+backup:
+  configuration:
+    scheduled:
+      pvc:
+        size: 20Gi
+```  
+
+Please create a separate file for the ACK-specific values and use it during installation. For example, if you follow [Kubernetes install documentation](https://docs.stackstate.com/self-hosted-setup/install-stackstate/kubernetes_openshift/kubernetes_install#deploy-suse-observability-with-helm) and save the above values in a file called `ack-values.yaml`, you can install Suse Observability with:
+
+```bash
+helm upgrade \
+  --install \
+  --namespace suse-observability \
+  --values $VALUES_DIR/suse-observability-values/templates/baseConfig_values.yaml \
+  --values $VALUES_DIR/suse-observability-values/templates/sizing_values.yaml \
+  --values ack-values.yaml \
+suse-observability \
+suse-observability/suse-observability
+```

setup/install-stackstate/kubernetes_openshift/ack.md

@@ -45,7 +45,7 @@ helm upgrade --install \
   --namespace "suse-observability" \
   --values "ingress_values.yaml" \
   --values $VALUES_DIR/suse-observability-values/templates/baseConfig_values.yaml \
-  --values $VALUES_DIR/suse-observability-values/templates/sizing_values.yaml \  
+  --values $VALUES_DIR/suse-observability-values/templates/sizing_values.yaml \
 suse-observability \
 suse-observability/suse-observability
 ```
@@ -107,7 +107,7 @@ helm upgrade \
   --namespace "suse-observability" \
   --values "ingress_otel_values.yaml" \
   --values $VALUES_DIR/suse-observability-values/templates/baseConfig_values.yaml \
-  --values $VALUES_DIR/suse-observability-values/templates/sizing_values.yaml \ 
+  --values $VALUES_DIR/suse-observability-values/templates/sizing_values.yaml \
 suse-observability \
 suse-observability/suse-observability
 ```

setup/install-stackstate/kubernetes_openshift/ingress.md

@@ -10,9 +10,10 @@ description: SUSE Observability Self-hosted
 Extra notes for installing on:
 
 * **Kubernetes clusters with limited permissions**: Read the [required permissions](required_permissions.md).
+* **Alibaba Cloud Container Service for Kubernetes (ACK)**: Read the [ACK installation notes](ack.md).
 * **OpenShift**: Refer to the [OpenShift installation instructions](openshift_install.md).
 {% endhint %}
-
+ 
 Before you start the installation of SUSE Observability:
 
 * Check the [requirements](/setup/install-stackstate/requirements.md) to make sure that your Kubernetes environment fits the setup that you will use (recommended, minimal or non- high availability).
@@ -114,7 +115,7 @@ helm upgrade \
   --install \
   --namespace suse-observability \
   --values $VALUES_DIR/suse-observability-values/templates/baseConfig_values.yaml \
-  --values $VALUES_DIR/suse-observability-values/templates/sizing_values.yaml \  
+  --values $VALUES_DIR/suse-observability-values/templates/sizing_values.yaml \
 suse-observability \
 suse-observability/suse-observability
 ```

setup/install-stackstate/kubernetes_openshift/kubernetes_install.md

@@ -141,7 +141,7 @@ helm upgrade \
   --install \
   --namespace suse-observability \
   --values $VALUES_DIR/suse-observability-values/templates/baseConfig_values.yaml \
-  --values $VALUES_DIR/suse-observability-values/templates/sizing_values.yaml \  
+  --values $VALUES_DIR/suse-observability-values/templates/sizing_values.yaml \
   --values openshift-values.yaml \
   --set "clickhouse.sidecars[0].securityContext.runAsUser=null" \
 suse-observability \
@@ -164,7 +164,7 @@ helm upgrade \
   --namespace suse-observability \
   --values local-docker-registry.yaml \
   --values $VALUES_DIR/suse-observability-values/templates/baseConfig_values.yaml \
-  --values $VALUES_DIR/suse-observability-values/templates/sizing_values.yaml \  
+  --values $VALUES_DIR/suse-observability-values/templates/sizing_values.yaml \
   --values openshift-values.yaml \
   --set "clickhouse.sidecars[0].securityContext.runAsUser=null" \
 suse-observability \

setup/install-stackstate/kubernetes_openshift/openshift_install.md

@@ -93,6 +93,21 @@ stackstate:
     vmagent:
       persistence:
         size: 10Gi
+  experimental:
+    storeTransactionLogsToPVC:
+      volumeSize: 600Mi
+  stackpacks:
+    pvc:
+      size: 1Gi
+
+backup:
+  configuration:
+    scheduled:
+      pvc:
+        size: 1Gi
+minio:
+  persistence:
+    size: 500Gi
 ```
 {% endtab %}
 {% tab title="Changing volume size Non-Ha" %}
@@ -148,6 +163,23 @@ stackstate:
     vmagent:
       persistence:
         size: 10Gi
+  experimental:
+    storeTransactionLogsToPVC:
+      volumeSize: 600Mi
+  stackpacks:
+    localpvc:
+      size: 1Gi
+    pvc:
+      size: 1Gi
+
+backup:
+  configuration:
+    scheduled:
+      pvc:
+        size: 1Gi
+minio:
+  persistence:
+    size: 500Gi
 ```
 {% endtab %}
 {% endtabs %}