Merge branch 'main' into main

.github/CODEOWNERS

@@ -17,3 +17,4 @@
 /charts/enterprise-logs/ @grafana/loki-squad
 /charts/tempo-vulture/ @grafana/tempo @Whyeasy @dgzlopes
 /charts/synthetic-monitoring-agent/ @torstenwalter @zanhsieh
+/charts/agent-operator/ @grafana/grafana-agent-maintainers

.github/workflows/release.yaml

@@ -47,14 +47,19 @@ jobs:
           CR_TOKEN: "${{ secrets.GITHUB_TOKEN }}"
           CR_SKIP_EXISTING: "true"
 
+      - name: Login to GHCR
+        uses: docker/[email protected]
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
       - name: Push charts to GHCR
         run: |
           shopt -s nullglob
-          for pkg in .cr-release-packages/*; do
+          for pkg in .cr-release-packages/*.tgz; do
             if [ -z "${pkg:-}" ]; then
               break
             fi
-            if ! helm push "${pkg}" "oci://ghcr.io/${GITHUB_REPOSITORY_OWNER}/charts"; then
-              echo '::warning:: helm push failed!'
-            fi
+            helm push "${pkg}" "oci://ghcr.io/${GITHUB_REPOSITORY_OWNER}/helm-charts"
           done

.github/workflows/update-helm-repo.yaml

@@ -79,15 +79,15 @@ jobs:
 
             if [ $(git tag -l "${name}-${version}") ]; then
               echo "Tag ${tagname} already exists, skipping release"
-              echo "::set-output name=changed::false"
+              echo "changed=false" >> $GITHUB_OUTPUT
             else
               echo "Releasing ${changed}"
-              echo "::set-output name=changed::true"
-              echo "::set-output name=chartpath::${changed}"
+              echo "changed=true" >> $GITHUB_OUTPUT
+              echo "chartpath=${changed}" >> $GITHUB_OUTPUT
             fi
           else
             echo "No charts have changed, skipping release"
-            echo "::set-output name=changed::false"
+            echo "changed=false" >> $GITHUB_OUTPUT
           fi
 
   release:
@@ -166,14 +166,14 @@ jobs:
           description=$(yq ".description" < ${changed}/Chart.yaml)
           name=$(yq ".name" < ${changed}/Chart.yaml)
           version=$(yq ".version" < ${changed}/Chart.yaml)
-          echo "::set-output name=chartpath::${changed}"
-          echo "::set-output name=desc::${description}"
+          echo "chartpath=${changed}" >> $GITHUB_OUTPUT
+          echo "desc=${description}" >> $GITHUB_OUTPUT
           if [[ -n "${HELM_TAG_PREFIX}" ]]; then
-            echo "::set-output name=tagname::${HELM_TAG_PREFIX}-${name}-${version}"
+            echo "tagname=${HELM_TAG_PREFIX}-${name}-${version}" >> $GITHUB_OUTPUT
           else
-            echo "::set-output name=tagname::${name}-${version}"
+            echo "tagname=${name}-${version}" >> $GITHUB_OUTPUT
           fi
-          echo "::set-output name=packagename::${name}-${version}"
+          echo "packagename=${name}-${version}" >> $GITHUB_OUTPUT
 
       - name: Install CR tool
         run: |

charts/agent-operator/Chart.yaml

@@ -2,12 +2,12 @@ apiVersion: v2
 name: grafana-agent-operator
 description: A Helm chart for Grafana Agent Operator
 type: application
-version: 0.3.19
-appVersion: "0.40.3"
+version: 0.3.21
+appVersion: "0.40.4"
 home: https://grafana.com/docs/agent/v0.40/
-icon: https://raw.githubusercontent.com/grafana/agent/v0.40.3/docs/sources/assets/logo_and_name.png
+icon: https://raw.githubusercontent.com/grafana/agent/v0.40.4/docs/sources/assets/logo_and_name.png
 sources:
-  - https://github.com/grafana/agent/tree/v0.40.3/pkg/operator
+  - https://github.com/grafana/agent/tree/v0.40.4/pkg/operator
 maintainers:
   - name: Grafana Agent Team
     email: [email protected]

charts/agent-operator/README.md

@@ -1,14 +1,14 @@
 # grafana-agent-operator
 
-![Version: 0.3.19](https://img.shields.io/badge/Version-0.3.19-informational?style=flat-square) ![Type: application](https://img.shields.io/badge/Type-application-informational?style=flat-square) ![AppVersion: 0.40.3](https://img.shields.io/badge/AppVersion-0.40.3-informational?style=flat-square)
+![Version: 0.3.21](https://img.shields.io/badge/Version-0.3.21-informational?style=flat-square) ![Type: application](https://img.shields.io/badge/Type-application-informational?style=flat-square) ![AppVersion: 0.40.4](https://img.shields.io/badge/AppVersion-0.40.4-informational?style=flat-square)
 
 A Helm chart for Grafana Agent Operator
 
 ⚠️  **Please create issues relating to this Helm chart in the [Agent](https://github.com/grafana/agent/issues) repo.**
 
 ## Source Code
 
-* <https://github.com/grafana/agent/tree/v0.40.3/pkg/operator>
+* <https://github.com/grafana/agent/tree/v0.40.4/pkg/operator>
 
 Note that this chart does not provision custom resources like `GrafanaAgent` and `MetricsInstance` (formerly `PrometheusInstance`) or any `*Monitor` resources.
 
@@ -63,7 +63,7 @@ A major chart version change (like v1.2.3 -> v2.0.0) indicates that there is an
 | image.pullSecrets | list | `[]` | Image pull secrets |
 | image.registry | string | `"docker.io"` | Image registry |
 | image.repository | string | `"grafana/agent-operator"` | Image repo |
-| image.tag | string | `"v0.40.3"` | Image tag |
+| image.tag | string | `"v0.40.4"` | Image tag |
 | kubeletService | object | `{"namespace":"default","serviceName":"kubelet"}` | If both are set, Agent Operator will create and maintain a service for scraping kubelets https://grafana.com/docs/agent/latest/operator/getting-started/#monitor-kubelets |
 | nameOverride | string | `""` | Overrides the chart's name |
 | nodeSelector | object | `{}` | nodeSelector configuration |
@@ -75,4 +75,7 @@ A major chart version change (like v1.2.3 -> v2.0.0) indicates that there is an
 | resources | object | `{}` | Resource limits and requests config |
 | serviceAccount.create | bool | `true` | Toggle to create ServiceAccount |
 | serviceAccount.name | string | `nil` | Service account name |
+| test.image.registry | string | `"docker.io"` | Test image registry |
+| test.image.repository | string | `"library/busybox"` | Test image repo |
+| test.image.tag | string | `"latest"` | Test image tag |
 | tolerations | list | `[]` | Tolerations applied to Pods |

charts/agent-operator/templates/tests/test-grafanaagent.yaml

@@ -107,12 +107,12 @@ metadata:
 spec:
   containers:
   - name: busybox
-    image: busybox
+    image: "{{ .Values.test.image.registry }}/{{ .Values.test.image.repository }}:{{ .Values.test.image.tag }}"
     command: ['wget']
     args:  ['grafana-agent-test-operated:8080/-/healthy']
   # Wait for GrafanaAgent CR
   initContainers:
   - name: sleep
-    image: busybox
+    image: "{{ .Values.test.image.registry }}/{{ .Values.test.image.repository }}:{{ .Values.test.image.tag }}"
     command: ['sleep', '60']
   restartPolicy: Never

charts/agent-operator/values.yaml

@@ -37,12 +37,21 @@ image:
   # -- Image repo
   repository: grafana/agent-operator
   # -- Image tag
-  tag: v0.40.3
+  tag: v0.40.4
   # -- Image pull policy
   pullPolicy: IfNotPresent
   # -- Image pull secrets
   pullSecrets: []
 
+test:
+  image:
+    # -- Test image registry
+    registry: docker.io
+    # -- Test image repo
+    repository: library/busybox
+    # -- Test image tag
+    tag: latest
+
 # -- hostAliases to add
 hostAliases: []
 #  - ip: 1.2.3.4

charts/grafana-sampling/.helmignore

@@ -0,0 +1,23 @@
+# Patterns to ignore when building packages.
+# This supports shell glob matching, relative path matching, and
+# negation (prefixed with !). Only one pattern per line.
+.DS_Store
+# Common VCS dirs
+.git/
+.gitignore
+.bzr/
+.bzrignore
+.hg/
+.hgignore
+.svn/
+# Common backup files
+*.swp
+*.bak
+*.tmp
+*.orig
+*~
+# Various IDEs
+.project
+.idea/
+*.tmproj
+.vscode/

charts/grafana-sampling/Chart.lock

@@ -0,0 +1,9 @@
+dependencies:
+- name: grafana-agent
+  repository: https://grafana.github.io/helm-charts
+  version: 0.36.0
+- name: grafana-agent
+  repository: https://grafana.github.io/helm-charts
+  version: 0.36.0
+digest: sha256:6d04a55dce2c09c4c250c6453e0d58f7280750bf04fce51027b4e235062413e5
+generated: "2024-03-11T15:41:30.921516-07:00"

charts/grafana-sampling/Chart.yaml

@@ -0,0 +1,18 @@
+apiVersion: v2
+name: grafana-sampling
+description: A Helm chart for a layered OTLP tail sampling and metrics generation pipeline.
+type: application
+version: 0.1.1
+appVersion: "v0.40.2"
+sources:
+  - https://github.com/grafana/agent
+  - https://grafana.com/docs/grafana-cloud/monitor-applications/application-observability/setup/sampling/tail/
+dependencies:
+  - name: grafana-agent
+    version: 0.36.0
+    repository: https://grafana.github.io/helm-charts
+    alias: grafana-agent-deployment
+  - name: grafana-agent
+    version: 0.36.0
+    repository: https://grafana.github.io/helm-charts
+    alias: grafana-agent-statefulset

charts/grafana-sampling/README.md

@@ -0,0 +1,124 @@
+# grafana-sampling
+
+![Version: 0.1.1](https://img.shields.io/badge/Version-0.1.1-informational?style=flat-square) ![Type: application](https://img.shields.io/badge/Type-application-informational?style=flat-square) ![AppVersion: v0.40.2](https://img.shields.io/badge/AppVersion-v0.40.2-informational?style=flat-square)
+
+A Helm chart for a layered OTLP tail sampling and metrics generation pipeline.
+
+This chart deploys the following architecture to your environment:
+![Photo of sampling architecture](./sampling-architecture.png)
+
+Note: by default, only OTLP traces are accepted at the load balancing layer.
+
+## Chart Repo
+
+Add the following repo to use the chart:
+
+```console
+helm repo add grafana https://grafana.github.io/helm-charts
+```
+## Installing the Chart
+
+Use the following command to install the chart with the release name `my-release`. Make sure to populate the required values.
+
+```console
+helm install my-release grafana/grafana-sampling --values - <<EOF | less
+grafana-agent-statefulset:
+  agent:
+    extraEnv:
+      - name: GRAFANA_CLOUD_API_KEY
+        value: <REQUIRED>
+      - name: GRAFANA_CLOUD_PROMETHEUS_URL
+        value: <REQUIRED>
+      - name: GRAFANA_CLOUD_PROMETHEUS_USERNAME
+        value: <REQUIRED>
+      - name: GRAFANA_CLOUD_TEMPO_ENDPOINT
+        value: <REQUIRED>
+      - name: GRAFANA_CLOUD_TEMPO_USERNAME
+        value: <REQUIRED>
+      # This is required for adaptive metric deduplication in Grafana Cloud
+      - name: POD_UID
+        valueFrom:
+          fieldRef:
+            apiVersion: v1
+            fieldPath: metadata.uid
+EOF
+```
+
+## Uninstalling the Chart
+
+To uninstall/delete the my-release deployment:
+
+```console
+helm delete my-release
+```
+
+The command removes all the Kubernetes components associated with the chart and deletes the release.
+
+## Upgrading
+
+A major chart version change indicates that there is an incompatible breaking change needing manual actions.
+
+## Values
+
+| Key | Type | Default | Description |
+|-----|------|---------|-------------|
+| grafana-agent-deployment.agent.configMap.create | bool | `false` |  |
+| grafana-agent-deployment.agent.extraPorts[0].name | string | `"otlp-grpc"` |  |
+| grafana-agent-deployment.agent.extraPorts[0].port | int | `4317` |  |
+| grafana-agent-deployment.agent.extraPorts[0].protocol | string | `"TCP"` |  |
+| grafana-agent-deployment.agent.extraPorts[0].targetPort | int | `4317` |  |
+| grafana-agent-deployment.agent.extraPorts[1].name | string | `"otlp-http"` |  |
+| grafana-agent-deployment.agent.extraPorts[1].port | int | `4318` |  |
+| grafana-agent-deployment.agent.extraPorts[1].protocol | string | `"TCP"` |  |
+| grafana-agent-deployment.agent.extraPorts[1].targetPort | int | `4318` |  |
+| grafana-agent-deployment.agent.resources.requests.cpu | string | `"1"` |  |
+| grafana-agent-deployment.agent.resources.requests.memory | string | `"2G"` |  |
+| grafana-agent-deployment.controller.autoscaling.enabled | bool | `false` | Creates a HorizontalPodAutoscaler for controller type deployment. |
+| grafana-agent-deployment.controller.autoscaling.maxReplicas | int | `5` | The upper limit for the number of replicas to which the autoscaler can scale up. |
+| grafana-agent-deployment.controller.autoscaling.minReplicas | int | `2` | The lower limit for the number of replicas to which the autoscaler can scale down. |
+| grafana-agent-deployment.controller.autoscaling.targetCPUUtilizationPercentage | int | `0` | Average CPU utilization across all relevant pods, a percentage of the requested value of the resource for the pods. Setting `targetCPUUtilizationPercentage` to 0 will disable CPU scaling. |
+| grafana-agent-deployment.controller.autoscaling.targetMemoryUtilizationPercentage | int | `80` | Average Memory utilization across all relevant pods, a percentage of the requested value of the resource for the pods. Setting `targetMemoryUtilizationPercentage` to 0 will disable Memory scaling. |
+| grafana-agent-deployment.controller.replicas | int | `1` |  |
+| grafana-agent-deployment.controller.type | string | `"deployment"` |  |
+| grafana-agent-deployment.nameOverride | string | `"deployment"` | Do not change this. |
+| grafana-agent-statefulset.agent.configMap.create | bool | `false` |  |
+| grafana-agent-statefulset.agent.extraEnv[0].name | string | `"GRAFANA_CLOUD_API_KEY"` |  |
+| grafana-agent-statefulset.agent.extraEnv[0].value | string | `"<REQUIRED>"` |  |
+| grafana-agent-statefulset.agent.extraEnv[1].name | string | `"GRAFANA_CLOUD_PROMETHEUS_URL"` |  |
+| grafana-agent-statefulset.agent.extraEnv[1].value | string | `"<REQUIRED>"` |  |
+| grafana-agent-statefulset.agent.extraEnv[2].name | string | `"GRAFANA_CLOUD_PROMETHEUS_USERNAME"` |  |
+| grafana-agent-statefulset.agent.extraEnv[2].value | string | `"<REQUIRED>"` |  |
+| grafana-agent-statefulset.agent.extraEnv[3].name | string | `"GRAFANA_CLOUD_TEMPO_ENDPOINT"` |  |
+| grafana-agent-statefulset.agent.extraEnv[3].value | string | `"<REQUIRED>"` |  |
+| grafana-agent-statefulset.agent.extraEnv[4].name | string | `"GRAFANA_CLOUD_TEMPO_USERNAME"` |  |
+| grafana-agent-statefulset.agent.extraEnv[4].value | string | `"<REQUIRED>"` |  |
+| grafana-agent-statefulset.agent.extraEnv[5].name | string | `"POD_UID"` |  |
+| grafana-agent-statefulset.agent.extraEnv[5].valueFrom.fieldRef.apiVersion | string | `"v1"` |  |
+| grafana-agent-statefulset.agent.extraEnv[5].valueFrom.fieldRef.fieldPath | string | `"metadata.uid"` |  |
+| grafana-agent-statefulset.agent.extraPorts[0].name | string | `"otlp-grpc"` |  |
+| grafana-agent-statefulset.agent.extraPorts[0].port | int | `4317` |  |
+| grafana-agent-statefulset.agent.extraPorts[0].protocol | string | `"TCP"` |  |
+| grafana-agent-statefulset.agent.extraPorts[0].targetPort | int | `4317` |  |
+| grafana-agent-statefulset.agent.resources.requests.cpu | string | `"1"` |  |
+| grafana-agent-statefulset.agent.resources.requests.memory | string | `"2G"` |  |
+| grafana-agent-statefulset.controller.autoscaling.enabled | bool | `false` | Creates a HorizontalPodAutoscaler for controller type deployment. |
+| grafana-agent-statefulset.controller.autoscaling.maxReplicas | int | `5` | The upper limit for the number of replicas to which the autoscaler can scale up. |
+| grafana-agent-statefulset.controller.autoscaling.minReplicas | int | `2` | The lower limit for the number of replicas to which the autoscaler can scale down. |
+| grafana-agent-statefulset.controller.autoscaling.targetCPUUtilizationPercentage | int | `0` | Average CPU utilization across all relevant pods, a percentage of the requested value of the resource for the pods. Setting `targetCPUUtilizationPercentage` to 0 will disable CPU scaling. |
+| grafana-agent-statefulset.controller.autoscaling.targetMemoryUtilizationPercentage | int | `80` | Average Memory utilization across all relevant pods, a percentage of the requested value of the resource for the pods. Setting `targetMemoryUtilizationPercentage` to 0 will disable Memory scaling. |
+| grafana-agent-statefulset.controller.replicas | int | `1` |  |
+| grafana-agent-statefulset.controller.type | string | `"statefulset"` |  |
+| grafana-agent-statefulset.nameOverride | string | `"statefulset"` | Do not change this. |
+| grafana-agent-statefulset.rbac.create | bool | `false` |  |
+| grafana-agent-statefulset.service.clusterIP | string | `"None"` |  |
+| grafana-agent-statefulset.serviceAccount.create | bool | `false` |  |
+| metricsGeneration.dimensions | list | `["service.namespace","service.version","deployment.environment","k8s.cluster.name"]` | Additional dimensions to add to generated metrics. |
+| metricsGeneration.enabled | bool | `true` | Toggle generation of spanmetrics and servicegraph metrics. |
+| sampling.decisionWait | string | `"15s"` | Wait time since the first span of a trace before making a sampling decision. |
+| sampling.enabled | bool | `true` | Toggle tail sampling. |
+| sampling.extraPolicies | string | A policy to sample long requests is added by default. | User-defined policies in river format. |
+| sampling.failedRequests.percentage | int | `50` | Percentage of failed requests to sample. |
+| sampling.failedRequests.sample | bool | `false` | Toggle sampling failed requests. |
+| sampling.successfulRequests.percentage | int | `10` | Percentage of successful requests to sample. |
+| sampling.successfulRequests.sample | bool | `true` | Toggle sampling successful requests. |
+

charts/grafana-sampling/README.md.gotmpl

@@ -0,0 +1,63 @@
+{{ template "chart.header" . }}
+
+{{ template "chart.versionBadge" . }}{{ template "chart.typeBadge" . }}{{ template "chart.appVersionBadge" . }}
+
+{{ template "chart.description" . }}
+
+This chart deploys the following architecture to your environment:
+![Photo of sampling architecture](./sampling-architecture.png)
+
+Note: by default, only OTLP traces are accepted at the load balancing layer.
+
+
+## Chart Repo
+
+Add the following repo to use the chart:
+
+```console
+helm repo add grafana https://grafana.github.io/helm-charts
+```
+## Installing the Chart
+
+Use the following command to install the chart with the release name `my-release`. Make sure to populate the required values.
+
+```console
+helm install my-release grafana/grafana-sampling --values - <<EOF | less
+grafana-agent-statefulset:
+  agent:
+    extraEnv:
+      - name: GRAFANA_CLOUD_API_KEY
+        value: <REQUIRED>
+      - name: GRAFANA_CLOUD_PROMETHEUS_URL
+        value: <REQUIRED>
+      - name: GRAFANA_CLOUD_PROMETHEUS_USERNAME
+        value: <REQUIRED>
+      - name: GRAFANA_CLOUD_TEMPO_ENDPOINT
+        value: <REQUIRED>
+      - name: GRAFANA_CLOUD_TEMPO_USERNAME
+        value: <REQUIRED>
+      # This is required for adaptive metric deduplication in Grafana Cloud
+      - name: POD_UID
+        valueFrom:
+          fieldRef:
+            apiVersion: v1
+            fieldPath: metadata.uid
+EOF
+```
+
+## Uninstalling the Chart
+
+To uninstall/delete the my-release deployment:
+
+```console
+helm delete my-release
+```
+
+The command removes all the Kubernetes components associated with the chart and deletes the release.
+
+## Upgrading
+
+A major chart version change indicates that there is an incompatible breaking change needing manual actions.
+
+{{ template "chart.valuesSection" . }}
+