operations

El repositorio operations opera lo que le permite a un equipo ver cómo está su producto: el camino que lleva registros, métricas y trazas a Grafana Cloud, los paneles y las reglas de alerta que cada producto recibe desde su entrada en el catálogo, el informe diario de costos, y el catálogo de arquitectura que mapea cada producto. Ningún equipo configura nada de esto a mano: todo sale del catálogo.

Para qué sirve

Un producto que nadie puede observar es un producto que nadie puede operar. operations se asegura de que cada producto empiece con la misma observabilidad, sin que el equipo la construya, y de que la propia plataforma se observe de la misma forma.

Qué contiene

roots/telemetry: las puertas de enlace de telemetría, un par por edición, producción y no producción, que ejecutan Grafana Alloy, el recolector de telemetría de Grafana, sobre Cloud Run y bajan a cero. Las aplicaciones envían trazas y métricas por OTLP, el protocolo de OpenTelemetry, y sus registros llegan a las puertas de enlace a través de un buffer. Los puntos de conexión se publican para que la salida Ready de cada producto los lleve.
roots/grafana: el reconciliador del único stack de Grafana Cloud. Desde el catálogo crea los equipos y una carpeta por producto, y en la carpeta de cada producto un panel del servicio, un panel de confiabilidad y un panel de costos, con reglas de alerta básicas que evalúan producción y avisan al punto de contacto del equipo.
roots/cost: el conjunto de datos que recibe la exportación de facturación de Google Cloud. Un trabajo diario, cost:report, la convierte en las series de costo detrás del panel de costos de cada producto, con el presupuesto del producto en el catálogo como umbral: naranja al 80 por ciento y rojo al 100.
roots/eventcatalog y eventcatalog/: el catálogo de arquitectura. Cada repositorio publica una descripción de sí mismo en cada merge; un agregador las reúne en un solo sitio, que se reconstruye después de cada publicación y cada hora, en catalog.projectairframe.dev detrás del inicio de sesión único.
jobs/: los informes programados: cobertura de pruebas, costos y entregas.

Cómo se conecta

Lee el catálogo. La cadena después de un merge en el catálogo ejecuta el pipeline de este repositorio en segundo lugar, después de landing-zone, para que las identidades a las que da permisos ya existan.
Lee las salidas de landing-zone. La raíz de telemetría da a las identidades de cada producto lo que necesitan para enviar telemetría; la raíz de Grafana ubica los paneles de cada producto.
Los productos le publican. La propia raíz infra/grafana de un producto publica sus paneles, y la raíz de Grafana los crea en la carpeta del producto, así que el producto nunca tiene una credencial de Grafana.
Los informes de deriva no están aquí. La programación diaria de cada repositorio planifica sus raíces y mantiene un issue por cada raíz con deriva en ese repositorio. Consulta deriva.

Quién lo cambia, y cómo

Los cambios son merge requests aprobados por el equipo de plataforma, con la aprobación de la compuerta obligatoria. En main, cada raíz planifica, pasa el paquete de políticas y aplica con su propia identidad, con los tokens de Grafana leídos desde Secret Manager al ejecutarse.

Algunas partes del diseño todavía no están construidas: los agentes de operaciones y de auditoría, las skills de agente con su banco de pruebas, y el servidor MCP del catálogo están previstos en este repositorio y hoy no existen.

Su costo permanente es de unos USD 7 al mes por la instancia del agente de plataforma de no producción, un recolector Grafana Alloy de las métricas propias de la plataforma (un agente solo de nombre), más centavos de almacenamiento para la exportación de facturación; las puertas de enlace bajan a cero.

Dónde está

En el repositorio operations: