Estándar Abierto para el Esquema de Intercambio de Recursos de Infraestructura

OSIRIS JSON produce documentos JSON independientes de proveedor para describir recursos de infraestructura y sus relaciones topológicas en entornos heterogéneos de IT y OT. Un formato de intercambio diseñado para la portabilidad, la claridad de extremo a extremo y la inclusión OT desde su concepción.

rocket_launch Comenzar

crisis_alert

El problema

La infraestructura moderna abarca múltiples stacks y proveedores: hyperscalers (AWS, Azure, GCP, etc.), proveedores de nube pública, centros de datos on-prem e integración con entornos OT complejos.

Aunque algunas plataformas exportan inventarios (a menudo como JSON), las representaciones son inconsistentes entre proveedores incluso para conceptos equivalentes como identidad, propiedades y relaciones.

warning

La documentación precisa de topologías y arquitectura de sistemas es costosa y frágil. Los equipos dependen de documentación fragmentada y diagramas manuales. El contexto crítico vive en la cabeza de las personas.

verified

La solución

OSIRIS JSON define un esquema JSON independiente de proveedor para describir recursos de infraestructura y relaciones topológicas en entornos heterogéneos.

El objetivo de OSIRIS JSON es normalizar las exportaciones de hyperscalers y proveedores cloud, así como de dispositivos en centros de datos on-prem (cómputo, almacenamiento, red).

Desde la primera versión de la Especificación, OSIRIS JSON soporta la inclusión de OT por diseño.

check_circle

Visibilidad cross-platform y consumo portable por herramientas (diagramación, inventario, auditoría) sin requerir que cada consumidor implemente parsers específicos de proveedor.

Qué obtienes

Seis capacidades principales que hacen de OSIRIS JSON un estándar abierto para el intercambio de recursos de infraestructura y topología.

schema

Diseño unificado

Construido para entornos IT heterogéneos, con un camino claro de extensión para OT y otros dominios a medida que crece la adopción.

hub

Relaciones explícitas

Representación de primera clase de conexiones, dependencias, contención y otras relaciones topológicas.

account_tree

Agrupación flexible

Soporte para agrupación lógica y física que refleja estructuras organizativas y arquitectónicas reales sin forzar una taxonomía única.

dns

Atribución de proveedor

Los recursos preservan la trazabilidad hacia su sistema/proveedor de origen usando una representación estandarizada e independiente de proveedor.

extension

Diseñado para la extensibilidad

Un mecanismo definido para propiedades específicas de proveedor y tipos de recursos personalizados sin romper la compatibilidad.

verified_user

Validación en tres niveles

Validación estructural (esquema), semántica y de dominio que mejora la consistencia y calidad de datos cuando se aplican herramientas de validación.

Principios de diseño

OSIRIS JSON es un formato de intercambio de instantáneas estáticas. Captura lo que existe y cómo se relaciona en un momento dado. No fue diseñado como un sistema de monitoreo en tiempo real, una herramienta de despliegue ni un motor de Infrastructure-as-Code.

block OSIRIS JSON NO ES

Monitoreo/Telemetría

Usa Prometheus, Grafana, Zabbix, OpenTelemetry.

Plataformas de observabilidad

Usa Cilium, Grafana Tempo/Loki, etc.

Infrastructure as Code

Usa Terraform, Pulumi, TOSCA.

Gestión de configuración

Usa Ansible, Puppet, Chef, Salt.

check_circle OSIRIS JSON ES

Optimizado para escenarios donde la documentación y la topología deben intercambiarse entre sistemas y equipos.

photo_camera

Instantáneas de infraestructura fiables y flexibles

Captura "lo que existe" y "cómo se relaciona" en un momento dado.

description

Salidas listas para documentación

Permite inventarios consistentes, resúmenes técnicos y contexto de sistema.

flowsheet

Topología orientada a diagramas

Proporciona relaciones normalizadas para visualización automatizada y generación de diagramas.

sync_alt

Alimentación de flujos CMDB / IPAM / DCIM

Exporta datos normalizados a sistemas de registro y herramientas de gestión de activos.

security

Soporte para auditoría

Asiste la recopilación de evidencias y trazabilidad estandarizando estructura y relaciones.

Prueba los ejemplos de OSIRIS JSON

Explora instantáneas reales de topología OSIRIS JSON con relaciones, proveedores y agrupaciones capturadas en un documento JSON portable.

download Descargar los ejemplos

Ejemplos IT

Aplicación ejecutándose en Azure con servicios API en AWS

OSIRIS multi-hyperscaler example showing Azure and AWS resources in a shared topology

description /examples/v1.0/IT/hyperscalers/osiris_multi_hyperscaler_environment.json

											1{
2  "$schema": "https://osirisjson.org/schema/v1.0/osiris.schema.json",
3  "version": "1.0.0",
4  "metadata": {
5    "timestamp": "2026-01-08T15:45:00Z",
6    "generator": {
7      "name": "manual",
8      "version": "1.0.0"
9    },
10    "scope": {
11      "name": "Multi-cloud web application",
12      "description": "Three-tier application with frontend and database in Azure East US, API backend in AWS US-East-1",
13      "providers": ["aws", "azure"],
14      "regions": ["us-east-1", "eastus"],
15      "accounts": ["123456789012"],
16      "environments": ["production"]
17    }
18  },
19  "topology": {
20    "resources": [
21      {
22        "id": "azure::app-web-frontend",
23        "type": "compute.container",
24        "name": "web-frontend-prod",
25        "description": "Azure App Service hosting React frontend",
26        "provider": {
27          "name": "azure",
28          "type": "Microsoft.Web/sites",
29          "native_id": "/subscriptions/sub-001/resourceGroups/prod-rg/providers/Microsoft.Web/sites/web-frontend-prod",
30          "region": "eastus",
31          "subscription": "sub-001",
32          "tenant": "tenant-001"
33        },
34        "status": "active",
35        "state": "running",
36        "properties": {
37          "kind": "app,linux",
38          "runtime_stack": "NODE|18-lts",
39          "default_hostname": "web-frontend-prod.azurewebsites.net",
40          "https_only": true,
41          "ftps_state": "Disabled",
42          "reserved": true
43        },
44        "tags": {
45          "Environment": "production",
46          "Tier": "frontend",
47          "Platform": "azure"
48        }
49      },
50      {
51        "id": "aws::i-0xyz789abc123",
52        "type": "compute.vm",
53        "name": "api-server-prod-01",
54        "description": "AWS EC2 instance running API backend",
55        "provider": {
56          "name": "aws",
57          "type": "AWS::EC2::Instance",
58          "native_id": "i-0xyz789abc123",
59          "region": "us-east-1",
60          "account": "123456789012",
61          "zone": "us-east-1b"
62        },
63        "status": "active",
64        "state": "running",
65        "properties": {
66          "instance_type": "c5.xlarge",
67          "platform": "linux",
68          "image_id": "ami-0c55b159cbfafe1f0",
69          "private_ip": "10.0.2.78",
70          "public_ip": "203.0.113.10",
71          "vpc_id": "vpc-0def456",
72          "subnet_id": "subnet-0ghi789"
73        },
74        "tags": {
75          "Environment": "production",
76          "Tier": "backend",
77          "Platform": "aws"
78        }
79      },
80      {
81        "id": "azure::sql-prod-db",
82        "type": "application.database",
83        "name": "prod-sql-database",
84        "description": "Azure SQL Database for application data",
85        "provider": {
86          "name": "azure",
87          "type": "Microsoft.Sql/servers/databases",
88          "native_id": "/subscriptions/sub-001/resourceGroups/prod-rg/providers/Microsoft.Sql/servers/prod-sql-srv/databases/prod-db",
89          "region": "eastus",
90          "subscription": "sub-001"
91        },
92        "status": "active",
93        "state": "online",
94        "properties": {
95          "edition": "Standard",
96          "service_tier": "S2",
97          "max_size_bytes": 268435456000,
98          "server_name": "prod-sql-srv.database.windows.net",
99          "collation": "SQL_Latin1_General_CP1_CI_AS",
100          "zone_redundant": false
101        },
102        "tags": {
103          "Environment": "production",
104          "Engine": "mssql",
105          "Platform": "azure"
106        }
107      },
108      {
109        "id": "azure::redis-cache-prod",
110        "type": "application.cache",
111        "name": "prod-redis-cache",
112        "description": "Azure Redis Cache for session storage",
113        "provider": {
114          "name": "azure",
115          "type": "Microsoft.Cache/Redis",
116          "native_id": "/subscriptions/sub-001/resourceGroups/prod-rg/providers/Microsoft.Cache/Redis/prod-redis",
117          "region": "eastus",
118          "subscription": "sub-001"
119        },
120        "status": "active",
121        "state": "running",
122        "properties": {
123          "sku": "Standard",
124          "family": "C",
125          "capacity": 1,
126          "redis_version": "6.0",
127          "port": 6379,
128          "ssl_port": 6380,
129          "hostname": "prod-redis.redis.cache.windows.net"
130        },
131        "tags": {
132          "Environment": "production",
133          "Purpose": "session-cache",
134          "Platform": "azure"
135        }
136      }
137    ],
138    "connections": [
139      {
140        "id": "conn-frontend-to-api",
141        "type": "dependency",
142        "source": "azure::app-web-frontend",
143        "target": "aws::i-0xyz789abc123",
144        "direction": "forward",
145        "name": "Frontend to API",
146        "description": "Cross-cloud API calls from Azure frontend to AWS backend",
147        "status": "active",
148        "properties": {
149          "protocol": "https",
150          "port": 443,
151          "endpoint": "https://api.example.com/v1",
152          "authentication": "oauth2"
153        },
154        "tags": {
155          "type": "cross-cloud",
156          "critical": "true"
157        }
158      },
159      {
160        "id": "conn-api-to-db",
161        "type": "dependency",
162        "source": "aws::i-0xyz789abc123",
163        "target": "azure::sql-prod-db",
164        "direction": "forward",
165        "name": "API to Database",
166        "description": "Database connection from AWS API to Azure SQL",
167        "status": "active",
168        "properties": {
169          "protocol": "tds",
170          "port": 1433,
171          "connection_string_encrypted": true,
172          "connection_pool_size": 20
173        },
174        "tags": {
175          "type": "cross-cloud",
176          "critical": "true"
177        }
178      },
179      {
180        "id": "conn-frontend-to-cache",
181        "type": "dependency",
182        "source": "azure::app-web-frontend",
183        "target": "azure::redis-cache-prod",
184        "direction": "bidirectional",
185        "name": "Frontend session cache",
186        "description": "Session data storage and retrieval",
187        "status": "active",
188        "properties": {
189          "protocol": "redis",
190          "port": 6380,
191          "ssl": true,
192          "use_case": "session-storage"
193        }
194      },
195      {
196        "id": "conn-api-to-cache",
197        "type": "dependency",
198        "source": "aws::i-0xyz789abc123",
199        "target": "azure::redis-cache-prod",
200        "direction": "bidirectional",
201        "name": "API cache access",
202        "description": "API response caching",
203        "status": "active",
204        "properties": {
205          "protocol": "redis",
206          "port": 6380,
207          "ssl": true,
208          "use_case": "response-cache"
209        }
210      }
211    ]
212  }
213}

Ejemplos IT

Híbrido hyperscaler AWS y on-premise

OSIRIS hybrid infrastructure example preview

description /examples/v1.0/IT/hybrid/osiris_hybrid_hyperscaler_on_premise.json

											1{
2  "$schema": "https://osirisjson.org/schema/v1.0/osiris.schema.json",
3  "version": "1.0.0",
4  "metadata": {
5    "timestamp": "2026-01-08T16:20:05Z",
6    "generator": {
7      "name": "manual",
8      "version": "1.0.0"
9    },
10    "scope": {
11      "name": "Hybrid cloud infrastructure",
12      "description": "Web tier in AWS connected via VPN to application and database servers in MXP datacenter",
13      "providers": ["aws", "custom"],
14      "regions": ["us-east-1"],
15      "accounts": ["123456789012"],
16      "sites": ["mxp-dc-01"],
17      "environments": ["production"]
18    }
19  },
20  "topology": {
21    "resources": [
22      {
23        "id": "aws::i-0web456def789",
24        "type": "compute.vm",
25        "name": "web-public-prod-01",
26        "description": "Public facing web server in AWS",
27        "provider": {
28          "name": "aws",
29          "type": "AWS::EC2::Instance",
30          "native_id": "i-0web456def789",
31          "region": "us-east-1",
32          "account": "123456789012",
33          "zone": "us-east-1a"
34        },
35        "status": "active",
36        "state": "running",
37        "properties": {
38          "instance_type": "t3.large",
39          "platform": "linux",
40          "private_ip": "10.10.1.50",
41          "public_ip": "203.0.113.10",
42          "vpc_id": "vpc-hybrid-001"
43        },
44        "tags": {
45          "Environment": "production",
46          "Location": "cloud",
47          "Tier": "web"
48        }
49      },
50      {
51        "id": "mxp::srv-r770-001",
52        "type": "compute.server",
53        "name": "app-srv-01",
54        "description": "Dell PowerEdge R770 application server",
55        "provider": {
56          "name": "custom",
57          "namespace": "osiris.com.acme",
58          "native_id": "srv-r770-001",
59          "site": "mxp-dc-01",
60          "system": "datacenter-inventory"
61        },
62        "status": "active",
63        "state": "operational",
64        "properties": {
65          "manufacturer": "Dell",
66          "model": "PowerEdge R770",
67          "serial_number": "SRV770001",
68          "location": {
69            "datacenter": "MXP",
70            "room": "DC-A",
71            "rack": "R42",
72            "rack_unit": "U10-U12"
73          },
74          "hardware": {
75            "cpu": {
76              "model": "Intel Xeon Platinum 8470",
77              "cores": 52,
78              "threads": 104,
79              "sockets": 2
80            },
81            "memory": {
82              "total_gb": 512,
83              "type": "DDR5",
84              "speed_mhz": 4800
85            },
86            "storage": [
87              {
88                "type": "NVMe",
89                "capacity_gb": 960,
90                "interface": "PCIe Gen4",
91                "quantity": 4
92              }
93            ]
94          },
95          "network_interfaces": [
96            {
97              "name": "eth0",
98              "mac": "02:AA:BB:CC:DD:01",
99              "ip_address": "10.30.10.50",
100              "speed_gbps": 10
101            }
102          ],
103          "operating_system": "Red Hat Enterprise Linux 9.2",
104          "hypervisor": "none"
105        },
106        "tags": {
107          "Environment": "production",
108          "Location": "on-premise",
109          "Datacenter": "MXP",
110          "AssetTag": "ACME-R770-001"
111        }
112      },
113      {
114        "id": "mxp::srv-r770-002",
115        "type": "compute.server",
116        "name": "db-srv-01",
117        "description": "Dell PowerEdge R770 database server",
118        "provider": {
119          "name": "custom",
120          "namespace": "osiris.com.acme",
121          "native_id": "srv-r770-002",
122          "site": "mxp-dc-01",
123          "system": "datacenter-inventory"
124        },
125        "status": "active",
126        "state": "operational",
127        "properties": {
128          "manufacturer": "Dell",
129          "model": "PowerEdge R770",
130          "serial_number": "SRV770002",
131          "location": {
132            "datacenter": "MXP",
133            "room": "DC-A",
134            "rack": "R42",
135            "rack_unit": "U13-U15"
136          },
137          "hardware": {
138            "cpu": {
139              "model": "Intel Xeon Platinum 8470",
140              "cores": 52,
141              "threads": 104, 
142              "sockets": 2
143            },
144            "memory": {
145              "total_gb": 1024,
146              "type": "DDR5",
147              "speed_mhz": 4800
148            },
149            "storage": [
150              {
151                "type": "NVMe",
152                "capacity_gb": 3840,
153                "interface": "PCIe Gen4",
154                "quantity": 8,
155                "raid": "RAID 10"
156              }
157            ]
158          },
159          "network_interfaces": [
160            {
161              "name": "eth0",
162              "mac": "02:AA:BB:CC:DD:01",
163              "ip_address": "10.30.10.51",
164              "speed_gbps": 10
165            }
166          ],
167          "operating_system": "Red Hat Enterprise Linux 9.2",
168          "database": "Oracle Database 19c"
169        },
170        "tags": {
171          "Environment": "production",
172          "Location": "on-premise",
173          "Datacenter": "MXP",
174          "Purpose": "database",
175          "AssetTag": "ACME-R770-002"
176        }
177      },
178      {
179        "id": "mxp::storage-dell-me5024",
180        "type": "storage.array",
181        "name": "shared-storage-01",
182        "description": "Dell PowerStore ME5024 storage array",
183        "provider": {
184          "name": "custom",
185          "namespace": "osiris.com.acme",
186          "native_id": "storage-me5024-001",
187          "site": "mxp-dc-01",
188          "system": "datacenter-inventory"
189        },
190        "status": "active",
191        "state": "operational",
192        "properties": {
193          "manufacturer": "Dell",
194          "model": "PowerStore ME5024",
195          "serial_number": "ME5024001",
196          "location": {
197            "datacenter": "MXP",
198            "room": "DC-A",
199            "rack": "R43",
200            "rack_unit": "U20-U24"
201          },
202          "capacity": {
203            "raw_tb": 115.2,
204            "usable_tb": 86.4,
205            "used_tb": 42.1
206          },
207          "drives": {
208            "type": "SSD",
209            "capacity_gb": 3840,
210            "quantity": 24,
211            "interface": "SAS"
212          },
213          "protocols": ["iSCSI", "FC"],
214          "controllers": 2,
215          "redundancy": "dual-controller"
216        },
217        "tags": {
218          "Environment": "production",
219          "Location": "on-premise",
220          "Datacenter": "MXP",
221          "AssetTag": "ACME-STR-001"
222        }
223      },
224      {
225        "id": "aws::vpn-connection-001",
226        "type": "network.vpn",
227        "name": "aws-to-mxp-vpn",
228        "description": "Site-to-site VPN connecting AWS to MXP datacenter",
229        "provider": {
230          "name": "aws",
231          "type": "AWS::EC2::VPNConnection",
232          "native_id": "vpn-0abc123456def",
233          "region": "us-east-1",
234          "account": "123456789012"
235        },
236        "status": "active",
237        "state": "available",
238        "properties": {
239          "type": "ipsec.1",
240          "vpn_gateway_id": "vgw-0123456",
241          "customer_gateway_ip": "203.0.113.50",
242          "tunnel_1_status": "UP",
243          "tunnel_2_status": "UP",
244          "bgp_asn": 65000
245        },
246        "tags": {
247          "Environment": "production",
248          "Purpose": "hybrid-connectivity"
249        }
250      }
251    ],
252    "connections": [
253      {
254        "id": "conn-web-to-vpn",
255        "type": "route",
256        "source": "aws::i-0web456def789",
257        "target": "aws::vpn-connection-001",
258        "direction": "bidirectional",
259        "name": "Web server to VPN",
260        "description": "Traffic from AWS web server through VPN to on-premise",
261        "properties": {
262          "protocol": "ipsec",
263          "encrypted": true
264        }
265      },
266      {
267        "id": "conn-vpn-to-app",
268        "type": "route",
269        "source": "aws::vpn-connection-001",
270        "target": "mxp::srv-r770-001",
271        "direction": "bidirectional",
272        "name": "VPN to application server",
273        "description": "Hybrid connectivity to on-premise application",
274        "properties": {
275          "network": "10.30.10.0/24",
276          "mtu": 1500
277        }
278      },
279      {
280        "id": "conn-app-to-db",
281        "type": "dependency",
282        "source": "mxp::srv-r770-001",
283        "target": "mxp::srv-r770-002",
284        "direction": "forward",
285        "name": "Application to database",
286        "description": "Direct connection between on-premise servers",
287        "properties": {
288          "protocol": "oracle",
289          "port": 1521,
290          "network": "backend"
291        }
292      },
293      {
294        "id": "conn-db-to-storage",
295        "type": "dependency",
296        "source": "mxp::srv-r770-002",
297        "target": "mxp::storage-dell-me5024",
298        "direction": "bidirectional",
299        "name": "Database to storage",
300        "description": "Database server storage connectivity",
301        "properties": {
302          "protocol": "iscsi",
303          "lun_count": 4,
304          "multipath": "enabled"
305        }
306      },
307      {
308        "id": "conn-app-to-storage",
309        "type": "dependency",
310        "source": "mxp::srv-r770-001",
311        "target": "mxp::storage-dell-me5024",
312        "direction": "bidirectional",
313        "name": "Application to storage",
314        "description": "Application server shared storage",
315        "properties": {
316          "protocol": "iscsi",
317          "lun_count": 2,
318          "multipath": "enabled"
319        }
320      }
321    ],
322    "groups": [
323      {
324        "id": "group-aws-cloud",
325        "type": "logical.environment",
326        "name": "AWS Cloud Resources",
327        "description": "All resources in AWS cloud",
328        "members": [
329          "aws::i-0web456def789",
330          "aws::vpn-connection-001"
331        ],
332        "tags": {
333          "Location": "cloud",
334          "Provider": "aws"
335        }
336      },
337      {
338        "id": "group-mxp-datacenter",
339        "type": "physical.site",
340        "name": "MXP Datacenter",
341        "description": "All on-premise resources in Milan Datacenter",
342        "members": [
343          "mxp::srv-r770-001",
344          "mxp::srv-r770-002",
345          "mxp::storage-dell-me5024"
346        ],
347        "properties": {
348          "address": "Via Malpensa 1, 21010 Vizzola Ticino VA, Italy",
349          "coordinates": "45.6301° N, 8.7280° E"
350        },
351        "tags": {
352          "Location": "on-premise",
353          "Datacenter": "MXP"
354        }
355      },
356      {
357        "id": "group-rack-r42",
358        "type": "physical.rack",
359        "name": "Rack R42",
360        "description": "Compute servers in rack R42",
361        "members": [
362          "mxp::srv-r770-001",
363          "mxp::srv-r770-002"
364        ],
365        "properties": {
366          "rack_units": 42,
367          "power_capacity_watts": 8000,
368          "cooling": "rear-door"
369        },
370        "tags": {
371          "Room": "DC-A",
372          "Row": "4",
373          "Position": "2"
374        }
375      }
376    ]
377  }
378}

Ejemplos IT

Topología de red on-premise Arista

OSIRIS on-premise infrastructure example preview

description /examples/v1.0/IT/on-premise/osiris_on_premise_network_topology.json

											1{
2  "$schema": "https://osirisjson.org/schema/v1.0/osiris.schema.json",
3  "version": "1.0.0",
4  "metadata": {
5    "timestamp": "2026-01-10T17:00:00Z",
6    "generator": {
7      "name": "manual",
8      "version": "1.0.0"
9    },
10    "scope": {
11      "name": "MXP datacenter spine-leaf network",
12      "description": "Spine-leaf fabric with Arista switches and Dell server in MXP DC-A room. This example use ICAO code, MXP is referred to a Datacenter located in Milan.",
13      "providers": ["custom"],
14      "sites": ["mxp-dc-01"],
15      "environments": ["production"]
16    }
17  },
18  "topology": {
19    "resources": [
20      {
21        "id": "mxp::spine-sw-01",
22        "type": "network.switch",
23        "name": "spine-01",
24        "description": "Arista DCS-7050SX3-48YC12 spine switch",
25        "provider": {
26          "name": "custom",
27          "namespace": "osiris.com.acme",
28          "native_id": "spine-sw-01",
29          "site": "mxp-dc-01",
30          "system": "network-inventory"
31        },
32        "status": "active",
33        "properties": {
34          "manufacturer": "Arista",
35          "model": "DCS-7050SX3-48YC12",
36          "serial_number": "JPE19120123",
37          "location": {
38            "datacenter": "MXP",
39            "room": "DC-A",
40            "rack": "R01",
41            "rack_unit": "U38-U39"
42          },
43          "software": {
44            "os": "EOS",
45            "version": "4.29.2F"
46          },
47          "hardware": {
48            "ports_total": 60,
49            "ports_10g_sfp": 48,
50            "ports_100g_qsfp28": 12,
51            "switching_capacity_tbps": 3.36,
52            "forwarding_rate_mpps": 2500
53          },
54          "management": {
55            "ip_address": "10.30.1.10",
56            "hostname": "spine-01.mxp.acme.com",
57            "mac": "02:AA:BB:CC:DD:01"
58          }
59        },
60        "tags": {
61          "Role": "spine",
62          "Tier": "core",
63          "Critical": "true"
64        },
65        "state": "operational"
66      },
67      {
68        "id": "mxp::leaf-sw-01",
69        "type": "network.switch",
70        "name": "leaf-01",
71        "description": "Arista DCS-7050SX3-48YC12 leaf switch for server connectivity",
72        "provider": {
73          "name": "custom",
74          "namespace": "osiris.com.acme",
75          "native_id": "leaf-sw-01",
76          "site": "mxp-dc-01",
77          "system": "network-inventory"
78        },
79        "status": "active",
80        "properties": {
81          "manufacturer": "Arista",
82          "model": "DCS-7050SX3-48YC12",
83          "serial_number": "JPE19120124",
84          "location": {
85            "datacenter": "MXP",
86            "room": "DC-A",
87            "rack": "R40",
88            "rack_unit": "U40-U41"
89          },
90          "software": {
91            "os": "EOS",
92            "version": "4.29.2F"
93          },
94          "hardware": {
95            "ports_total": 60,
96            "ports_10g_sfp": 48,
97            "ports_100g_qsfp28": 12
98          },
99          "management": {
100            "ip_address": "10.30.1.40",
101            "hostname": "leaf-01.mxp.acme.com",
102            "mac": "02:AA:BB:CC:DD:01"
103          }
104        },
105        "tags": {
106          "Role": "leaf",
107          "Tier": "access",
108          "Pod": "pod-01"
109        },
110        "state": "operational"
111      },
112      {
113        "id": "mxp::leaf-sw-02",
114        "type": "network.switch",
115        "name": "leaf-02",
116        "description": "Arista DCS-7050SX3-48YC12 leaf switch",
117        "provider": {
118          "name": "custom",
119          "namespace": "osiris.com.acme",
120          "native_id": "leaf-sw-02",
121          "site": "mxp-dc-01",
122          "system": "network-inventory"
123        },
124        "status": "active",
125        "properties": {
126          "manufacturer": "Arista",
127          "model": "DCS-7050SX3-48YC12",
128          "serial_number": "JPE19120125",
129          "location": {
130            "datacenter": "MXP",
131            "room": "DC-A",
132            "rack": "R41",
133            "rack_unit": "U40-U41"
134          },
135          "software": {
136            "os": "EOS",
137            "version": "4.29.2F"
138          },
139          "management": {
140            "ip_address": "10.10.1.41",
141            "hostname": "leaf-02.mxp.acme.com"
142          }
143        },
144        "tags": {
145          "Role": "leaf",
146          "Tier": "access",
147          "Pod": "pod-01"
148        },
149        "state": "operational"
150      },
151      {
152        "id": "mxp::srv-r770-010",
153        "type": "compute.server",
154        "name": "compute-srv-10",
155        "description": "Dell PowerEdge R770 compute server",
156        "provider": {
157          "name": "custom",
158          "namespace": "osiris.com.acme",
159          "native_id": "srv-r770-010",
160          "site": "mxp-dc-01",
161          "system": "datacenter-inventory"
162        },
163        "status": "active",
164        "properties": {
165          "manufacturer": "Dell",
166          "model": "PowerEdge R770",
167          "serial_number": "SRV770010",
168          "location": {
169            "datacenter": "MXP",
170            "room": "DC-A",
171            "rack": "R40",
172            "rack_unit": "U10-U12"
173          },
174          "network_interfaces": [
175            {
176              "name": "ens1f0",
177              "mac": "02:AA:BB:CC:DD:01",
178              "ip_address": "10.0.10.50",
179              "speed_gbps": 10,
180              "status": "up",
181              "connected_to": "leaf-01:Ethernet1"
182            },
183            {
184              "name": "ens1f1",
185              "mac": "02:AA:BB:CC:DD:01",
186              "ip_address": "10.0.10.51",
187              "speed_gbps": 10,
188              "status": "up",
189              "connected_to": "leaf-02:Ethernet1"
190            }
191          ]
192        },
193        "tags": {
194          "Purpose": "compute",
195          "Pod": "pod-01"
196        },
197        "state": "operational"
198      }
199    ],
200    "connections": [
201      {
202        "id": "conn-spine01-to-leaf01-uplink1",
203        "type": "physical.fiber",
204        "source": "mxp::spine-sw-01",
205        "target": "mxp::leaf-sw-01",
206        "direction": "bidirectional",
207        "name": "Spine-01 to Leaf-01 Uplink 1",
208        "description": "100G fiber uplink",
209        "properties": {
210          "source_interface": {
211            "name": "Ethernet49/1",
212            "port_number": 49,
213            "type": "QSFP28-100G",
214            "status": "up",
215            "transceiver": {
216              "type": "QSFP28-100GBASE-SR4",
217              "vendor": "Finisar",
218              "part_number": "FTLC1152RDPL",
219              "serial_number": "FNS12345678",
220              "wavelength_nm": 850,
221              "distance_m": 100
222            }
223          },
224          "target_interface": {
225            "name": "Ethernet49/1",
226            "port_number": 49,
227            "type": "QSFP28-100G",
228            "status": "up",
229            "transceiver": {
230              "type": "QSFP28-100GBASE-SR4",
231              "vendor": "Finisar",
232              "part_number": "FTLC1152RDPL",
233              "serial_number": "FNS12345679"
234            }
235          },
236          "cable": {
237            "type": "fiber_optic",
238            "connector": "MPO",
239            "fiber_count": 12,
240            "fiber_type": "multimode_om4",
241            "length_m": 15,
242            "part_number": "CAB-MTP-OM4-15M"
243          },
244          "layer": "layer1",
245          "speed": "100000",
246          "duplex": "full",
247          "mtu": 9214,
248          "vlan_trunk": true
249        },
250        "tags": {
251          "LinkType": "uplink",
252          "Critical": "true"
253        }
254      },
255      {
256        "id": "conn-spine01-to-leaf02-uplink1",
257        "type": "physical.fiber",
258        "source": "mxp::spine-sw-01",
259        "target": "mxp::leaf-sw-02",
260        "direction": "bidirectional",
261        "name": "Spine-01 to Leaf-02 Uplink 1",
262        "description": "100G fiber uplink",
263        "properties": {
264          "source_interface": {
265            "name": "Ethernet50/1",
266            "port_number": 50,
267            "type": "QSFP28-100G",
268            "status": "up"
269          },
270          "target_interface": {
271            "name": "Ethernet49/1",
272            "port_number": 49,
273            "type": "QSFP28-100G",
274            "status": "up"
275          },
276          "cable": {
277            "type": "fiber_optic",
278            "connector": "MPO",
279            "fiber_type": "multimode_om4",
280            "length_m": 20
281          },
282          "layer": "layer1",
283          "speed": "100000",
284          "duplex": "full",
285          "mtu": 9214
286        },
287        "tags": {
288          "LinkType": "uplink"
289        }
290      },
291      {
292        "id": "conn-leaf01-to-srv10-nic1",
293        "type": "physical.copper",
294        "source": "mxp::leaf-sw-01",
295        "target": "mxp::srv-r770-010",
296        "direction": "bidirectional",
297        "name": "Leaf-01 to Server-10 NIC1",
298        "description": "10G copper server connection",
299        "properties": {
300          "source_interface": {
301            "name": "Ethernet1",
302            "port_number": 1,
303            "type": "SFP+-10G",
304            "status": "up",
305            "transceiver": {
306              "type": "SFP-10GBASE-T",
307              "vendor": "Arista",
308              "part_number": "SFP-10G-T"
309            }
310          },
311          "target_interface": {
312            "name": "ens1f0",
313            "mac": "02:AA:BB:CC:DD:01",
314            "type": "RJ45",
315            "status": "up"
316          },
317          "cable": {
318            "type": "copper",
319            "category": "cat6a",
320            "length_m": 5,
321            "part_number": "CAB-ETH-5M"
322          },
323          "layer": "layer1",
324          "speed": "10000",
325          "duplex": "full",
326          "vlan_access": 10,
327          "port_security": "enabled"
328        },
329        "tags": {
330          "LinkType": "server-access"
331        }
332      },
333      {
334        "id": "conn-leaf02-to-srv10-nic2",
335        "type": "physical.copper",
336        "source": "mxp::leaf-sw-02",
337        "target": "mxp::srv-r770-010",
338        "direction": "bidirectional",
339        "name": "Leaf-02 to Server-10 NIC2",
340        "description": "10G copper server connection (redundant path)",
341        "properties": {
342          "source_interface": {
343            "name": "Ethernet1",
344            "port_number": 1,
345            "type": "SFP+-10G",
346            "status": "up"
347          },
348          "target_interface": {
349            "name": "ens1f1",
350            "mac": "02:AA:BB:CC:DD:01",
351            "type": "RJ45",
352            "status": "up"
353          },
354          "cable": {
355            "type": "copper",
356            "category": "cat6a",
357            "length_m": 7
358          },
359          "layer": "layer1",
360          "speed": "10000",
361          "duplex": "full",
362          "vlan_access": 10,
363          "bonding": {
364            "enabled": true,
365            "mode": "active-backup",
366            "primary": "ens1f0"
367          }
368        },
369        "tags": {
370          "LinkType": "server-access",
371          "Redundancy": "backup"
372        }
373      }
374    ],
375    "groups": [
376      {
377        "id": "group-spine-layer",
378        "type": "logical.tier",
379        "name": "Spine Layer",
380        "description": "Core spine switches",
381        "members": [
382          "mxp::spine-sw-01"
383        ],
384        "tags": {
385          "Layer": "core",
386          "Function": "routing"
387        }
388      },
389      {
390        "id": "group-leaf-layer",
391        "type": "logical.tier",
392        "name": "Leaf Layer",
393        "description": "Access leaf switches",
394        "members": [
395          "mxp::leaf-sw-01",
396          "mxp::leaf-sw-02"
397        ],
398        "tags": {
399          "Layer": "access",
400          "Function": "switching"
401        }
402      },
403      {
404        "id": "group-pod-01",
405        "type": "logical.pod",
406        "name": "POD-01",
407        "description": "Network pod with leaf switches and servers",
408        "members": [
409          "mxp::leaf-sw-01",
410          "mxp::leaf-sw-02",
411          "mxp::srv-r770-010"
412        ],
413        "properties": {
414          "subnet": "10.0.10.0/24",
415          "vlan": 10,
416          "gateway": "10.0.10.1"
417        },
418        "tags": {
419          "Pod": "pod-01",
420          "Isolation": "layer3"
421        }
422      },
423      {
424        "id": "group-fabric",
425        "type": "logical.network",
426        "name": "Datacenter Fabric",
427        "description": "Complete spine-leaf fabric",
428        "children": [
429          "group-spine-layer",
430          "group-leaf-layer"
431        ],
432        "properties": {
433          "topology": "spine-leaf",
434          "protocol": "BGP",
435          "asn_range": "65000-65010"
436        },
437        "tags": {
438          "Architecture": "clos",
439          "Redundancy": "full"
440        }
441      }
442    ]
443  }
444}

Ejemplos OT

Instantánea de impresora industrial Zebra ZT610 conectada a un PLC

OSIRIS OT industrial printer example preview

description /examples/v1.0/OT/on-premise/osiris_industrial_printer.json

											1{
2  "$schema": "https://osirisjson.org/schema/v1.0/osiris.schema.json",
3  "version": "1.0.0",
4  "metadata": {
5    "timestamp": "2026-01-12T13:00:00Z",
6    "generator": {
7      "name": "manual",
8      "version": "1.0.0"
9    },
10    "scope": {
11      "name": "Industrial printing system",
12      "description": "PLC-controlled industrial label printer connected to OT network at MXP Facility.",
13      "providers": [ "custom" ],
14      "sites": [ "mxp" ],
15      "environments": [ "production" ]
16    }
17  },
18  "topology": {
19    "resources": [
20      {
21        "id": "mxp::plc-line-01",
22        "type": "ot.plc",
23        "name": "PLC-LINE-01",
24        "description": "PLC controlling packaging line and printer trigger signals",
25        "provider": {
26          "name": "custom",
27          "namespace": "osiris.com.rockwell",
28          "native_id": "PLC-0001",
29          "site": "mxp"
30        },
31        "status": "active",
32        "state": "operational",
33        "properties": {
34          "vendor": "Rockwell Automation",
35          "model": "Allen-Bradley CompactLogix 5380",
36          "ip_address": "10.50.10.20",
37          "mac_address": "02:AA:BB:CC:FF:20",
38          "protocols": [
39            "ethernet_ip",
40            "modbus_tcp"
41          ],
42          "connected_switch": "mxp::sw-ot-printing-01",
43          "switch_port": "Gi1/0/4",
44          "location": {
45            "site": "mxp",
46            "building": "plant",
47            "line": "packaging_line_01"
48          }
49        },
50        "tags": {
51          "environment": "production",
52          "domain": "ot",
53          "function": "plc_control"
54        }
55      },
56      {
57        "id": "mxp::printer-label-01",
58        "type": "ot.printer.industrial",
59        "name": "PRINTER-LABEL-01",
60        "description": "Industrial label printer receiving print jobs from PLC",
61        "provider": {
62          "name": "custom",
63          "namespace": "osiris.com.zebra",
64          "native_id": "PRN-0001",
65          "site": "mxp"
66        },
67        "status": "active",
68        "state": "operational",
69        "properties": {
70          "vendor": "Zebra",
71          "model": "ZT610",
72          "printer_type": "label",
73          "ip_address": "10.50.10.30",
74          "mac_address": "02:AA:BB:CC:FF:30",
75          "protocols": [
76            "tcp9100",
77            "snmp"
78          ],
79          "connected_switch": "mxp::sw-ot-printing-01",
80          "switch_port": "Gi1/0/5",
81          "location": {
82            "site": "mxp",
83            "building": "plant",
84            "line": "packaging_line_01",
85            "station": "labeling_station"
86          }
87        },
88        "tags": {
89          "environment": "production",
90          "domain": "ot",
91          "function": "label_printing"
92        },
93        "extensions": {
94          "osiris.zebra": {
95            "firmware_version": "V75.20.3Z",
96            "dpi": 600,
97            "max_width_mm": 104,
98            "head_temp": 20
99          }
100        }
101      },
102      {
103        "id": "mxp::sw-ot-printing-01",
104        "type": "network.switch",
105        "name": "SW-OT-PRINTING-01",
106        "provider": {
107          "name": "custom",
108          "namespace": "osiris.com.cisco",
109          "native_id": "SW-OT-PRINTING-01",
110          "type": "IE-3300-8P2S-E",
111          "site": "mxp"
112        },
113        "properties": {
114          "model": "Cisco Catalyst IE3300 Rugged Series",
115          "mgmt_ip": "10.50.10.1",
116          "ports_total": 8,
117          "ports_poe": 8
118        },
119        "tags": {
120          "environment": "production",
121          "domain": "ot"
122        }
123      }
124    ],
125    "connections": [
126      {
127        "id": "conn-plc-to-printer",
128        "type": "dataflow.tcp",
129        "source": "mxp::plc-line-01",
130        "target": "mxp::printer-label-01",
131        "direction": "forward",
132        "properties": {
133          "protocol": "tcp",
134          "port": 9100,
135          "application": "zpl_over_tcp"
136        }
137      },
138      {
139        "id": "conn-plc-to-switch",
140        "type": "network",
141        "source": "mxp::plc-line-01",
142        "target": "mxp::sw-ot-printing-01",
143        "direction": "bidirectional",
144        "properties": {
145          "interface": "Gi1/0/4",
146          "link_speed": "1G"
147        }
148      },
149      {
150        "id": "conn-printer-to-switch",
151        "type": "network",
152        "source": "mxp::printer-label-01",
153        "target": "mxp::sw-ot-printing-01",
154        "direction": "bidirectional",
155        "properties": {
156          "interface": "Gi1/0/5",
157          "link_speed": "1G"
158        }
159      }
160    ],
161    "groups": [
162      {
163        "id": "grp-mxp-printing-zone",
164        "type": "logical.production.zone",
165        "name": "MXP Packaging Line 01 Printing Zone",
166        "members": [
167          "mxp::plc-line-01",
168          "mxp::printer-label-01",
169          "mxp::sw-ot-printing-01"
170        ]
171      }
172    ]
173  }
174}

Participa en la comunidad

forum

GitHub Discussions

Haz preguntas, comparte ideas y ayuda a dar forma a la especificación

Participar

Repositorio GitHub

Contribuye código, reporta problemas y envía pull requests

Ver

Formas de contribuir

code

Código

Construye productores/parsers para hyperscalers, plataformas cloud y sistemas IT/OT on-prem.

description

Documentación

Mejora guías, escribe tutoriales y casos de uso reales para ayudar a otros a adoptar OSIRIS JSON.

science

Testing

Valida la especificación y el esquema con topologías de infraestructura reales y casos límite.

lightbulb

Feedback

Reporta problemas, sugiere mejoras o propón extensiones y nuevas funcionalidades.

build

Herramientas

Crea SDKs, herramientas CLI, validadores, exportadores y herramientas de documentación/diagramación.

Difunde la voz

Escribe posts, da charlas, graba demos y comparte OSIRIS JSON con tu red.

design_services

Diseño y plantillas

Diseña plantillas de diagramas de alta calidad, layouts gráficos para docs y web, iconos, datasets de ejemplo y recursos reutilizables para la comunidad.

Hoja de ruta

OSIRIS JSON es impulsado por la comunidad

OSIRIS JSON nació enfrentando problemas del mundo real y sigue creciendo a través de feedback, nuevas ideas y contribuciones prácticas. Si tienes sugerencias o quieres ayudar, participa: tu aporte ayuda a dar forma tanto a la hoja de ruta como al estándar.

route Ver la hoja de ruta

Apoya OSIRIS JSON

OSIRIS JSON está en sus primeros días. Ahora mismo, la adopción y el feedback importan más que la financiación. Prueba las herramientas, testéalas contra infraestructura real y cuéntanos qué falta.

terminal

Úsalo y reporta

Ejecuta un productor en tu infraestructura, valida la salida y abre un issue cuando algo falle.

edit_note

Contribuye

Envía ejemplos reales, mejora la documentación o construye un productor para tu plataforma.

campaign

Corre la voz

Comparte OSIRIS con tu equipo, escribe sobre tu experiencia o menciónalo en comunidades relevantes.

Cómo apoyar star Dale estrella al proyecto en GitHub