Saltar al contenido
fernet.consultores

Escenario de referenciaSplunk Observability CloudOpenTelemetryTécnico · 3 min de lectura

En el mapa de servicios aparece «unknown_service» o la misma aplicación cinco veces.

Escrito por Fernando Mateo Ruiz · Splunk Enterprise Certified Architect · Splunk O11y Cloud Certified Metrics User · Revisado el 28 octubre 2026

Escenario de referencia: describe una situación habitual y cómo la abordamos. No es un proyecto de cliente ni incluye resultados medidos.

En 30 segundos

El problema: Tras instrumentar, el mapa de servicios muestra «unknown_service», la misma aplicación con varios nombres o producción mezclada con pruebas.

Qué lo resuelve: Una convención de atributos de recurso definida antes de desplegar y aplicada en un único sitio.

Qué cambia: El mapa refleja la arquitectura real, los filtros por entorno funcionan y los detectores no se rompen.

¿Te suena?

  • En el mapa aparece unknown_service:java.
  • payments, payment-svc y Payments salen como tres servicios distintos.
  • Los datos de pruebas aparecen en los paneles de producción.
  • Cada equipo instrumenta a su manera.

La pregunta que hay que responder

¿Cómo se llama cada servicio, en qué entorno y versión se ejecuta, y es igual en todas las señales?

Por qué importa

Sin nombres coherentes no hay un mapa de servicios fiable ni correlación entre señales, y los detectores y los SLO se construyen precisamente sobre esos nombres.

Señales necesarias

  • Imprescindibleservice.name
  • Imprescindibledeployment.environment
  • Recomendadaservice.version
  • RecomendadaAtributos de host

Arquitectura

Escenario de referencia: la arquitectura es genérica y no pertenece a ningún cliente.

Cómo se implementa

  1. Escribir la convención: formato de service.name (por ejemplo, minúsculas con guiones) y valores permitidos de deployment.environment (prod, pre, test).
  2. Fijar los atributos en cada servicio con variables de entorno, idealmente en la plantilla común de despliegue.
  3. Añadir una red de seguridad en el Collector: el procesador resource con insert solo añade el atributo cuando falta.
  4. Revisar el mapa y la lista de servicios después de cada despliegue.
Atributos en el servicio · ejemplo
OTEL_SERVICE_NAME=payments
OTEL_RESOURCE_ATTRIBUTES=deployment.environment=prod,service.version=1.4.2
Red de seguridad en el Collector · ejemplo
processors:
  resource/entorno:
    attributes:
      - key: deployment.environment
        value: prod
        action: insert
# Añádelo a la lista de processors de tus pipelines.

Investigación paso a paso

Ejemplo ilustrativo de cómo se investigaría, de la señal a la acción.

  1. 01 SeñalAparece unknown_service:java con mucho tráfico en el mapa.
  2. 02 ContextoEs un despliegue nuevo que no definió OTEL_SERVICE_NAME.
  3. 03 CorrelaciónSus spans tienen los mismos hosts y endpoints que el servicio orders.
  4. 04 CausaUna réplica de orders se desplegó con una plantilla distinta.
  5. 05 DecisiónSe corrige en la plantilla de despliegue, no a mano en el servicio.
  6. 06 AcciónIncluir los atributos en la plantilla común y un control que rechace despliegues sin service.name.

Errores habituales

  • Dejar el nombre por defecto.
  • Meter el entorno en el nombre del servicio (payments-prod) en lugar de usar deployment.environment.
  • Renombrar servicios más adelante y romper detectores y paneles.
  • Usar valores de alta cardinalidad como atributos de recurso.

Qué no resuelve este caso

  • No corrige los datos que ya se enviaron.
  • No sustituye a un inventario de servicios y su arquitectura.

Resultado esperado

Cada servicio aparece una sola vez, con su entorno y su versión, y los filtros por entorno separan producción de pruebas.

Resultado observado

Es un escenario de referencia: no publicamos resultados medidos hasta probarlo en nuestro laboratorio o en un proyecto autorizado.

Requisitos

Plataforma

Splunk Observability Cloud

Acceso

Configuración de despliegue (variables, plantillas, Helm) y del Collector

Acuerdo

Convención común entre equipos

Servicios relacionados

Preguntas que te haríamos

  1. ¿Tenéis una convención escrita para nombrar servicios?
  2. ¿Cuántos equipos instrumentan aplicaciones?
  3. ¿Usáis plantillas comunes de despliegue?
Hablemos de tu caso