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-svcyPaymentssalen 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
- Escribir la convención: formato de
service.name(por ejemplo, minúsculas con guiones) y valores permitidos dedeployment.environment(prod, pre, test). - Fijar los atributos en cada servicio con variables de entorno, idealmente en la plantilla común de despliegue.
- Añadir una red de seguridad en el Collector: el procesador
resourceconinsertsolo añade el atributo cuando falta. - Revisar el mapa y la lista de servicios después de cada despliegue.
OTEL_SERVICE_NAME=payments
OTEL_RESOURCE_ATTRIBUTES=deployment.environment=prod,service.version=1.4.2
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.
- 01 SeñalAparece
unknown_service:javacon mucho tráfico en el mapa. - 02 ContextoEs un despliegue nuevo que no definió
OTEL_SERVICE_NAME. - 03 CorrelaciónSus spans tienen los mismos hosts y endpoints que el servicio
orders. - 04 CausaUna réplica de
ordersse desplegó con una plantilla distinta. - 05 DecisiónSe corrige en la plantilla de despliegue, no a mano en el servicio.
- 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 usardeployment.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
- ¿Tenéis una convención escrita para nombrar servicios?
- ¿Cuántos equipos instrumentan aplicaciones?
- ¿Usáis plantillas comunes de despliegue?