GEO INFER OPS

---
name: geo-infer-ops
description: Operations, monitoring, and observability for geospatial infrastructure. Use when setting up monitoring dashboards, configuring alerts, tracking system health, or managing deployment of spatial services.
prerequisites:
  required: []
  recommended:
    - geo-infer-api
    - geo-infer-data
difficulty: intermediate
estimated_time: 45min
examples_dir: ../GEO-INFER-EXAMPLES/examples/
---

# GEO-INFER-OPS

## Instructions

### Core Capabilities

- **Monitoring**: System health metrics, spatial operation performance
- **Log aggregation**: Structured log collection and querying
- **Deployment**: Configuration management for spatial services
- **Observability**: Distributed tracing for cross-module operations

### Key Imports

```python
from geo_infer_ops.core.monitoring import record_request, record_error, start_metrics_server
from geo_infer_ops.core.deployment import DeploymentManager
from geo_infer_ops.core.logging import setup_logging, get_logger
```

## Examples

```python
from geo_infer_ops.core.monitoring import record_request, start_metrics_server

with start_metrics_server(port=9090) as metrics_port:
    cells = backend.tessellate(region, resolution=7)
    record_request("space", "/h3/tessellate", 200, 0.12)
    print(f"Metrics listening on {metrics_port}")
```

```python
from geo_infer_ops.core.deployment import DeploymentManager
from geo_infer_ops.core.logging import setup_logging, get_logger

setup_logging(log_level="INFO", json_format=True)
logger = get_logger(__name__)

deployer = DeploymentManager(namespace="geo-prod")
if deployer.build_docker_image(tag="geo-infer-api:local"):
    logger.info("docker_build_ready")
```

## Guidelines

- Uses structured logging (JSON format)
- Prometheus-compatible metrics export
- `start_metrics_server()` yields the selected port and closes server/thread handles on exit
- Test: `uv run python -m pytest GEO-INFER-OPS/tests/ -v`

### Integrations

- **API** → Endpoint monitoring and rate limiting
- **AGENT** → Agent telemetry collection and dashboards
- **IOT** → Sensor health monitoring and alerts
- **LOG** → Logistics operation monitoring
- **SEC** → Security event aggregation