Setting up a demo app and collecting telemetry in Kubernetes

You will set up a demo app in a Kubernetes cluster and send the app's telemetry data to Monium. This guide uses Managed Service for Kubernetes to deploy a cluster, but you can any of your Kubernetes clusters.

Getting startedGetting started

Sign up for Yandex Cloud and create a billing account:

1. Navigate to the management console and log in to Yandex Cloud or create a new account.
2. On the Yandex Cloud Billing page, make sure you have a billing account linked and it has the ACTIVE or TRIAL_ACTIVE status. If you do not have a billing account, create one and link a cloud to it.

If you have an active billing account, you can create or select a folder for your infrastructure on the cloud page.

Learn more about clouds and folders here.

Required paid resourcesRequired paid resources

The cost of resources you need for Monium includes:

• Fee for using a Managed Service for Kubernetes master (see Managed Service for Kubernetes pricing).
• Fee for the Managed Service for Kubernetes node group's computing resources and disks (see Yandex Compute Cloud pricing).
• Fee for using Monium (see Monium pricing).

Setting up a clusterSetting up a cluster

Delivering and viewing telemetryDelivering and viewing telemetry

1. Create a file named otel-demo-monium.yml with the following configuration:

   # https://github.com/open-telemetry/opentelemetry-helm-charts/blob/main/charts/opentelemetry-demo/README.md
   opentelemetry-collector:
   extraEnvsFrom:
       - secretRef:
           name: monium-secrets
   
   config:
       receivers:
       # Collection of grafana metrics, not configured in the demo app by default
       prometheus:
           config:
           scrape_configs:
               - job_name: "grafana"
               kubernetes_sd_configs:
                   - role: pod
               relabel_configs:
                   # Filtering by label (keep grafana only)
                   - source_labels: [__meta_kubernetes_pod_label_app_kubernetes_io_name]
                   action: keep
                   regex: grafana
   
                   # Replacing the address with the pod IP and port 3000
                   - source_labels: [__address__]
                   action: replace
                   regex: "([^:]+)(?::\\d+)?"
                   replacement: "$1:3000"
                   target_label: __address__
   
                   # Specifying the path to the metrics
                   - action: replace
                   target_label: __metrics_path__
                   replacement: /grafana/metrics
   
       exporters:
       debug:
           verbosity: detailed
   
       otlp/monium:
           compression: none
           endpoint: ingest.monium.yandex.cloud:443
           headers:
           Authorization: "Api-Key ${env:MONIUM_API_KEY}"
           x-monium-project: folder__<folder_ID>
   
       service:
       extensions: [health_check]
       pipelines:
           traces:
           receivers: [otlp]
           exporters: [otlp, spanmetrics, otlp/monium]
   
           logs:
           receivers: [otlp]
           exporters: [opensearch, otlp/monium]
   
           metrics:
           receivers: [httpcheck/frontend-proxy, otlp, prometheus, redis, spanmetrics]
           exporters: [otlphttp/prometheus, otlp/monium]
   
       telemetry:
           resource:
           service: otel-collector
           metrics:
           level: detailed
           readers:
               - periodic:
                   exporter:
                   otlp:
                       endpoint: ${env:MY_POD_IP}:4317
                       protocol: grpc
                   interval: 10000
                   timeout: 5000
   

2. Install the demo app to deliver logs, metrics, and traces to Monium:

   helm uninstall otel-demo-monium -n $NS --ignore-not-found
   helm install otel-demo-monium open-telemetry/opentelemetry-demo \
   --version 0.37 \
   -n $NS \
   --values otel-demo-monium.yml
   

3. Generate traffic to send telemetry.

   1. Configure port forwarding for frontend-proxy:

      kubectl --namespace default port-forward svc/frontend-proxy 8080:8080
      

   2. In your browser, open the online store at http://localhost:8080/ and simulate user activity. For example, add an item to the cart.

View telemetry dataView telemetry data

To use telemetry data, create a dashboard and alerts.

If Monium does not show telemetryIf Monium does not show telemetry

• Make sure the service account and API key have the required roles and scopes.

• Check that the secrets feature the correct API key:

  kubectl get secret monium-secrets -n $NS -o jsonpath='{.data.MONIUM_API_KEY}' | base64 -d
  

• Check the OTel Collector logs:

  kubectl logs -l app.kubernetes.io/name=opentelemetry-collector -n $NS
  

• Make sure the Monium endpoint is accessible:

  kubectl run -it --rm debug --image=curlimages/curl --restart=Never -- \
  curl -v https://ingest.monium.yandex.cloud