Skip to main content
To ingest your Managed Service for Kubernetes cluster logs into the Nebius AI Cloud Logging service, install the OpenTelemetry Collector and create a ConfigMap with its settings.

Prerequisites

  1. Install and configure Nebius AI Cloud CLI.
  2. If you don’t have a service account for observability services, create one.
  3. Make sure that the service account is in a group that has at least the editor role within your tenant; for example, the default editors group. You can check this in the Administration → IAM section of the web console. If the service account is not in the required group, click https://mintcdn.com/nebius-ai-cloud/1Ha0sWR6e1mnIaHS/_assets/button-vellipsis.svg?fit=max&auto=format&n=1Ha0sWR6e1mnIaHS&q=85&s=e80b8e57c43bfd117679262e6a1334ad → Add to group, and select editors.
  4. Issue a static key for the service account using the following command:
    nebius iam static-key issue \
      --name <name_for_the_key> \
      --account-service-account-id <service_account_ID> \
      --service observability
    
    Copy the value of the static key from the token parameter of the response. You will need it later in the configuration steps.

Install and configure OpenTelemetry Collector

  1. Connect to your Managed Service for Kubernetes cluster.
  2. Create a namespace for the observability components:
    kubectl create namespace observability
    
  3. Create a Kubernetes Secret for your token:
    kubectl create secret generic nebius-o11y-token \
      --from-literal token=<token_value> --namespace observability
    
    In this command, specify the token value of the static key that you got earlier.
  4. Create a ConfigMap with the Nebius AI Cloud Collector settings:
    kubectl create configmap nebius-otel-config \
      --from-literal=project-id=<project_ID> \
      --from-literal=endpoint=write.logging.<region_ID>.nebius.cloud:443 \
      --namespace observability
    
    In this command, specify your region ID from the region list, and your project ID.
  5. Install and update the OpenTelemetry repository with Helm charts:
    helm repo add open-telemetry https://open-telemetry.github.io/opentelemetry-helm-charts
    helm repo update
    
  6. Install the opentelemetry-collector chart:
    helm install otel-collector open-telemetry/opentelemetry-collector 
      --namespace observability
      --values https://raw.githubusercontent.com/nebius/observability/8f4913657058cbc81b3b4630a48b3641e642c910/charts/otel-collector/values/values-daemonset.yaml
    
  7. Check the installation:
    kubectl get pods --namespace observability
    
Now, OpenTelemetry Collector writes logs from your Managed Service for Kubernetes cluster to Logging. Logs appear in the default bucket.
Connect Grafana® to view ingested logs within it.

The Grafana Labs Marks are trademarks of Grafana Labs, and are used with Grafana Labs’ permission. We are not affiliated with, endorsed or sponsored by Grafana Labs or its affiliates.