How to ingest Managed Service for Kubernetes® logs with OpenTelemetry Collector

​

Prerequisites

1. Install and configure the 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  → Add to group, and select editors. Only users with the admin role can add a service account to a group.
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 OpenTelemetry 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